Changes

Jump to navigation Jump to search
3,583 bytes added ,  18:25, 20 May 2020
no edit summary
{{Feature
|image=Visual Editor (linking).png
|imgdesc=Direct editing
|title=
}}
{{#set:feature description = A reliable rich-text editor for MediaWiki. Allows you to just "edit the page you see" while being aware of all the syntactically rich features of templates, extensions etc.}}
{{#set:feature notes = The Visual Editor is available Here and on Wikipedia.}}
{{#set:feature tests = [[Special:UserLogin|Login]] to the wiki, and make an edit in your [[Special:MyPage/Sandbox|personal sandbox]]. }}
{{#set:feature examples = }}
 
 
[[File:VisualEditor-logo.svg|alt=Visual Editor|frameless|641x641px|Visual Editor logo]]
== Links ==
* [https://www.mediawiki.org/wiki/Project:Sandbox Demo] (no account needed)
* [https://www.mediawiki.org/wiki/VisualEditor/Portal/Help Portal to Help Content about VE]
 
== Back story ==
Wiki markup is a sort of shorthand for more complicated HTML markup designed to create nicely formatted web documents. Although in the beginning wiki markup simplified the process of creating nicely formatted content, that shorthand can get increasingly complex in order to produce complicated layout and content. The extension of the markup system over time to include a template subsystem and macros inevitably leads to a tension between ease of use, and power. This tension was one of the primary factors that the Wikimedia Foundation cited as an impediment to new content collaborators for the Wikipedia. <ref>https://strategy.wikimedia.org/wiki/March_2011_Update</ref><ref>http://strategy.wikimedia.org/wiki/Editor_Trends_Study</ref> <ref>See this October 2013 article in the MIT Technology Review http://www.technologyreview.com/featuredstory/520446/the-decline-of-wikipedia</ref>. A visual editor was deemed nearly impossible after many early attempts failed, but with the advent of Node.js technology, it became an idea that was plausible again.
== Intro ==
[http://xml.coverpages.org/ Robin Cover] would be proud. It round-trips wiki to HTML + RDFa and back.
 
 
 
== Vendors ==
MyWikis is one of the few hosting providers that actually offers Visual Editor. Additionally, you can get a hosted parsoid service for $1/month if you want to run your own wiki with Visual Editor, but don't want to or can't setup the parsoid service. https://www.mywikis.com/hostedparsoid
== Installation ==
You'll need at least [http://www.mediawiki.org/wiki/Release_notes/1.23 MediaWiki v1.23]. I personally run This site usually runs the same [http://wwwmost recent version available.mediawikiWe're using {{CURRENTVERSION}} at the moment.org/wiki/Special:Version See what version that they're running on mediawiki.org] (1.24wmf3 [[Userand check yours too for free at https:Freephile|greg//freephile.rundlett]] (org/wikireport See the new [[User talkmw:FreephileRESTBase|talkRESTBase]]) 19:39, 9 May 2014 (UTC))caching proxy system usable by VE 
=== WebFaction ===
To install the Visual Editor extension in a Webfaction account, you need to first have node installed and working. You can do this by using the [http://docs.webfaction.com/software/custom.html installer in your webfaction panel] and associating a path with the app for a domain. I chose to install 'node' (which is now it's own one-click install). Once you do that you can [https://freephile.org/node visit the path] you configured for node and you should see the "hello world" app that the installer puts in place. You'll need to stop that app, plus remove the cron job that respawns it. Then, in order to reserve and associate a port for the service, you install another 'app'. You do not need to open this port in the firewall unless you plan to share it with other instances, since HTTP talks to the node server on the backend. (I had to export the PORT, but this is no longer necessary if you configure it in localsettings.js<ref><code>parsoidConfig.serverPort = 8080</code> if you are running MediaWiki-Vagrant</ref>.) Depending on the resource constraints of your hosting package, you may need to limit the number of workers spawned by the Parsoid service. It calculates a number based on the number of processors. For a shared hosting account, this is guaranteed to exceed your RAM or CPU limits, so specify the <code>--num-workers</code> option unless you're running on a dedicated host or VM.
Follow the installation instructions, and remember to edit both LocalSettings.php and localsettings.js When you setup the "interwiki" link to point to your API endpoint, you can choose pretty much whatever name you want to give it. The example is 'localhost'.
==== Info ====
* https://docs.webfaction.com/software/nodejs.html
 
=== Digital Ocean ===
# [https://www.mediawiki.org/wiki/Parsoid/Setup Setup the Parsoid service]
# Set the <code>/etc/mediawiki/parsoid/settings.js</code> file to [[API]] endpoint (https://freephile.org/w/api.php)
# sudo service parsoid restart
# sudo tail -f /var/log/parsoid/parsoid.log
 
* Note that a Visual editor setup (Parsoid service) includes configurations outside of your wiki installation (in /etc and maybe /usr/lib) so you'll want to preserve those files when doing host migrations.
* See [http://www.mediawiki.org/wiki/Thread:Extension_talk:VisualEditor/Digital_Ocean_Droplet:_Ubuntu_14.04_x64_with_MediaWiki_1.24.0 here]
== Extensions ==
# [[mw:Extension:VisualEditor]]
# [[mw:Extension:Parsoid]]
 
=== Extensions that hook into VE ===
Extension authors should [https://codesearch.wmflabs.org/extensions/?q=VisualEditorPluginModules&i=nope&files=&repos= register <code>VisualEditorPluginModules</code>]
# https://www.mediawiki.org/wiki/Extension:Proofread_Page
# https://www.mediawiki.org/wiki/Extension:CodeMirror (syntax highlighting)
# https://www.mediawiki.org/wiki/Extension:Disambiguator
# https://www.mediawiki.org/wiki/Extension:Graph
# https://www.mediawiki.org/wiki/Extension:Kartographer (Open Street Maps)
# https://www.mediawiki.org/wiki/Extension:LanguageTool
# https://www.mediawiki.org/wiki/Extension:Math
# https://www.mediawiki.org/wiki/Extension:Score (LillyPond)
# https://www.mediawiki.org/wiki/Extension:SyntaxHighlight
# https://www.mediawiki.org/wiki/Extension:TemplateData
# https://www.mediawiki.org/wiki/Extension:WikiHiero
 
 
 
 
== API / Developer Docs / DevOps ==

Navigation menu