User:WikiMaster/WYSIWYG: Difference between revisions

From PortlandWiki
Jump to navigation Jump to search
Line 7: Line 7:
'''[[User:WikiMaster|Dave]]'s Note:''' Moved references to [[mediawikiwiki:Extension:InlineEditor|Extension:InlineEditor]] and [[mediawikiwiki:WYSIFTW|What You See Is For The Win (WYSIFTW) / What You See Is What The Fuck (WYSIWTF)]] up here to the top of this list because these look like two of the most immediately available options that we might be able to successfully adapt to PortlandWiki until realistic / workable alternatives come along.
'''[[User:WikiMaster|Dave]]'s Note:''' Moved references to [[mediawikiwiki:Extension:InlineEditor|Extension:InlineEditor]] and [[mediawikiwiki:WYSIFTW|What You See Is For The Win (WYSIFTW) / What You See Is What The Fuck (WYSIWTF)]] up here to the top of this list because these look like two of the most immediately available options that we might be able to successfully adapt to PortlandWiki until realistic / workable alternatives come along.


=== MediaWiki Extension:InlineEditor ===
Just the type of insight we need to fire up the detbae.
'''[[User:WikiMaster|Dave]]'s Note:''' This might be the easier-to-use editor we go with, even though it's still in development stage, because:
# It's [[telecafe:Sandbox|testing well]] (so far).
# The code looks clean and well-written.
# The project is extensively researched.
 
* [[mediawikiwiki:Extension:InlineEditor|Extension:InlineEditor]]
: [[mediawikiwiki:User:JanPaul123|Jan Paul Posma]]’s ([http://janpaulposma.nl/cv/posma-cv.pdf CV]) [[mediawikiwiki:Extension:InlineEditor|InlineEditor]] extension is an editing interface that allows users to quickly edit and preview elements in the page by clicking them. It is an excellent example of work on making it easier to edit smaller pieces of a page, making the amount of other markup around you less intimidating. Though each piece is still edited as raw markup, you’re only exposed to the parts you’re working with, and you can switch them back to visual mode very quickly.
:: Also see: [[mediawikiwiki:Extension talk:InlineEditor#Is there any reason why we shouldn't install this extension?|Extension talk:InlineEditor#Is there any reason why we shouldn't install this extension?]]
<ol style="list-style-type: lower-roman;">
<li> [[mediawikiwiki:Extension:InlineEditor|Extension:InlineEditor]] [http://janpaulposma.nl/sle/wiki/index.php/Hoofdpagina Demo]</li>
<li> [[mediawikiwiki:Extension:InlineEditor/Proposal|Extension:InlineEditor/Proposal]]</li>
<li> [[mediawikiwiki:Extension:InlineEditor/Prototypes|Extension:InlineEditor/Prototypes]]</li>
</ol>
: The different prototypes for the [[mediawikiwiki:User:JanPaul123/Sentence-level editing|Sentence-level editing]] project are to illustrate the concept, and can be used as a starting point for an actual implementation. All the prototypes are briefly described on this page.
 
* PDF: [https://code.grnet.gr/attachments/63/SentenceLevelEditing_Usability_RuG.pdf SentenceLevelEditing_Usability_RuG.pdf - Usability script Sentence-Level Editing]
* PDF: [[upwikimedia:/commons/7/78/In-line_Editing_thesis.pdf|In-line Editing: a New Approach to Editing Wikis]] (Thesis)
* PDF: [[upwikimedia:/commons/a/a2/In-line_Editing_presentation.pdf|IN-LINE EDITING: A NEW APPROACH TO EDITING WIKIS]] (Presentation)
 
; [[commons:Category:Sentence-level editing|Category:Sentence-level editing]] ([[commons:Commons:Welcome|Wikimedia Commons]])
 
* [http://code.grnet.gr/projects/49/wiki/Wiki InlineEditor: Documentation ; SVN ; Code documentation ; Demo]
* [http://markmail.org/search/?q=inlineeditor&q=list%3Aorg.wikimedia.lists.wikitech-l InlineEditor mailing list discussion]
* Browse source code: [http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/InlineEditor/ Index of /trunk/extensions/InlineEditor]
 
==== [[mediawikiwiki:Extension:InlineEditor|InlineEditor]] [[telecafe:Sandbox|Demo]] On [[telecafe:|Telecafe]] ====
* [[telecafe:|Telecafe]] [[mediawikiwiki:Extension:InlineEditor|InlineEditor]] '''[[telecafe:Sandbox|Demo]]'''
; Requires Login
: (Unfortunately, due to sporadic monitoring, [[telecafe:|Telecafe]] only allows folks with "[[mediawikiwiki:Manual:$wgEmailConfirmToEdit|email confirmed]]" accounts edit the '''[[mediawikiwiki:Extension:InlineEditor|InlineEditor]] [[telecafe:Sandbox|Demo]]''' on [[telecafe:|Telecafe]]'s wiki.)


=== WYSIWTF (aka WYSIFTW) ===
=== WYSIWTF (aka WYSIFTW) ===

Revision as of 05:56, 19 December 2011

Wiki Editing 2.0: Visual Editors, Wikis & You

So pretty! Wikipedia articles can include rich formatting, beyond simple links and images to complex templates to generate tables, pronunciation guides, and all sorts of details.
So icky! But when you push that “edit” button, you often come face to face with a giant blob of markup that’s very hard to read. Here we can’t even see the first paragraph of the article until we scroll past several pages of infobox setup.

Dave's Note: Moved references to Extension:InlineEditor and What You See Is For The Win (WYSIFTW) / What You See Is What The Fuck (WYSIWTF) up here to the top of this list because these look like two of the most immediately available options that we might be able to successfully adapt to PortlandWiki until realistic / workable alternatives come along.

Just the type of insight we need to fire up the detbae.

WYSIWTF (aka WYSIFTW)

Dave's Note: It looks like Kotra (perhaps tentatively) favors Magnus Manske's WYSIFTW approach over Jan Paul Posma's InlineEditor extension. Reason? Simpler interface.

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.
WYSIWTF (aka WYSIFTW) - The js code.
WYSIFTW: Documentation ; SVN ; Code documentation ; Demo

Additional WYSIWYG Research

For the more technically inclined, wiki markup is a simple way of formatting a wiki page. However, many would-be users of MediaWiki are put off by what looks to them—rightly—to be code of any sort. These users are adjusted to publishing and editing in a more visually straightforward WYSIWYG (What You See Is What You Get) environment.
From Article: (Wikipedia's) editing platform is intentionally designed to be complex so as to lower participation and thus make it easier to manage, and that if they open up the floodgates, "the site will probably come to a grinding halt."
WYSIWYM is an acronym for What You See Is What You Mean, and refers to a paradigm for document editing. It is an alternative to the better-known WYSIWYG (what you see is what you get) paradigm, which displays the document on screen as it will be printed.
Wikipedia WYSIWYG
Wikipedia WYSIWYG is a collaboration between GRNET and MediaWiki developers. The goal is to provide a better editing interface for Wikipedia. This will be done by evaluating existing approaches and improving them. Read more about the usability testing.[1] The first step is to do usability testing with some of the existing approaches: InlineEditor, WYSIFTW, RTE and others (see below for details).

WYSIWYG Extensions

FCKeditor (Official)

WYSIWYG

The WYSIWYG extension enables a more intuitive editing of pages on a MediaWiki-based site. When this extension is installed, the tab 'Edit' in the command bar on top of every page leads directly in the wysiwyg editing mode. The WYSIWYG extension uses a special version of the CKeditor that outputs wiki text rather than the usual HTML that caused problems for MediaWiki integrations in the past.

RTE (Rich Text Editor (Wikia)

Help:Rich text editor
This extension is enabled by default on Wikia.
svn.wikia-code.com/wikia/trunk/extensions/wikia/RTE

Other Editing Tools

wikEd

wikEd is a full-featured Wikipedia-integrated advanced text editor for regular to advanced wiki users. wikEd features syntax highlighting with code check and reference and template folding, on-page Show preview and Show changes, and advanced search and replace functions. Please check the wikEd help page for details. wikEd works under all web browsers except Internet Explorer and Opera.
This Essay in a Nutshell: Pure WYSIWYG is evil. Really. But we can learn a thing or two from it.

Semantic Forms

Semantic Forms allows you to have forms for adding, editing and querying data on your wiki, without any programming. Forms can be created and edited not just by administrators, but by users themselves.

I'm not quite sure how to say this; you made it etrxmeley easy for me!

PortlandWiki WYSIWYG Discussions

References