[[PageOutline]] = TracWiki WYSIWYG Editor Plugin = == Description == Wysiwyg editor embedded into `textarea.wikitext`. == Bugs/Feature Requests == Existing bugs and feature requests for TracWysiwygPlugin are [report:9?COMPONENT=TracWysiwygPlugin here]. If you have any issues, create a [http://trac-hacks.org/newticket?component=TracWysiwygPlugin&owner=jun66j5 new ticket]. == Download == Download the zipped source from [download:tracwysiwygplugin here]. == Install == Install the plugin: For Trac 0.10:: `easy_install http://trac-hacks.org/svn/tracwysiwygplugin/0.10` For Trac 0.11:: `easy_install http://trac-hacks.org/svn/tracwysiwygplugin/0.11` Enable the plugin in trac.ini: {{{ [components] tracwysiwyg.* = enabled }}} == Source == You can check out TracWysiwygPlugin from [http://trac-hacks.org/svn/tracwysiwygplugin here] using Subversion, or [source:tracwysiwygplugin browse the source] with Trac. == Example == [[Image(tracwysiwyg-firefox2.png,width=200)]] [[Image(tracwysiwyg-ie.png,width=200)]] [[Image(tracwysiwyg-opera9.png,width=200)]] == Review == By JasonWinnebeck: I wanted to try to highlight the current state of this plugin as of r2732. This is a very promising plugin in Trac and sometimes it is hard to determine how far along plugins are in development. The short story is that it is about 80% of the way to being suitable for "production" use, and it is usable now if one is willing to stand small quirks or the occasional bug. I plan on using it to help "improve" Trac usage and team acceptance by users not used to wiki format. Per the screenshots, all of the formatting is available. The biggest thing to note is that this plugin generates wiki code, not HTML or something else, so it will integrate with existing pages and work will with Trac's differences history, and installation is "revertible" in the sense that you can just opt to not use the editor if there are any problems. I evaluated this primarily in Firefox 2, and a little in IE6 on Trac 0.10.5dev. === Features === * Generation of "native" Trac wikitext * Supports heading 1-6, code block, quote format (slightly buggy on quote format) * Bold/italics/underline, hotkeys are supported * `teletype`, ^superscript^, ,,subscript,,, ~~strikethrough~~ * hyperlinks, and automatic Trac link highlighting for CamelCase (although not as you type unless you manually make a link, this was a design decision, but improvement being addressed in #2142) * List formatting, allows you to select and change list levels very easily, as in MS Word * '''Table Editor''' -- the plugin is almost worth getting just for this point alone, the table editor allows add/remove columns, rows, etc as well as wiki format inside of the cells. * Trac macros shown as normal text but expand when saved and viewed in wiki. * Formatted code blocks shown as normal text, but can be edited as a normal "code block". * I tested copy/paste in Firefox 2: * Paste into MS Word was tested and worked quite well (although links are pointing incorrectly) * Paste into editor from MS Word worked somewhat, but I tested only styles that Trac wiki can support like headings, lists, bold/italics, etc. However, pasting of tables ''into'' the editor is broken (#2141). Other issues seen were bad closing of formatting and sometimes extra newlines were added or removed. The issues were reasonably solvable through manual cleanup in "textarea" mode. There are some bugs, a few mentioned above. The only real problem with the bugs is that sometimes the appearance is correct on the screen but the code generated is incorrect. === Summary === For someone who is already a good Trac user, the quirks are easy enough to recognize and the tool is still quite helpful. For new users, the current state is a toss-up on whether to use it directly or train the users on wiki formatting. For almost all basic edits it works well, but quirks on atypical cases or handling of newlines can be surprising to new users. == Recent Changes == [[ChangeLog(tracwysiwygplugin, 3)]] == Author/Contributors == '''Author:''' [wiki:jun66j5] [[BR]] '''Contributors:'''