Home page for edittwiki - the external editor tool for TWiki wiki topics.
I have been using the editMoin tool to edit my Personal Wiki and have found the superior editing capabilities of an editor extremely handy. Integrated spell checking, syntax highlighting ... all very helpful. I've been working with a TWiki installation lately and have struggled to find a similar capability. SO, in the spirit of the editMoin tool, I have written the edittwiki external editor utility.
You must have installed a current JRE/JDK for your platform and the java executable should be in your path. To test this, run java -version from a command prompt. You should get a response from your java installation with its release information.
This has been tested on Windows XP and should work on any platform that has a recent java JDK/JRE.
editTwiki is written in python and compiled into a java jar using Jython which makes it a regular java application packaged into a jar.
To install it, unzip the distribution into an installation directory. Next add the distribution's bin directory to your path and add the edittwiki.jar file to your CLASSPATH. Next, define the EDITTWIKI environment variable to point to to the edittwiki.cfg config file and edit the config file to reflect the twiki installation you want to use it with. Once you are setup, run the following:
java edittwiki --help
This should display the usage information. You are done and ready to work.
Edittwiki defaults to using notepad as your editor. To set your own editor, define the EDITOR variable to the full path to your editor of choice. For example:
The basic commands are follows:
java edittwiki -H host_section -T Web.Topic
If you have defined a twiki host section in your config file pointing to the twiki.org site, you would use this as follows:
java edittwiki -H twiki -T Main.MyUserHomePage
The purpose of the config file is allow you to setup the connection details for the TWiki sites you use in advance. This keeps the amount of typing down to a minimum.
The following is a sample config file:
[general] host=www.twiki.org protocol=http userid=YourId password=YourPassw0rd [local] host=localhost:8080 protocol=http [external] host=external.wiki.com subdir=/twiki cgibin=bin protocol=http userid=YourId password=YouPassw0rd
The section name is used on the command line to specify which server you want to talk to. If you do not specify a section, it looks for the general section as a default.
The host entry is the FQDN of the hostname where TWiki is installed. If your twiki install is on a port other than port 80, you should add it to the host setting. For example:
This is either http or https and must match your TWiki's installation (obviously).
If your TWiki site is installed in the root directory of the server and you access it through a url like:
Then you can safely ignore this setting. If however you use a url like the following:
then you need to define the initial directory after the hostname via the subdir setting.
If your TWiki site has installed its scripts in a directory other than cgi-bin, you need to specify that here:
If your TWiki install is secured, you will be prompted to enter your credentials when you run the edittwiki tool. To avoid this hassle, define your userid and password in the config section for the secured host and you will not be prompted.
Thanks to David Blank-Edelman for extensively testing this with an https server. His conclusion is that due to a limitation in jython, it is not possible at this time. The current work around is to use the python source directly and update your python install to support https via openssl.
I have tried to test this as extensively as I can, but doubtless there are many bugs and assumptions which will cause issues for others with their individual TWiki installations. Please provide any feedback you may have to (etaekema at earthlink dot net).
last change 2005-01-02 22:37:36