Dofus:InstaView
From Dofus
A screenshot illustrating InstaView
InstaView is a nifty extension created by Wikipedia:User:Pilaf to Mediawiki's edit mode which can generate instantaneous previews (thus the name) of the wiki-text being edited. This is not to be confused with MediaWiki's live preview feature, which is a new feature in w:MediaWiki 1.5 that allows a page to be previewed without putting additional strain on the servers.
This help page is based on Pilaf's InstaView instructions at Wikipedia. To use this on a Wikia other than this one, please see the #Installing on a different wiki instructions.
Contents |
[edit] Requirements
All you need to use InstaView is a web browser with modern JavaScript support and have it enabled when editing a page. These are the browsers in which I've tested it and know that works:
- Gecko based: Mozilla, Firefox, K-Meleon, Camino, etc.
- KHTML based: Konqueror and Safari
- Microsoft browsers: Internet Explorer 6
- Opera 8.53 and later
On the following browsers it does not work:
- Internet Explorer 5
If you've tested it on any other browsers, please feel free to add them to the corresponding list.
In terms of computing power, any modern computer should suffice. You may notice some delays when previewing very long pages on slow computers though.
[edit] Instructions
[edit] How do I install it?
SECURITY WARNING: By installing this script, you implicitly trust Pilaf not to use it for malicious purposes (the source code is open for anyone to read and modify, though).
Please check the requirements before you continue.
If you intend to install it on other wikis, read this.
To install simply copy/paste the full contents of /monobook.js into your own monobook.js page (Special:Mypage/monobook.js). Once you've done it refresh your browser as indicated at the top of your monobook.js' page. Note that you need to be a registered user in order for this to work.
*If you're not using the MonoBook skin, copy the contents to the right file from the table below instead of to monobook.js:
| Skin | Filename |
|---|---|
| Classic | standard.js |
You may want to configure a few parameters, such as your user name (for signatures). To achieve this simply edit the following line in your monobook.js:
InstaView.conf.user.name = 'User Name'
[edit] How do I use it?
If you've followed all the instructions above correctly, all you need to do now is edit a page. You should now notice a new button labeled InstaView right next to the old "Show preview" button. Once you've made your edits just click on InstaView to see the page appear instantly before your eyes. You may click it any number of times to see further changes, you'll never need to reload the page.
[edit] Troubleshooting
If you've installed it and still can't see it, try going through the following checklist:
- Check that you reloaded the page correctly (you can also try deleting your browser cache)
- Read the requirements to see if your browser is supported
- If nothing works, try messaging me or User:Cizagna
[edit] Limitations
InstaView is a work in progress and as such it has its limitations. Some are due to its state of incompleteness, some will most likely never happen as there are certain things that are just not possible to do without running on the servers. In any case you should be aware of what InstaView can and can't do, and never expect more, you can still use the regular preview for those cases where InstaView fails.
Here's a maintained list of the current limitations of InstaView (i.e. what it still can't do):
- <hiero></hiero> tags
- Templates and MediaWiki messages
- Undesired HTML stripping
- Table of contents
- Red links (to non-existing pages)
- Time tables
- Image galleries
In addition to the above list, it should be noted that InstaView is meant to be merely an approximation to the real thing and should not be considered 100% accurate. If in doubt use the regular preview.
In contrast, here is what IntaView currently can do:
- Headings (all levels)
- Regular paragraphs
- Horizontal bars
- Inline formatting (bold and italics)
- Wikilinks
- External links
- Numbered and unordered lists
- Definition lists
- Tables
- Preformatted text (whitespace at line start)
- Signatures
- Invisibile links (interwiki and categories)
- Images (with a few limitations)
- <nowiki></nowiki> tags (inline only so far)
- <math></math> tags (very limited)
[edit] Who's using it?
For users inside this wiki this should give you a clue: clicky.
[edit] License
InstaView is distributed under the BSD license.
[edit] Development version
New development version (not heavily tested yet) can be found there.