Changes
m
Adding other languages
{{h:h|editor toc}}
'''[[MediaWiki 1.5|MediaWiki 1.5]] or later required. Please also make sure you are using the latest version of the script if it is not working as expected.'''
The MediaWiki software allows you to edit any resource using any external tool. This is accomplished using a very simple system:
# When a resource is requested for being edited externally, MediaWiki sends out a ''control file'' that contains information about the resource; most importantly, its network location (URL) and the interface that is to be used for changing it.
# The user has to configure his or her browser so that the MIME type ''application/x-external-editor'' is associated with a special helper application.
# That helper application processes the control file, retrieves the resource, launches the favored application to edit it, and, if desired, saves the resource back to the server.
Examples of External Editor in use:
<gallery>
Image:MediaWikiExternalEditorImage.png|Editing an image with inkscape
Image:MediaWikiExternalEditor.png|Editing a wiki page using KWrite
</gallery>
==Helper application==
There is a '''reference implementation''' for the helper application called "ee.pl" (available [http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/ee/ here], see [http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/ee/README README] for usage and [http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/ee/INSTALL INSTALL] for setup instructions). It is written in Perl and may be difficult to set up. However, it provides a complete set of features and a graphical user interface. Developers are welcome to write a more user friendly implementation, see [[Help:External editors/Tech]] for the specifications.
Note that the ee.pl GUI makes it very easy to save the data back to the server, including an edit summary, or to cancel the edit. You can also make multiple edits on the server by using the "Save and continue" button.
===Configuring ee.pl===
For each wiki you want to use ee.pl with, add an entry like this to ee.ini:
[{{SITENAME}}]
URL match={{SERVER}}{{SCRIPTPATH}}
Username=''(Your username)''
Password=''(Your password)''
This is necessary so ee.pl can log in -- it does not know your password otherwise! Note that if you are active on many wikis, such as multiple Wikipedia languages editions, and you use the same username and password, you can simply use something like "wikipedia.org" or "wikimedia.org" with this authentication information as the URL match pattern (or indeed ".org" if you only intend to access these sites). An example generic entry:
[Generic]
URL match=.org
Username=''(Your shared username)''
Password=''(Your password)''
{{H:f|enname=External editors}}
'''[[MediaWiki 1.5|MediaWiki 1.5]] or later required. Please also make sure you are using the latest version of the script if it is not working as expected.'''
The MediaWiki software allows you to edit any resource using any external tool. This is accomplished using a very simple system:
# When a resource is requested for being edited externally, MediaWiki sends out a ''control file'' that contains information about the resource; most importantly, its network location (URL) and the interface that is to be used for changing it.
# The user has to configure his or her browser so that the MIME type ''application/x-external-editor'' is associated with a special helper application.
# That helper application processes the control file, retrieves the resource, launches the favored application to edit it, and, if desired, saves the resource back to the server.
Examples of External Editor in use:
<gallery>
Image:MediaWikiExternalEditorImage.png|Editing an image with inkscape
Image:MediaWikiExternalEditor.png|Editing a wiki page using KWrite
</gallery>
==Helper application==
There is a '''reference implementation''' for the helper application called "ee.pl" (available [http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/ee/ here], see [http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/ee/README README] for usage and [http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/ee/INSTALL INSTALL] for setup instructions). It is written in Perl and may be difficult to set up. However, it provides a complete set of features and a graphical user interface. Developers are welcome to write a more user friendly implementation, see [[Help:External editors/Tech]] for the specifications.
Note that the ee.pl GUI makes it very easy to save the data back to the server, including an edit summary, or to cancel the edit. You can also make multiple edits on the server by using the "Save and continue" button.
===Configuring ee.pl===
For each wiki you want to use ee.pl with, add an entry like this to ee.ini:
[{{SITENAME}}]
URL match={{SERVER}}{{SCRIPTPATH}}
Username=''(Your username)''
Password=''(Your password)''
This is necessary so ee.pl can log in -- it does not know your password otherwise! Note that if you are active on many wikis, such as multiple Wikipedia languages editions, and you use the same username and password, you can simply use something like "wikipedia.org" or "wikimedia.org" with this authentication information as the URL match pattern (or indeed ".org" if you only intend to access these sites). An example generic entry:
[Generic]
URL match=.org
Username=''(Your shared username)''
Password=''(Your password)''
{{H:f|enname=External editors}}