Wikipedia:MozEx tutorial: Difference between revisions

Revision as of 22:49, 13 November 2005

Revision as of 14:40, 26 November 2005

Line 1:

This tutorial describes how to use the '''[http://mozex.mozdev.org/ MozEx]''' extension of [[Mozilla]] and [[Mozilla Firefox]] to [[Wikipedia:text editor support|edit Wikipedia pages]] in your editor of choice.

==Installing MozEx==

To edit a Wikipedia page, click on the "edit this page" tab. A box containing editable text will show up, which is sometimes called '''text area'''. Now, right-click with the mouse in the text area, and select ''mozex→Edit Textarea''. Your favorite editor will pop-up, and you will be able to edit the text. Once you are done, save the text, go back to the browser window, and click on the text area. The text will be automatically updated, and the file you just saved will be deleted from your computer.

First, you must download and install the MozEx extension by visiting the appropriate web page and following the installation link provided there. However, first note two important caveats:

==Note for Microsoft Windows users==

*[[As of 2005|Currently]], the official MozEx package (at [http://mozex.mozdev.org/ http://mozex.mozdev.org/]) does not support editing [[UTF-8]]-encoded documents. This is particularly problematic since all Wikipedia articles are encoded in [[UTF-8]] by default. [http://www.ms.mff.cuni.cz/~marem2am/src/mozex/.iso-8859-1 An unofficial version of MozEx which supports UTF-8] is available.

When configuring the textarea setting to open up the text editor of your choice, the path must not contain any "long filename" component. You should use the DOS mode instead, that is, "Progra~1" instead of "Program Files", etc. For example: C:\Progra~1\editor\edit.exe %t. The '%t' is a required argument.

*[[As of 2005|Currently]], the official MozEx package (at [http://mozex.mozdev.org/ http://mozex.mozdev.org/]) does not install properly on [[Mozilla Firefox]] 1.0. However, [http://www.extensionsmirror.nl/index.php?showtopic=70 an unofficial repackaged version of MozEx for Firefox] is available.

==Configuring MozEx==

After installing MozEx, depending on your operating system and its settings, you may need to configure MozEx to invoke the text editor of your choice. Detailed instructions for this are available on the [http://mozex.mozdev.org/ official MozEx web page].

===Note for [[Microsoft Windows]] users===

When configuring the textarea setting to open up the text editor of your choice, the path must not containuse any "[[long filename" component]]s. You should use the [[MS-DOS]] mode[[8.3]] instead,filenames that isinstead—e.g., "<tt>C:\Progra~1"\editor\edit.exe&nbsp;%t</tt> instead of "Program Files", etc. For example: <tt>C:\Progra~1Program&nbsp;Files\editor\edit.exe &nbsp;%t. The '%t' is a required argument</tt>.

==Editing with MozEx==

To edit a Wikipedia page, click on the "edit this page" tablink. A box ('''textarea''') containing editable text will show up, which is sometimes called '''text area'''. Now, rightRight-click with the mouse in the text areatextarea, and select ''mozex&rarr;Edit Textarea'' from the context menu that pops up. Your favorite editor will pop- up, and you will be able to edit the text. Once you are done, save the text, go back to the browser window, and click on the text area. The text will be automatically updated, and the file you just saved will be deleted from your computer.

[[Category:Wikipedia how-to]]