WikidPad on Linux

Wikidpad runs well under Linux. You will need to make sure Python and the wxpython packages are installed (these will be provided by your distribution - see below e.g. for ubuntu). Then, download the WikidPad source and stick it in your favourite directory. From this directory, start WikidPad with

python WikidPad.py

A WikidPad icon can be found in the WikidPad/icons directory.


See also the tips and experiences reported in the following sections (some of which may be out of date).

Simple Script for a WikidPad launcher

To create a launcher that starts WikidPad you need a script. Create a file called, for example, wikidpad:

gedit wikidpad

Paste this code into the opened document (replace /path/to/folderof/WikidPad):

#!/bin/bash

cd /path/to/folderof/WikidPad
python WikidPad.py

Save the file and close it. Open a terminal and make the script executable:

chmod +x wikidpad

Finally create a launcher according to the HowTo on https://help.ubuntu.com/community/HowToAddaLauncher. Use the command

/path/to/wikidpad

If you wish you can also copy (or symlink) the script to one of the paths defined in your $PATH, e.g. /usr/bin/, that way you can launch the program from the command line.

Webkit renderer for page preview mode

v2.2beta03 and higher have support for using webkit to render the internal HTML preview. This is much more powerful than the built-in render and brings support for CSS/flash/javascript and all the other features webkit provides. It does however have a few additional dependencies which will need to be met before it can be used:

  • pygtk
  • pywebkitgtk

Once installed you should be able to select Webkit as the preview renderer in the HTML preview/export option panel.


Integrated Instructions for Ubuntu

For Ubuntu users that would prefer a more integrated installation of WikidPad into the terminal, nautilus actions, and Unity that behaves as expected and better then the simple script above, see the instructions at https://github.com/brianclements/wikidpad-utils.


Log of experiences

WikidPad 2.x on Ubuntu

On ubuntu lucid and maverick, all you need are the wxpython and wxtools packages available from the synaptic package manager (which will usually already be installed). Then WikidPad 2.x will run perfectly. On lucid, it is worth checking you get wx version 2.8.11, as some annoying bugs were fixed in that version - if the default package is older, there is a PPA linked from the wxPython webpage as far as I recall.

Alternatively, WikidPad 2.0 also appears to be included this PPA: http://www.ubuntuupdates.org/packages/show/254039

20.05.2007

hi guys - I've just recently switched my laptop across to Ubuntu (my first permanent Linux install after many many years of Windows) and was pleasantly surprised to have no troubles getting WikidPad up and running using the downloaded source (although I'm not sure I have sqlite wikis working yet... ) are those linux installation instructions accurate? adding the lib directory to the python path appears to be unnecessary provided you chdir to the wikidpad source directory before running "python WikidPad.py".

The only addition from the standard ubuntu installation was the python-wxgt2.8 package: sudo apt-get install python-wxgtk2.8 also, wouldn't it be better to advise people to copy the source files to /usr/lib instead of /usr/share since the latter isn't supposed to contain code/executables, and to create a small bash script in /usr/ bin to chdir then run the python command, something like:

#!/bin/sh chdir /usr/lib/WikidPad python WikidPad.py

(might need to chmod the file to make sure it is executable by all users). Using this I was able to setup a nice WikidPad runner (using the standard WikidPad icon) on my gnome task panel that calls the wikidpad script.

Couple of other things:

* I'm running Ubuntu and didn't encounter the issues listed at: http://wikidpad.python-hosting.com/wiki/IssuesUnderLinux - how old is that stuff?

WikidPad on Fedora 7 (Dec. 2007)

Fortunately it was very easy to get WikidPad running under Fedora. I had to additionally install

* wxGTK-gl-2.8.7-2.fc7

* wxPython-2.8.7.1-4.fc7

Then I unzipped the WikidPad source file WikidPad-1.9....-src.zip into an empty directory (e.g. /home/my_name/sw/WikidPad). For easy execution I created the following script file, made it executable and stored it somewhere in the path:

#!/bin/bash
cd $HOME/sw/WikidPad
python WikidPad.py

Note: That way it's for my user's usage only, since it's in my home directory.

Running WikidPad on Linux using Wine

I was able to get WikidPad running in Wine, after a quick trip to the irc channel #winehq on irc.freenode.net, here are my steps:

* Install Wine (I was using Ubuntu so it was as easy as apt-get install wine)

* Copy the msvcrt.dll from your Windows/system32 directory to /root/.wine/drive_c/windows/system/

* Type winecfg at the terminal (as root) and under the Libraries tab, add msvcrt.dll

* Run the installer and it *should* work.

* This fixes the error with the toolbar fonts as described above, and also shows that error regarding saving WikidPad wikis between Linux and Windows partitions (error connecting to database in 'Z:\home\endura\TestWiki?\data'. bad marshal data. This has to do with the difference of Unix and Windows carriage returns. ** Update: You won't have the last problem if you are running WikidPad 1.20beta or above. **'

Running WikiPad on Linux using CrossOver?

I have run the installer under Cross Over http://www.codeweavers.com/products/ and it works like a charm.

WikidPad as portable application

I used Wididpad 1.9beta for Windows and now changed to Ubuntu Hardy. I had a portable application installed on my usb and I just copied it into Ubuntu and it works fine. January 2009

Running WikidPad 2.0 in Ubuntu

To run WikidPad 2.0 in Ubuntu you need python-wxgtk2.8. To check if it is installed, open a terminal and run

dpkg --get-selections | grep python-wxgtk

If the answer is "python-wxgtk2.8 install" then it is installed. If not, run

sudo apt-get install python-wxgtk2.8

If python-wxgtk2.6 is also displayed in the answer with the flag "install", then uninstall it with

sudo apt-get remove python-wxgtk2.6

Installing python-wxgtk2.8 will not replace python-wxgtk2.6, so it is important to uninstall python-wxgtk2.6, otherwise WikidPad will choose that version. There is python code in WikidPad 2.0 that only works with python-wxgtk2.8. python-wxgtk2.8 is backwards compatible with python-wxgtk2.6, so you can run WikidPad 1.9 as well.

Finally download the WikidPad source code from http://sourceforge.net/projects/wikidpad/files/. Unzip it to a directory of your choice, cd to that directory and run

python WikidPad.py

Running WikidPad in Linux using Python (this section appears somewhat out of date)

There may be a few IssuesUnderLinux (many will have been resolved since that wiki page was last edited). It helps if you are reasonably adept at Linux administration and Python, but you can follow the basic instructions below and have a working installation.

The main python file Wikidpad.py depends on the two packages gadfly and pwiki in the lib directory. There are two ways to get give Wikidpad.py access to these packages.

* easy - make the lib path available to the python interpreter

* intermediate - install the libraries into the system directories

Note: some experimental DEBs are available for Ubuntu

Make lib path available

Add the lib path to the PYTHONPATH variable to make it available to the python interpreter. This can be done with a simple command like export:

export PYTHONPATH=$PYTHONPATH:lib/ After that you can run WikidPad.py from its directory simply as: python WikidPad.py

Install into the system directories

* Go to the lib directory.

* Copy the directories gadfly and pwiki to the python site-packages path. This path is under your python lib path for example in /usr/lib/python2.4/lib/site-packages

* create a <dir>.pth path file for both gadfly and pwiki in <python library path>/site packages. Again this is relative to the python lib path as above.

After that you can again run WikidPad.py from its directory.

Potential problems

* Depending on the version of wxPython you are using, you might get errors related to unicode.

* You'll need to install wxpython 2.4 (in Debian or Ubuntu : apt-get install libwxgtk2.4-python(replaced by python-libgtk2.4-python and python-wxtools on ubuntu dapper)) if you get the error referenced above, which is:

Error starting wikidPad. 'ascii' codec can't decode byte 0xf6 in position 1569: ordinal not in range(128).

* Another thing you can do to fix Unicode issues is to edit or create the sitecustomize.py in your Python site-packages directory, and add (but not indented!):

import sys sys.setdefaultencoding('iso-8859-1') # or something else for your language's character set

* You may find that once you get it working, you are unable to type anything in the panel. Make sure your permissions on the WikidPad file are correct.

* I run 64-bit Debian GNU/Linux and have somewhat of a mongrel system (the Debian 64-bit ditribution recently switched from Unstable to Stable), but I found that wxPython 2.6 (and libwxgtk2) eliminated the very high CPU utilization that lesser versions seemed to cause. Also, the greitmayr branch in SVN is friendlier to more recent wxPython versions. Still wants to uses a Windowish function to start the Help wiki (sigh) (no longer true, help now works fine on Linux - I tried 1.8 beta).

* If you have or install your distribution's Gadfly package, you may also get the compiled kjbuckets; copy Wikidpad's sql_mar.py into the gadfly directory (will this break other uses of Gadfly?)

* You may find that WikidPad is unable to find SQLite. To ensure you're able to use SQite first make sure you have the python ctypes package installed. (By the way, ctypes is now included part of Python 2.5, so if you have an up to date distribution, you are likely to already have it). Second, you may need to tweak lines 95-6 of /lib/pwiki/SqliteThin3.py so that WikidPad can find the Sqlite3 Library. On Ubuntu, I had to replace "libsqlite3.so" with "libsqlite3.so.0"

* If your window manager is set to always activate the window which is under the mouse pointer, you may have problems with the incremental search. For FVWM, add a line in the configuration file:

Style "WikidPad i-search" NoTitle, FPGrabFocus