---
format: DocBook
...
<sect1 id="navigating">
<title>Navigating</title>
<para>
The most natural way of navigating is by clicking wiki links that
connect one page with another. The <quote>Front page</quote> link in
the navigation bar will always take you to the Front Page of the
wiki. The <quote>All pages</quote> link will take you to a list of
all pages on the wiki (organized into folders if directories are
used). Alternatively, you can search using the search box. Note that
the search is set to look for whole words, so if you are looking for
<quote>gremlins</quote>, type that and not <quote>gremlin</quote>.
The <quote>go</quote> box will take you directly to the page you
type.
</para>
</sect1>
<sect1 id="creating-and-modifying-pages">
<title>Creating and modifying pages</title>
<sect2 id="registering-for-an-account">
<title>Registering for an account</title>
<para>
In order to modify pages, you’ll need to be logged in. To register
for an account, just click the <quote>register</quote> button in
the bar on top of the screen. You’ll be asked to choose a username
and a password, which you can use to log in in the future by
clicking the <quote>login</quote> button. While you are logged in,
these buttons are replaced by a <quote>logout so-and-so</quote>
button, which you should click to log out when you are finished.
</para>
<para>
Note that logins are persistent through session cookies, so if you
don’t log out, you’ll still be logged in when you return to the
wiki from the same browser in the future.
</para>
</sect2>
<sect2 id="editing-a-page">
<title>Editing a page</title>
<para>
To edit a page, just click the <quote>edit</quote> button at the
bottom right corner of the page.
</para>
<para>
You can click <quote>Preview</quote> at any time to see how your
changes will look. Nothing is saved until you press
<quote>Save.</quote>
</para>
<para>
Note that you must provide a description of your changes. This is
to make it easier for others to see how a wiki page has been
changed.
</para>
</sect2>
<sect2 id="page-metadata">
<title>Page metadata</title>
<para>
Pages may optionally begin with a metadata block. Here is an
example:
</para>
<programlisting>
---
format: latex+lhs
categories: haskell math
toc: no
title: Haskell and
Category Theory
...
\section{Why Category Theory?}
</programlisting>
<para>
The metadata block consists of a list of key-value pairs, each on
a separate line. If needed, the value can be continued on one or
more additional line, which must begin with a space. (This is
illustrated by the <quote>title</quote> example above.) The
metadata block must begin with a line <literal>---</literal> and
end with a line <literal>...</literal> optionally followed by one
or more blank lines.
</para>
<para>
Currently the following keys are supported:
</para>
<variablelist spacing="compact">
<varlistentry>
<term>
format
</term>
<listitem>
<para>
Overrides the default page type as specified in the
configuration file. Possible values are
<literal>markdown</literal>, <literal>rst</literal>,
<literal>latex</literal>, <literal>html</literal>,
<literal>markdown+lhs</literal>, <literal>rst+lhs</literal>,
<literal>latex+lhs</literal>. (Capitalization is ignored, so
you can also use <literal>LaTeX</literal>,
<literal>HTML</literal>, etc.) The <literal>+lhs</literal>
variants indicate that the page is to be interpreted as
literate Haskell. If this field is missing, the default page
type will be used.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
categories
</term>
<listitem>
<para>
A space or comma separated list of categories to which the
page belongs.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
toc
</term>
<listitem>
<para>
Overrides default setting for table-of-contents in the
configuration file. Values can be <literal>yes</literal>,
<literal>no</literal>, <literal>true</literal>, or
<literal>false</literal> (capitalization is ignored).
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
title
</term>
<listitem>
<para>
By default the displayed page title is the page name. This
metadata element overrides that default.
</para>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<sect2 id="creating-a-new-page">
<title>Creating a new page</title>
<para>
To create a new page, just create a wiki link that links to it,
and click the link. If the page does not exist, you will be
editing it immediately.
</para>
</sect2>
<sect2 id="reverting-to-an-earlier-version">
<title>Reverting to an earlier version</title>
<para>
If you click the <quote>history</quote> button at the bottom of
the page, you will get a record of previous versions of the page.
You can see the differences between two versions by dragging one
onto the other; additions will be highlighted in yellow, and
deletions will be crossed out with a horizontal line. Clicking on
the description of changes will take you to the page as it existed
after those changes. To revert the page to the revision you’re
currently looking at, just click the <quote>revert</quote> button
at the bottom of the page, then <quote>Save</quote>.
</para>
</sect2>
<sect2 id="deleting-a-page">
<title>Deleting a page</title>
<para>
The <quote>delete</quote> button at the bottom of the page will
delete a page. Note that deleted pages can be recovered, since a
record of them will still be accessible via the
<quote>activity</quote> button on the top of the page.
</para>
</sect2>
</sect1>
<sect1 id="uploading-files">
<title>Uploading files</title>
<para>
To upload a file–a picture, a PDF, or some other resource–click the
<quote>upload</quote> button in the navigation bar. You will be
prompted to select the file to upload. As with edits, you will be
asked to provide a description of the resource (or of the change, if
you are overwriting an existing file).
</para>
<para>
Often you may leave <quote>Name on wiki</quote> blank, since the
existing name of the file will be used by default. If that isn’t
desired, supply a name. Note that uploaded files
<emphasis>must</emphasis> include a file extension (e.g.
<literal>.pdf</literal>).
</para>
<para>
If you are providing a new version of a file that already exists on
the wiki, check the box <quote>Overwrite existing file.</quote>
Otherwise, leave it unchecked.
</para>
<para>
To link to an uploaded file, just use its name in a regular wiki
link. For example, if you uploaded a picture
<literal>fido.jpg</literal>, you can insert the picture into a
(markdown-formatted) page as follows:
<literal></literal>. If you uploaded a PDF
<literal>projection.pdf</literal>, you can insert a link to it
using: <literal>[projection](projection.pdf)</literal>.
</para>
</sect1>
<sect1 id="markdown">
<title>
Markdown
</title>
<para>
<programlisting>
This wiki's pages are written in
<ulink url="http://johnmacfarlane.net/pandoc">pandoc</ulink>'s
extended form of
<ulink url="http://daringfireball.net/projects/markdown">markdown</ulink>.
If you're not familiar with markdown, you should start by looking at
the
<ulink url="http://daringfireball.net/projects/markdown/basics">markdown
&quot;basics&quot; page</ulink> and the
<ulink url="http://daringfireball.net/projects/markdown/syntax">markdown
syntax description</ulink>. Consult the
<ulink url="http://johnmacfarlane.net/pandoc/README.html">pandoc
User's Guide</ulink> for information about pandoc's syntax for
footnotes, tables, description lists, and other elements not present
in standard markdown.
</programlisting>
</para>
<para>
<programlisting>
Markdown is pretty intuitive, since it is based on email
conventions. Here are some examples to get you started:
</programlisting>
</para>
<table>
<tr>
<td>
<literal><emphasis>emphasized text</emphasis></literal>
</td>
<td>
<emphasis>emphasized text</emphasis>
</td>
</tr>
<tr>
<td>
<literal><emphasis role="strong">strong emphasis</emphasis></literal>
</td>
<td>
<emphasis role="strong">strong emphasis</emphasis>
</td>
</tr>
<tr>
<td>
<literal><literal>literal text</literal></literal>
</td>
<td>
<literal>literal text</literal>
</td>
</tr>
<tr>
<td>
<literal>*escaped special characters*</literal>
</td>
<td>
<emphasis>escaped special characters</emphasis>
</td>
</tr>
<tr>
<td>
<literal><ulink url="http://google.com">external link</ulink></literal>
</td>
<td>
<ulink url="http://google.com">external link</ulink>
</td>
</tr>
<tr>
<td>
<literal><inlinemediaobject>
<imageobject>
<imagedata fileref="/img/icons/folder.png" />
</imageobject>
</inlinemediaobject></literal>
</td>
<td>
<inlinemediaobject> <imageobject>
<imagedata fileref="/img/icons/folder.png" /> </imageobject>
</inlinemediaobject>
</td>
</tr>
<tr>
<td>
Wikilink: <literal><ulink url="">Front Page</ulink></literal>
</td>
<td>
Wikilink: <ulink url="">Front Page</ulink>
</td>
</tr>
<tr>
<td>
<literal>H<subscript>2</subscript>O</literal>
</td>
<td>
H<subscript>2</subscript>O
</td>
</tr>
<tr>
<td>
<literal>10<superscript>100</superscript></literal>
</td>
<td>
10<superscript>100</superscript>
</td>
</tr>
<tr>
<td>
<literal><emphasis role="strikethrough">strikeout</emphasis></literal>
</td>
<td>
<emphasis role="strikethrough">strikeout</emphasis>
</td>
</tr>
<tr>
<td>
<literal>$x = \frac{{ - b \pm \sqrt {b^2 - 4ac} }}{{2a}}$</literal>
</td>
<td>
$x = \frac{{ - b \pm \sqrt {b^2 - 4ac} }}{{2a}}$<footnote>
<para>
<programlisting>
If this looks like code, it's because jsMath is not installed on
your system. Contact your administrator to request it.
</para>
</programlisting>
</footnote>
</td>
</tr>
<tr>
<td>
<literal>A simple footnote.<footnote>
<para>
Or is it so simple?
</para>
</footnote></literal>
</td>
<td>
A simple footnote.<footnote>
<para>
<programlisting>
Or is it so simple?
</para>
</programlisting>
</footnote>
</td>
</tr>
<tr>
<td>
<pre>
> an indented paragraph,
> usually used for quotations
</pre>
</td>
<td>
<blockquote>
<programlisting>
<para>
an indented paragraph, usually used for quotations
</para>
</programlisting>
</blockquote>
</td>
<tr>
<td>
<pre>
#!/bin/sh -e
# code, indented four spaces
echo "Hello world"
</pre>
</td>
<td>
<programlisting>
<sect1 id="binsh--e">
<title>!/bin/sh -e</title>
<para>
</para>
</sect1>
<sect1 id="code-indented-four-spaces">
<title>code, indented four spaces</title>
echo <quote>Hello world</quote>
</programlisting>
</td>
</tr>
<tr>
<td>
<pre>
* a bulleted list
* second item
- sublist
- and more
* back to main list
1. this item has an ordered
2. sublist
a) you can also use letters
b) another item
</pre>
</td>
<td>
<itemizedlist spacing="compact">
<programlisting>
<listitem>
<para>
a bulleted list
</para>
</listitem>
<listitem>
<para>
second item
</para>
<itemizedlist spacing="compact">
<listitem>
<para>
sublist
</para>
</listitem>
<listitem>
<para>
and more
</para>
</listitem>
</itemizedlist>
</listitem>
<listitem>
<para>
back to main list
</para>
<orderedlist numeration="arabic" spacing="compact">
<listitem>
<para>
this item has an ordered
</para>
</listitem>
<listitem>
<para>
sublist
</para>
<orderedlist numeration="loweralpha" spacing="compact">
<listitem>
<para>
you can also use letters
</para>
</listitem>
<listitem>
<para>
another item
</para>
</listitem>
</orderedlist>
</listitem>
</orderedlist>
</listitem>
</programlisting>
</itemizedlist>
</td>
</tr>
<tr>
<td>
<pre>
Fruit Quantity
-------- -----------
apples 30,200
oranges 1,998
pears 42
Table: Our fruit inventory
</pre>
</td>
<td>
<table>
<programlisting>
<title>
Our fruit inventory
</title>
<tgroup cols="2">
<colspec align="left" />
<colspec align="right" />
<thead>
<row>
<entry>
Fruit
</entry>
<entry>
Quantity
</entry>
</row>
</thead>
<tbody>
<row>
<entry>
apples
</entry>
<entry>
30,200
</entry>
</row>
<row>
<entry>
oranges
</entry>
<entry>
1,998
</entry>
</row>
<row>
<entry>
pears
</entry>
<entry>
42
</entry>
</row>
</tbody>
</tgroup>
</programlisting>
</table>
</td>
</tr>
</table>
<para>
<programlisting>
For headings, prefix a line with one or more <literal>#</literal>
signs: one for a major heading, two for a subheading, three for a
subsubheading. Be sure to leave space before and after the heading.
</programlisting>
</para>
<programlisting>
</sect1>
<sect1 id="markdown">
<title>Markdown</title>
<para>
Text…
</para>
<sect2 id="some-examples">
<title>Some examples…</title>
Text…
</programlisting>
<sect2 id="wiki-links">
<title>
Wiki links
</title>
<programlisting>
<para>
Links to other wiki pages are formed this way:
<literal>[Page Name]()</literal>. (Gitit converts markdown links
with empty targets into wikilinks.)
</para>
<para>
To link to a wiki page using something else as the link text:
<literal>[something else](Page Name)</literal>.
</para>
<para>
Note that page names may contain spaces and some special
characters. They need not be CamelCase. CamelCase words are
<emphasis>not</emphasis> automatically converted to wiki links.
</para>
<para>
Wiki pages may be organized into directories. So, if you have
several pages on wine, you may wish to organize them like so:
</para>
<programlisting>
</programlisting>
Wine/Pinot Noir Wine/Burgundy Wine/Cabernet Sauvignon
</programlisting>
<programlisting>
<para>
Note that a wiki link <literal>[Burgundy]()</literal> that occurs
inside the <literal>Wine</literal> directory will link to
<literal>Wine/Burgundy</literal>, and not to
<literal>Burgundy</literal>. To link to a top-level page called
<literal>Burgundy</literal>, you'd have to use
<literal>[Burgundy](/Burgundy)</literal>.
</para>
<para>
To link to a directory listing for a subdirectory, use a trailing
slash: <literal>[Wine/]()</literal> will link to a listing of the
<literal>Wine</literal> subdirectory.
</para>
</programlisting>
<para>
</sect2> </sect1>
</para>
</sect2>
</sect1>