A feature of MemoWiki is its ability to publish a topic to a web server which is not running MemoWiki. This is done by creating a static snapshot of the topic, and then publishing that snapshot. Currently you can only publish a topic if you are are on the local (server) machine or you are an administrator.

To publish a topic, take the following steps:

1. Set up the details of your web server using the Topic settings page. (You will only be able to do this if you are are on the local (server) machine or you are an administrator.)

2. Use Create/publish static snapshot on the more... page to create a publishable static snapshot (after the first time, this just updates the static snapshot to ensure it’s current).

3. The confirmation page will show the snapshot statistics, and (if you set up the publishing topic settings) will have a ‘Publish’ button.

4. Click the publish button. This should publish the snapshot, which may take some time (depending on the web server). If any problem is reported, see the Help page for some suggestions.

Notes

• Publishing sends the HTML files of the static snapshot and also the contents of the files directory (and its subdirectories) to the web server. Most web servers will allow listing and browsing of all those files.

• By default, only files whose timestamps are younger than those on the server are updated (to minimise update times), and no files are deleted (in case some files were placed on the server by some other means). These defaults can be overridden by changing the settings for a Topic.

• Wiki pages or references which start with the character ‘*’ are considered private; they will not be included in the static snapshot and hence will not be published.

• On entering a web site or page, most web servers connect the user (client browser) to the page named ‘index’ (note that this name must be all lower-case on many servers). This means that if you wish, you can set up a different ‘entry point’ to the static snapshot than is used for the MemoWiki topic, by having a distinct index page (MemoWiki will ensure this name is lowercase, so you can call it ‘Index’ if you like). If you do not supply an index page then a copy of the topic home page, named ‘index’, will be created.

• By default, MemoWiki will provide a standard header and footer for each snapshot page. If you select Use private snapshot header and footer as a Topic setting, then MemoWiki will use the pages ‘*snap-header’ and ‘*snap-footer’ as the header and footer for each snapshot page (if they exist – it is not required that there be a header or footer). Please see the Help for Snapshot and Style Sheets pages for more details.

• FTP session logs (one for the HTML snapshot and one for the contents of files, if any) for the most recent Publish are saved in the _archive directory for the topic.