MemoWiki is a simple Wiki » intended for personal documentation, research, and small-scale collaboration. It allows the viewing, editing, and maintenance of a collection of pages using just a web browser. To make it easy to support research, MemoWiki integrates its pages with academic references (which can be edited just as easily) and other files (such as papers, programs, and images).

Here’s an introduction and list of the main features:

• Pages are marked up using an extended WikiPedia » markup developed for SpeleoGroup »; here’s a sample page and the markup used for it, and a sample reference and the markup used for it

• All pages, references, and related data are held as simple plain-text files, so are available to other tools (for example, you don’t have to use MemoWiki to edit pages or references)

• You can link directly from any MemoWiki page to another page, a reference, a file in the project, a World Wide Web page (or other URL), a geographic location, or a Wikipedia page using simple square-brackets notations (‘remote’ links (to data not in a MemoWiki collection) are identified by the symbol “»” for Web pages, or “Δ” for GPS locations)

• Pages are grouped in Projects; to start a new project, first use the Projects button on an active^[1] MemoWiki page to view existing projects and their names, choose a name for your project, and then click on the Add Project button to start creating the project

• You can make a static snapshot of a project at any time; this snapshot does not require any software to view (other than a web browser), and is suitable for publishing to most Internet web servers; publishing can be done directly as a MemoWiki action

• Several tools are provided for navigating within MemoWiki projects; as well as following links, you can list the pages, references, and files (and sort them in various ways), view recent changes, check for missing pages and links, search for words, and so on

• MemoWiki can be used locally on a single machine or as a web server, either as a single-user Wiki (all changes are anonymous) or using the multiple-user support, which allows more than one user to edit pages and be identified

• MemoWiki pages drag in no other files (images, style sheets, etc.) and use no scripts, unless explicitly coded in the content of a page; this makes them both small and fast to load

• Apart from the web server, MemoWiki is written entirely in Rexx, using the ooRexx » (Open Object Rexx) implementation; this makes it easy to modify and extend

• MemoWiki is robust (subject to the constraints of the operating system) — if, for example, multiple users edit the same page, any editing conflict is notified to the user, and all versions of the page are saved and are available in the history of the page; no database is used

Currently MemoWiki runs on Linux or Windows, using the GoServe web server; however, operating system and GoServe dependencies are localized so it should be easy to port it to a different platform or server.

MemoWiki installation

MemoWiki comprises a web server (a Linux or Windows version of GoServe) and a collection of Rexx programs which effect the various actions that the client can ask for (view a page, edit a page, show the page history, etc.). Please note that these programs are only available within IBM at present – sorry.

The server can be started manually or on system startup. Here are the detailed installation instructions. Once MemoWiki is installed and the server has been started, you can immediately start working with it.

Working with a project

Projects can be creating simply by clicking on the ‘Add Project’ button on the Projects page and then supplying a name for the new project.

Within each project (a directory within the MemoWiki data/server structure), there are three collections of files (subdirectories) which hold data:

wiki	holds the Wiki pages (.wiki files). Wiki files may be created and edited with MemoWiki, using plain-text editing with a simplified markup for indicating fonts, formatting, and links. The page with the same name as the project is the ‘home page’ for the project, and you can edit this immediately you have created a project. The simplest way to create another new page is to make a link to it in the home page (or any other page) and then click on the link. To link to a Wiki page from another page, use the notation [page name]. If you want different text to appear than the page name, this can be placed in the link, following a vertical bar. For example, the links: [sample page] and [sample page|a test page] appear thus: sample page and a test page. You can also create a page by clicking on the ‘more...’ button and then on ‘Add or View page’. (To delete a wiki page, edit the page and delete all content.)
refs	(optional) holds references (.ref files). References are also plain-text files (using a specialized markup) and may be edited just like Wiki pages. To create a new one, use ‘Add a new Reference’ on the actions (more...) page. To link to a Reference from a Wiki page, use the same notation as for other links, for example, [smith1998].
files	In the Picos de Europa (optional) holds general files (e.g., .pdf documents or image files such as the one shown to the right). Images and text files can be embedded in a displayed page; other files can be be opened with the browser by clicking on a link to them. General files cannot be edited directly (unless your browser allows this), but you can use one of the ‘Explore’ options on the actions page to view the files with Windows Explorer if you are on the same machine as the server. The files directory may have subdirectories. To add (upload) a file to a project, or to replace one, use ‘Add or replace a File’ on the actions (more...) page. To delete a file, replace it with an empty (length=0) file. To link to a general file from a Wiki page, use, for example, [smith1998-spikes-paper.pdf], or [subdir/commentary.txt]. The image above is included in this page using the link: [Cow.jpg|In the Picos de Europa|image width=200 height=151]; in this link the vertical bars separate a caption and some parameters (the width and height parameters are optional – see the Links page for details).

Links are resolved in the above order so (for example) a Wiki page called ‘smith1998’ would take precedence over a reference of the same name. A link can be set up to specify a GPS location, Δ, which links to Google maps. Here is a full description of MemoWiki Links.

Whenever a Wiki page or Reference is edited or deleted, a dated copy of the page is archived in an archive directory within the project directory; you can view the archived copies, revert the current page to an earlier version, or delete archived copies using the History page.

Other facilities let you look at various lists of pages, including a list of recently edited pages and build or browse a static snapshot of a project (which can be published to a web server), among other things. On any page, click on the ‘more...’ button for a complete list of available actions.

Here is a list of Help pages, and some information about multiple-user support.

Notes

[1] An active MemoWiki page will have four or more buttons (or a small link ‘more...’) at top right. If the page you are looking at has only one (‘Home’) then you are probably viewing a static snapshot of a MemoWiki project, which can only be viewed and not edited.