WYSIFTW
This page is obsolete. It is being retained for archival purposes. It may document extensions or features that are obsolete and/or no longer supported. Do not rely on the information here being up-to-date. |
WYSIFTW (formerly WYSIWTF) is a JavaScript-based tool originally written by Magnus Manske.
Its primary purpose is to make it easier to edit Wikipedia articles, especially for people unfamiliar with the intricacies of MediaWiki syntax (the vast majority of the planet, in case you forgot :-). This is achieved by creating a full-screen editing interface where the user can edit "augmented wikitext", that is, wikitext that has some "ugly" parts folded away by default, inline display of images, tables, etc. It has been tested on the English Wikipedia, but should work elsewhere.
WYSIFTW is obsolete now, but was very influential on the VisualEditor, e.g. the full-page editing interface.
Installation
[edit]You can install WYSIFTW yourself to test it. Just add the following line to your "vector.js" user subpage:
mw.loader.using( 'jquery.ui.dialog', function () { mw.loader.load( '//toolserver.org/~magnus/wysiwtf/wysiwtf.js' ); } );
Code
[edit]The current code is in the Toolserver SVN. wysiwtf.js is the live version; wysiwtf_dev.js the development version. The other files are required as well.
- SVN (browse)Â : https://fisheye.toolserver.org/browse/Magnus/wysiwtf
- SVN (checkout)Â : https://svn.toolserver.org/svnroot/magnus/wysiwtf
- Code documentation : http://toolserver.org/~magnus/wysiwtf/docs/symbols/wysiwtf.html
Features
[edit]- Basic editing : Typing, delete/backspace, cursor movements, click-to-edit
- Internal links are recognized and turned into "blue" links, where the label can be edited like any other text. Double-clicking the link allows the user to edit the link target.
- Images are recognized and shown in-line. Thumbnail text can be edited like any other text. Double-clicking the image allows the user to edit the image name.
- Templates are recognized and put into green, dotted boxes. The template name is shown in bold; if there are no parameters, the template name is shown in italics. Templates with a long paramater list are automatically folded, that is, the parameters are hidden by default. Double-clicking the template name toggles the parameter list, which can then be freely edited. This works for nested templates as well.
- HTML tags are visually highlighted to separate them from the normal text.
- References are collapsed, similar to templates. The full reference text can be toggled by double-clicking the <ref> tag. Self-closing reference tags ("<ref/>") are treated like normal HTML tags.
- Allowing changing filename, thumb frame or neither, left right or neither, caption/title (depending on thumb/frame or not), size (optional for thumb)
- External links
- Bold/italics (partially, safe fallback to wikitext)
- Tables
- ----- (hr element)
- Assisted adding/removing of wikilinks
- Assisted change in headings/normal text
- Built-in diff function
- Built-in preview function
To do
[edit]- "Advanced" editing: selection of text, advanced cursor movements
- copy/pasting (listen for paste command like for backspace/space/return), then access the paste (cross-browser?) and loop through character by character as if typed (can't be inserted anyway since it's not input/textarea)
- That's the idea for plain text, but what about copying styles? What happens to copied templates? What if the selection start is with a link, but the selection end outside? Either restriction to plain text, or generating wikitext from selected elements, then insert (and maybe parse?) that wikitext on paste. --Magnus Manske 22:27, 7 January 2011 (UTC)
- copy/pasting (listen for paste command like for backspace/space/return), then access the paste (cross-browser?) and loop through character by character as if typed (can't be inserted anyway since it's not input/textarea)
- Lists
- indentations
- nowiki
- pre
- rahmen == frame
- fix help link
Bugs
[edit]To report bugs, file a bug report at https://jira.toolserver.org/browse/MAGNUS under the "WYSIFTW" component.