User:Cacycle/wikEd help

This is the help page for wikEd, a full-featured in-browser text editor that adds enhanced text processing functions to Wikipedia and other MediaWiki edit pages.

Please post bug reports or feature requests to the wiked discussion page.



Quick tutorial
Most buttons will work as expected and resemble those in your regular text processing program. However, wikEd is sometimes a bit special. This is largely because the program uses the browser's built-in rich-text editing interface (more details can be found below). wikEd is launched immediately when [edit] is clicked on any article, provided that you have it correctly installed, it is not disabled, and you use a supported browser.

Formatted text
Unlike in the standard editing window, you can paste formatted text: links stay links, tables stay tables, strange text formatting stays as it is. Any such formatting will be stripped from the article if you submit the page and only the raw text will stay. You can also get rid of text formatting by pressing the textify button.

Converting to wiki code
If you want to keep a certain formatting, a link, or a table, you can convert the formatted pasted text into wiki code by pushing the wikify button. Any editing button will automatically wikify the text to be changed.

Updating the syntax highlighting
For technical reasons, the syntax highlighting cannot be updated automatically. If you add text, it might therefore be displayed in a wrong color or formatting. Simply push the textify  or wikify button  to update the syntax highlighting. This also updates the targets for internal and external links in the text (ctrl-click to open them in a new window or tab).

Most buttons (including the three previous ones) work on the whole text if no text is selected and on the selection only if you have text selected.

Control buttons
The button bar to the right has the control buttons. With these buttons you can switch between the standard editing window and wikEd, turn off syntax highlighting, turn off the standard toolbar, or switch to fullscreen mode. If you push any of these buttons, its setting will be saved in a cookie and it affects all new pages and is kept for future sessions.

wikEd main switch, version info, and error indicator
The following wikEd status indicator logos below are displayed at the top of the page next to the logout link. Hovering over the logo gives you the current version info. wikEd checks every 20 h for updates and automatically updates. You can check for the latest version and update manually by pressing Shift and click the Reload button or press Shift-Ctrl-R (technically, updating is simply a page reload after clearing the browser's cache for this page).

Collapsing button bars
The button bars above the edit window have a grip area to collapse them. This can be useful with low screen resolutions like 600×800 or 1024×768 pixels:

↔ ↔

Click the grip to collapse the bar. Move the mouse cursor over the grip to expand the bar temporarily. Click the grip again to re-expand the bar.

wikEd control buttons


This setting of the toggle buttons is stored in a cookie and affects all newly opened pages.

Syntax highlighting of special characters
wikEd highlights certain special Unicode characters so that they are distuinguishable from their standard versions. Hover over the highlighted character for their name.

wikEd is slow
Sometimes you can experience delays in edit page loading and some slow wikEd functions, especially on long pages and slow computers.

The most time consuming procedure is syntax highlighting. You can turn off syntax highlighting by pushing the button.

Other time consuming functions include edit buttons for whole text selections and regular expression searches ( button). Do not use these functions on long pages.

wikEd does not load
You have followed the installation instructions above, but the wikEd logo is not displayed on top of the pages next to the log out link and the wikEd buttons do not appear on edit pages. Please try the following:


 * Refresh your browser cache: hold down Shift while clicking Reload (or press Ctrl-Shift-R)
 * Enable JavaScript in your browser (Tools → Options → Content → Enable JavaScript in Firefox)
 * Check under your preferences which skin you use. If you are not using the default skin Monobook then you have to replace monobook.js by the used skin, e.g. [ User:YourUsername/classic.js] for the Classic skin. Alternatively you can paste the following line into your browser's address bar to open the right page: javascript:void(document.location='/wiki/Special:Mypage/'+skin+'.js')
 * If you are using wikEd on a non-Wikipedia installation check if $wgAllowUserJs is has been set to true in the MediaWiki initialization file LocalSettings.php by an administrator
 * Check the JavaScript Error Console (under Tools in Firefox) for error messages. If there is an error message caused by wikEd please report to the wikEd discussion page.

Custom buttons installed, wikEd crashes
You have been installing custom buttons a while ago and now wikEd crashes during page loading and editing might not be possible without disabling Javascript:


 * The custom button definitions have been changed in version 0.9.26 (February 23, 2007). If you use custom buttons, please update your custom button definitions (see below) on your monobook.js page. Disable JavaScript in your browser if you cannot edit pages.

All wikEd buttons are gone
The wikEd logo on top of the page is displayed in grey and the wikEd buttons are not shown on edit pages.


 * You have disabled wikEd by clicking the logo. Click the logo again to re-enable wikEd.

The wikEd formatting buttons are gone
The wikEd control buttons are displayed on edit pages, but all other button bars are gone.


 * You have temporarily disabled wikEd by clicking the [[Image:wikEd_logo.png]] control button. Click the button again to turn wikEd back on. Please remember that the setting of this button is saved and kept for all windows and tabs.

Error: invalid range in character class
You have installed wikEd by pasting the complete code to your wiki. wikEd does not load at all and the browser's error console shows the following error: "Error: invalid range in character class". When you check the header text of the copied wikEd code for the following sentence: "The code has to be saved as UTF-8 in your editor to preserve Unicode characters like ♥ (heart)" the "♥" symbol is replaced by a "?".

The reason is that you lost the Unicode character formatting when copying the code to your wiki. Use a UTF-8-capable text editor when you paste the code to your wiki and specify UTF-8 as your file format when you save your text file.

Can I have only some wikEd features
Can I have only some wikEd features, e.g. only syntax highlighting, no syntax highlighting, only the search functions?

There is no easy way to get only some wikEd features as most features are highly interdependent. However, wikEd is configurable and you could try to set the respective presets (e.g. no syntax highlighting), see the customization section. Experienced programmers could try to dissect or to remove certain features, but such a version would not be updated automatically with bugfixes and new features. Feel free to suggest new configuration options on the wikEd talk page after having used wikEd for a few days (to get the feeling...).

Automatic syntax highlighting
A common feature request is the automatic updating of the syntax highlighting while typing (“live syntax highlighting”).

This cannot be implemented for technical reasons. Every automatic change to the edit frame either erases or messes up the undo history. In order to get live syntax highlighting the whole undo/redo system and the whole editing logic of the browser’s rich text interface would have to be simulated from scratch in JavaScript, including mouse operations. This might not even be possible, would bloat the program, and would render the browser's undo/redo menu entries useless. Please see this Firefox bug report and vote for it.

WYSIWYG

 *  Please also read an extended user essay about this under User:Cacycle/WYSIWYG (under construction)

A common feature request is to make wikEd a true WYSIWYG editor.

While this sounds like a good idea at first, it is actually a step backwards. It would be very simple to add WISYWYG for the basic formatting like bold or italic. But for even slightly more advanced formatting things turn complicated:


 * A true WYSIWYG editor has to hide and encapsulate any existing wikicode from direct editing
 * Therefore, images, tables, templates, wiki links, external links, and even simple span or div tags with parameters, need a separate (popup) editor to edit their hidden content
 * Pasting formatted text screws up formatting, especially the heading order
 * Existing, syntactically incorrect text on the page can disappear from editing, and, in the worst case, get lost on saving and/or corrupt the existing article text.

Under real-world conditions with typical wiki content, WYSIWYG editing is more confusing and time consuming than the simple wiki-way of structure-oriented editing. This can be seen in the true WYSIWYG editor implementation FCKEditor (copy the text from a typical Wikipedia article and click Rich Editor).

wikEd tries to bring together the best of both worlds in something also known as WYSIWYM – what you see is what you mean:


 * A simple (MS Word-like) user interface with advanced text editing features like search and replace (also good for learning the wiki code)
 * The structure-oriented classic text field, peppered up with syntax highlighting and on-page preview

See also:


 * What you see is Wiki - Questioning WYSIWYG in the Internet Age
 * FCKEditor for MediaWiki, a true WYSIWYG implementation (edit the Sandbox, click Rich Editor)

wikEd design philosophy
The design philosophy of wikEd is:


 * Simple, small, and intuitive user interface (no navigation through complex menu structures, no popups, special buttons must be added as plugins)
 * Cross site compatibility between all MediaWiki installations (not only Wikipedia)
 * Multi-language support
 * Multi-browser support by using cross-browser standards-compatible code (please help to make wikEd work in IE7 and Opera 9, see the developer documentation and discussion)

Please post bug reports or feature requests to the wikEd discussion page.

fr:Utilisateur:Leag/wikEd_aide hu:Wikipédia:WikEd/Segítség it:Wikipedia:Monobook.js/WikEd/Manuale ja:Help:wikEd ko:위키백과:도구/wikEd/도움말 pt:Wikipedia:Software/Scripts/wikEd/ajuda scn:Aiutu:WikEd