Basic Styles
Be aware that a lot of the following styles (for example, the header styles) are customisable by changing CSS rules within your own templates.
| Underlining | __text__ | text |
| Bold | **text** | text |
| Italic | //text// | text |
| Superscript | super^^script^^ | superscript |
| Subscript | sub~~script~~ | subscript |
| Strikethrough | --text-- | text |
| Small header | !Header Text | Header Text |
| Medium header | !!Header Text | Header Text |
| Large header | !!!Header Text | Header Text |
| Preformatted section | {{
text
}} | text |
| Code | {{some text}} | some text |
| Link to page | [PageName] | PageName |
| Link to page with alternative label | [PageName|link label] | link label |
| Link with image | [PageName|@filename.jpg] |  |
| Embed an uploaded image | [@filename.jpg] | |
| Thumbnail an uploaded image | [@filename.jpg:100x100] |  |
| Thumbnail with border | [@filename.jpg:100x100b5] |  |
| Horizontal rule (on a line) | ---- |
|
Lists
You can create an unordered list by preprending each line with a single hyphen or multiple hyphens to create nested lists.
- item one
- item two
-- sub item
Creates:
Ordered lists are created by prepending lines with hashes:
# item one
# item two
## sub item
Creates:
- item one
- item two
- sub item
Text Alignment
Center alignment is achieved by surrounding a section with lines containing '><':
><
__Hello World__
><
Aligning text to the right is similarly achieved with the '>>' tag:
>>
__Hello World__
>>
Image Alignment
When you place an image using the [@image] tag, you can align the image to the left or to the right causing the text to flow down either the left of right side of the image. For example:
[@<imagename.jpg]
[@>imagename.jpg]
The first tag aligns the image to the left and the second aligns the image to the right.
Centering the image left-to-right is also possible.
[@|imagename.jpg]
Making a table|| Header Text || Another Header ||
| contents of cell one | cell two |
| another cell | __some more text__ |
|>< center aligned |>> right aligned |
The first vertical bar must be the first character on each line. It is not important for the other vertical bars | to be aligned with each other. You can have header-style rows in several places if you want to. You can use formatting tags and links within cells.
Here is the resulting table:
| contents of cell one | cell two |
| another cell | some more text |
| center aligned | right aligned |
You can also place a + sign at the end of the first table row to indicate the the table should be made to be full width (100%):
|| Header Text || Another Header ||+
...
Row span and column spans may also be specifed at the start of a cell. The format is '+c.r' where 'c' is the number of columns and 'r' is the number of rows. If 'r' is omitted, the '.' must also be omitted.
||+2.2>< test +2.2>< ||>> just >>|| hello ||
|+2 '+2' |
| x | y | z |
|=+1.2 '=+1.2' works? | yet more |
|and more|
Which renders as:
| '+2' |
| x | y | z |
| yet more |
| and more |
The '=' at the begining of the first cell in the fourth row says to treat that cell as if it was on a header row.
Using PHP Within Pages
This is now possible using the delimiters [:PHP] and [/PHP] on their own lines. For example:
[:PHP]
echo 'hello world';
[/PHP]
<?php ... ?> is recognized as a deprecated synonym
Escaping Formatting
The [:Raw] directive allows you to place unmodifed text in the output. This is useful for placing html or css or javascript fragments in the web page. No formatting sequences are honored and no line breaks are generated:
[:Raw]
<table>
<tr><td>a raw html table<td><tr>
</table>
[/Raw]
Create An Image Gallery
To create an image gallery you need to upload the full-sized photos. The following two examples assume that you have uploaded the images to page on which you will be placing the gallery of thumbnails. A later example shows how to reference images uploaded on a different page. and add a block of ':Gallery' markup to your page where you want the thumbnails to be displayed. A simple gallery:
[:Gallery]
image1.jpg Caption for image 1
image2.jpg Caption for image 2
image3.jpg Caption for image 3
image4.jpg Caption for image 4
image5.jpg Caption for image 5
image6.jpg Caption for image 6
[/Gallery]
The example above will display six thumbnails in a table. Each thumbnail will link to a page displaying the full-sized image. The default table dimensions, thumbnail size and other settings may not be suitable. You can customise your gallery by adding some parameters to the opening [:Gallery] tag. Here is an example:
[:Gallery size:120x120b4 columns:3 bigsize:400x1000]
This will create a gallery of thumbnails at most 120 pixels wide and 120 pixels high and with a 4 pixel border. The thumbnail table will be three columns wide. The size of the enlarged images will be at most 400 pixels wide and 1000 pixels high.
You can also use pictures uploaded on another page by specifying a 'page' parameter:
[:Gallery size:100x100 columns:3 page:MyPhotoPage]
Gunther will then look for the images listed as uploads on page 'MyPhotoPage'.
You can also choose which template to use when displaying full-sized images:
[:Gallery size:100x100 columns:3 template:TemplateName]
[Gallery] (without the colon) is recognized as a deprecated synonym.
|
