Personal tools
You are here: Home Software Preservation Wiki Editing Conventions
Views

Wiki Editing Conventions

Zwiki uses a format called reStructured Text. It is simpler than HTML, and assumes most of the text is simply to be formatted into paragraphs. Simple, but not completely general, conventions are used for fonts, wiki links, and external links (URLs?). Simple formatting is used for paragraphs, titles, and sections. The goal is to make it easy to do most common things.

Paragraphs and sections

Consecutive lines that start all the way to the left are filled and wrapped until a blank line is encountered. The blank line ends the paragraph.

----

is a horizontal line.


In subsequent examples, the source text in the box is followed by what it looks like. The examples are separated by horizontal lines.

Lines are
run together and wrapped into paragraphs. 
The process continues unless they are separated by blank lines.

A blank line splits text into another paragraph.

Lines are run together and wrapped into paragraphs. The process continues unless they are separated by blank lines.

A blank line splits text into another paragraph.


The title and subtitles are indicated by a line of text with a line of formatting characters above and below.

====
Page title or subtitle
====

becomes

Page title or subtitle

The page title is used once at the top of the page. The same formatting later in the page is a subtitle. The title is formatted as <h1>, the subtitles as <h2>

Section headings are indicated by lines of text followed by lines containing format characters. Four or more of the characters are needed. The headings form a hierarchy using the HTML tags <h3> to <h5>, with the style sheets defined by Plone and Zwiki.

The reStructured text processor checks that you are consistent in the levels, and doesn't allow you to skip levels. The following are the recommended levels.

Sections headings are created by a line of text followed by a line of four formatting characters. There are three levels of section headings, using equals ====, minus ----, and tilde ~~~~.

Section Heading
----

becomes

Section Heading

This is HTML <h3> format.

Subsection Heading
====

becomes

Subsection Heading

This is HTML <h4>

Subsubsection Heading
~~~~

becomes

Subsubsection Heading

This is HTML <h5>


« March 2024 »
Su Mo Tu We Th Fr Sa
1 2
3 4 5 6 7 8 9
10 11 12 13 14 15 16
17 18 19 20 21 22 23
24 25 26 27 28 29 30
31
 

Powered by Plone CMS, the Open Source Content Management System

This site conforms to the following standards: