ARCHES Wiki Guide: Markup#

Filenaming#

See Creating a page section.

Editing Pages#

By default all users are set to use the plain editor for wiki page markup. This is a simple plain text editor. All markup is visible and display formatting can be seen in the preview window below the editor. Once in the editor you will be able to see a toolbar at the top which includes buttons for the common markup elements. A number of standardised tags along with details of where to use them are also detailed on this page (below). The editor toolbar allows the formatting to be applied a la Word (select text and click formatting option) or it can be written by hand.

Page headings#

Text - blocks and paragraphs#

• Inset block (simple paragraphs) - use Definition Block (;term:def) without a term.
• Bulleted list within a Definition block use:

%%(margin-left:3em;)
YOUR TEXT HERE
%%

• Inset block (large complex text w/ backround colour and border) - use:

%%( background-color: #ddd; border: 1px dotted black; padding: 1em; )
YOUR TEXT HERE
%%

• Centre text (some figure/table captions etc.):

%%center
your text here
/%

Text - fonts, style, etc.#

• There is no underlined text (easy to confuse with links).
• Use unicode to insert special characters e.g. the degree symbol (°) is U+00B0 (unicode) so would be inserted in wikimarkup as:

°

Images/Figures#

More info here: http://www.jspwiki.org/wiki/Image

• In order to display images on pages it is necessary to attach/upload the relevant file. Images should be attached to the page in which they are displayed. Images can be uploaded to one page and linked to from another, just add in the page name to the link address e.g. src='Main/pic1.jpg'
• It is helpful if images are given a relevant to the image content or page they are included in
• Images should be no wider than 796px
• example:

[{Image src='gis_1-1_fig01.gif' align='center' alt='2d'}]
%%center
__Figure 1__: Two-dimensional engineering-style drawing...
%%
\\
\\

Linked image (e.g. to a larger version):

[{Image src='oldcad_fig03_thumb.gif' align='center' link='http://guides.archaeologydataservice.ac.uk/attach/OldCad_2-4/oldcad_fig03.gif' alt='a picture'}]
%%center
__Figure 3__: Part of a plan of a ditch context at Deansway (© Worcestershire Archaeological Service)  (''Click for larger image'')
%%
\\
\\

Tables#

The JSPwiki http://www.jspwiki.org/wiki/TablePlugin has been included to allow the use of complex tables (with colspan and rowspan etc)

Example:

   |Nr |A |< |C |<
   |#  |a |b |c |(background:yellow;)d
   |#  |^ |b |^ |(background:yellow;)d

  +----+-------+-------+
  | Nr | A     | C     |
  +----+---+---+---+---+
  | 1  | a | b | c | d |
  +----+   +---+   +---+
  | 2  |   | b |   | d |
  +----+---+---+---+---+

Comments / Notes / Warnings#

Use %%commentbox ... /% for a rhs comment box e.g.

Glitches to note#

• double-clicking to highlight a word will include the trailing space (unless follwed by punctuation).
• JSPwiki uses CamelCase i.e. anything in square brackets is automatically identified as a link. If you really need to use square blackets then you can escape camelcase by using a tilde ~ before the first square bracket (and if you need a tilde then just double up).

Advanced stuff#

• CSS inline styles http://www.jspwiki.org/wiki/JSPWikiStyles