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
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:
- 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.)
- 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).
- The confirmation page will show the snapshot statistics, and (if
you set up the publishing topic settings) will have a ‘Publish’ button.
- 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.
- 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.