= Trac Wiki Editor 4 Eclipse = [[PageOutline(2-3, , inline)]] == Description == !WikiEditor4Eclipse is a new plug-in providing Trac Wiki editing capabilities to Eclipse IDE. A new version of this plugin was released on August 2011. You can try it using the following Eclipse update site: http://trac-hacks.org/svn/wikieditorforeclipseplugin/update-site/v_0.1.0.x === Implemented Features === Current version is 0.1.0 provides the following features: * Trac Wiki Servers explorer - New hierachical tree view among other fixes * Eclipse Wiki Editor: * Upgraded from the original EclipseTracPlugin plugin to use Mylyn [http://wiki.eclipse.org/Mylyn/WikiText Mylyn WikiText]. * Spellcheck (work in progress) * Wiki Page management: Creation, edition and page deletion. * Concurrent edition management: - Prevents overwriting other users changes when a concurrent edit happens. - Helps merge contents when a concurrent edit happens. === Development Plan === ==== 0.0.x series (old stable) : ==== * Trac Wiki Server explorer with hierarchical tree. * Eclipse Wiki Editor with syntax highligting and autocompletion borrowed from EclipseTracPlugin. * Wiki Page management (Creation, Edition and Deletion) * Concurrent edition and conflict resolution: - Prevents overwriting other users changes when a concurrent edit happens. - Opens a Compare/Merge Editor when a concurrent edit happens. ==== 0.1.x series (current branch): ==== * Replace EclipseTracPlugin wiki source editor: - Integrate with [http://wiki.eclipse.org/Mylyn/WikiText Mylyn WikiText] syntax highligting - Replace current Outline view with !WikiText outline view * Enable/Facilitate spellcheck facilities in wiki source editor. ==== 0.2.x series: ==== * Export wiki pages to different formats provided by !WikiText (html, docbook, pdf) == Installation == !WikiEditor4Eclipse features a Wiki Editor as an [http://eclipse.org Eclipse] plugin that communicates with Trac wiki server through the XmlRpcPlugin. It requires the following software to be installed: === Server === * XmlRpcPlugin: !WikiEditor4Eclipse requires XmlRpcPlugin to be installed and enabled on the server * [download:eclipsetracplugin/tracrpcext/0.10 TracRpcExt] (optional): !WikiEditor4Eclipse reuses !TracRpcExt plugin from EclipseTracPlugin to provide a ''page history'' view. This dependency is optional as the editor can work without it, but if its not installed and enabled you will miss page history functionality. === Client === !Install de Editor plugin using one of the following update sites: * '''0.0.6''' http://trac-hacks.org/svn/wikieditorforeclipseplugin/update-site/v_0.0.x * '''0.1.x''' http://trac-hacks.org/svn/wikieditorforeclipseplugin/update-site/v_0.1.0.x == Screenshots == * Wiki Editor Perspective: [[Image(source:/wikieditorforeclipseplugin/branches/docs/screenshots/wikieditor-prespective.png)]] * Merging conflicting changes [[Image(source:/wikieditorforeclipseplugin/branches/docs/screenshots/merge-editor.png)]] == Bugs/Feature Requests == You can help improving the wiki editor. If you find something annoying, something wrong or something missing you may want to file a [http://trac-hacks.org/newticket?component=WikiEditorForEclipsePlugin&owner=ivangsa new ticket]. ==== Before filing a a new bug: ==== * Read the [wiki:WikiEditorForEclipsePlugin/FAQ Frequently Asked Questions] page. There you can find answers to common situations. * Search [report:9?COMPONENT=WikiEditorForEclipsePlugin existing bugs] and feature requests in !WikiEditor4Eclipse to see if it was already reported or there is a workaround available. ==== Reporting a bug ==== When reporting a new bug please include all relevant information and steps to reproduce the bug: * Plugin version * Stack trace details found in Eclipse Error Log (Window -> Show View -> Error Log) or in '''/.metadata/.log'''. * If you think they may be relevant, Include Trac and XmlRpcPlugin versions. * And don't forget to detail steps necesary to reproduce the bug. If you find this plugin useful you can rate it or leave some feedback at [http://eclipseplugincentral.com/Web_Links-index-req-viewlink-cid-1521.html Eclipse Plugin Central]. == Building from Source == You can check out !WikiEditor4Eclipse from [http://trac-hacks.org/svn/wikieditorforeclipseplugin here] using Subversion, or [source:wikieditorforeclipseplugin browse the source] with Trac. This plugin is composed by: * Java !WikiRPC client library: including a high level API to access this [http://www.jspwiki.org/wiki/WikiRPCInterface WikiRPCInterface] and a batch of automated tests to test default implementation against a Trac server (see [#RunningTests Running Tests] below). * Set of Eclipse plugins: Eclipse wiki source editor and management capabilities. [[Image(source:/wikieditorforeclipseplugin/branches/docs/screenshots/source-layout.png)]] In order to build !WikiEditor4Eclipse you will need the following software: * Subversion client * Java JDK >= 1.5 * Maven 3 You can build the plugin running the following commands on the command line: {{{ #!sh svn co http://trac-hacks.org/svn/wikieditorforeclipseplugin/trunk WikiEditor4Eclipse cd WikiEditor4Eclipse mvn clean install -DskipTests }}} ... {{{ [INFO] ------------------------------------------------------------------------ [INFO] Reactor Summary: [INFO] [INFO] Trac WikiEditor 4 Eclipse ......................... SUCCESS [0.203s] [INFO] Trac WikiEditor 4 Eclipse ~ Core .................. SUCCESS [1.891s] [INFO] Trac WikiEditor 4 Eclipse ~ Eclipse Modules ....... SUCCESS [0.015s] [INFO] Trac WikiEditor 4 Eclipse ~ org.trachacks.wikieditor.eclipse.core SUCCESS [3.172s] [INFO] Trac WikiEditor 4 Eclipse ~ org.trachacks.wikieditor.eclipse.plugin SUCCESS [1.875s] [INFO] Trac WikiEditor 4 Eclipse ~ org.trachacks.wikieditor.eclipse.feature SUCCESS [0.078s] [INFO] Trac WikiEditor 4 Eclipse ~ org.trachacks.wikieditor.eclipse.site SUCCESS [2.047s] [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 53.860s [INFO] Finished at: Thu Aug 04 12:27:36 CEST 2011 [INFO] Final Memory: 94M/242M [INFO] ------------------------------------------------------------------------ }}} This will create a local eclipse update site at ''!WikiEditor4Eclipse/source/eclipse/org.trachacks.wikieditor.eclipse.site/target/site'' you can point Eclipse Update Manager to. (For instructions on how to build versions 0.0.x (0.0.6 and older) see [/wiki/WikiEditorForEclipsePlugin?version=37#BuildingfromSource]) == Running Tests == In order to run automated tests against a Trac server you will need to setup a local server. These are the prerequisites in order to run the test suit included in the ''core'' library: * Set up a test project on a local Trac server of hand. This Trac server must support BASIC authentication on the standard Trac url location. * Set up an user for that project with (at least) the following permissions: - WIKI_VIEW - WIKI_CREATE - WIKI_MODIFY - XML_RPC * Set up another user with also the following permission: - WIKI_DELETE Default username/password for these users are: * user/user * admin/admin Default url for local Trac test project is: * !http://localhost/trac/test If you need to override settings configured at [source:wikieditorforeclipseplugin/trunk/source/core/pom.xml#L111 core/pom.xml], probably the best way is creating a new ''profile'' on the standard maven $HOME/.m2/settings.xml file. You can use the following snippet as base: {{{ #!text/xml test-properties !maven.test.skip http://localhost/trac/test admin admin user user }}} NOTE: some TestSuites need to be run in particular order but this is not guaranteed by unit testing technology used. This is something I would like to address at some point, as it is a potential test failure cause in some particular environments. If after setting up testing prerequisites as mentioned in this guide, automated tests still fail to run in your particular environment you can open a [http://trac-hacks.org/newticket?component=WikiEditorForEclipsePlugin&owner=ivangsa ticket] for support. Happy Hacking!! == Comments == If you find this plugin useful you can rate it or leave some feedback at [http://eclipseplugincentral.com/Web_Links-index-req-viewlink-cid-1521.html Eclipse Plugin Central]. == Recent Changes == [[ChangeLog(wikieditorforeclipseplugin, 3)]] == Author/Contributors == '''Author:''' [wiki:ivangsa] [[BR]] '''Maintainer:''' [wiki:ivangsa] [[BR]] '''Contributors:''' [wiki:EclipseTracPlugin]