Text Formatting Rules
This page lists all formatting rules for text in pages. See Text Formatting Rules - Introduction if you are just beginning to edit pages.
Table of contents |
Text
Emphasis (Bold/Italic)
- Put two single-quotes '' on both sides for emphasis (''italic'' -> italic).
- Put two underscore __ on both sides for strong emphasis (__bold__ -> bold).
- These can be combined (__''bolditalic''__ -> bolditalic)
- Emphasis can be used multiple times within a line, but cannot cross line boundaries.
Paragraphs
- Extra spaces/tabs and single line breaks inside text are ignored, all the text will be considered a single paragraph.
- To make multiple paragraphs, use a blank line between them
- To make a line break at a specific point, use %%% (in headings and lists too: continue text in same line).
- Four (or more) minus signs at the start of a line make a horizontal rule.
- %%%% makes a "clear all" linebreak, forcing text below a diagram. [1]
To indent a paragraph, start the line either with
- '>' (indents everything, with a line in front of it: lists, headings, diagrams) or with
- ';:' ("mis"using definition lists).
- In order to use preformatted text or make simple tables, start lines with a space (monospace font). [2]
- ';:' ("mis"using definition lists).
Example: This is standard text
- This is level 1 indentation using ;: (semicolon-colon).
- And this is level 2 indentation ;;: (semicolon-semicolon-colon).
This is level 1 indentation using > (greater_than).
And this is level 2 indentation. > > (greater_than-greater_than)
- This is an indented list. > > * (greater_than-greater_than-asterisk)
This is preformatted text using a monospace font (each line started with a space).
Lists
- * at the start of a line for first level
- ** for second level
- *** for third level, etc
- ** for second level
- Use * for bullet and # for numbered lists (mix at will)
- ;Term: Definition for definition lists
- One line for each item
- Other leading whitespace signals preformatted text, changing font.
Headings
- '== ' at the start of a line makes a large heading.
- '=== ' at the start of a line makes a medium heading.
- '==== ' at the start of a line makes a small heading.
You can optionally end the line with the same amount of '=' (Wikipedia style).
Note: There has to be a space after the '=' at the start.
2nd note: all headings show up in the TOC (Table Of Contents) of the page.
Display Text Formatting Symbols
- To force a symbol to be displayed (instead of being interpretted as formatting), place a "!" before the symbol. To display B4 instead of
, type in !B4 in edit page.
- For displaying the square brackets ('['), use ![ for the opening bracket, or else it will be interpreted as a link (e.g. [aji] against aji ).
- "!" may not work for all symbols. In the case of multi character symbols, consider typing the formatting symbol ' or _ 4 times in between the text formatting symbols.
Eg: %%''''%% for %%%%
or %%____TOC%% for %%TOC%%
or %%_''''_''''_''''_TOC%% for %%____TOC%%
or Teacher''''Name for TeacherName
References (Links)
- Hyperlinks to other pages can be made by JoiningCapitalizedWords or by enclosing in square brackets: [Go].
- The second form is more general (single words too) and easier for readers (spaces allowed). Compare "join capitalized words" with "JoinCapitalizedWords". (See Wiki Name for complete description.)
- It is possible to give your link a different name by using square brackets and '|' (or '¦') like this: [Go Teaching Ladder | http://gtl.xmp.net/] produces
Go Teaching Ladder.
- You can suppress linking to references by preceding the word with a '!', e.g. NotLinkedAsWikiName, http://not.linked.to/.
- Also, precede URLs with "http:", "ftp:" or "mailto:" (obfuscated!) to create links automatically as in:
http://gtl.xmp.net/.
- URLs to images, ending with .png, .gif, .jpg, are inlined if put in square brackets. See HowToAddImages.
- To left- or right-align an inlined picture, see Picture Template
- To link to forum entries use the prefixes p:, posting:, t:, topic:, f:, or forum: like this: p:1 topic:1 forum:ArnoHollosi
- Links to subheaders of pages: use #tocXY at the end. Example: [ReferenceSection - Cultural pages|ReferenceSection#toc2] becomes ReferenceSection - Cultural pages. Caution: order (or amount) of headers on a page can change and then the link will point to the wrong header.
- Links to diagrams on other pages: use #diagXY at the end. Example: [Ko - diagram 3 | ko#diag3] becomes Ko - diagram 3 or use an unnamed link ko#diag3. Caution: order (or amount) of diagrams on a page can change and then the link will point to a wrong diagram.
Footnotes
- Create links to footnotes with [#1] or any other number (i.e. square brackets + hash + number), and precede the footnote itself with [1] (i.e. square brackets + number).
- In order to link to a footnote at another page, use [pagename#XY].
Subpages
- Subpages show up in the left yellow page area.
- Their name is of the form "basename / subpage".
- Links to subpages are of the form [basename / subpage].
- A subpage from the current page can be referenced by [/subpage].
- The %%Subpages%% macro will create a table of content of subpages.
Subpages have some limitations, so you must have a good reason to create a subpage, as you cannot structure content with this concept.
More specifically, they lack following:
- subpages
- own page headers
- discussion pages
Mark-Up Language (HTML)
- Don't bother.
- '<' and '>' and '&' are themselves.
- To insert special characters (HTML entities) use the numerical &#XXXX; syntax, hexadecimal &#xYYYY; syntax, or use one of the
predefined HTML entity names. Examples: &# 21163; renders as 劫, & Uuml; renders as Ü.
- Be aware that not everyone can display Unicode.
Diagrams
$$ A ko $$ . . O X . . $$ . O . O X . $$ . . O X . .
Diagram lines start with "$$ ".
The first line is the title line.
- White stone: O, marked with circle: W, marked with square: @
- Black stone: X, marked with circle; B, marked with square: #
- Empty point: ., marked with circle; C, marked with square: S
- Use a-z (lowercase) for letters, use 1-9+0 for numbered stones (>1-10, not more possible)
- In title line: $$B makes "1" a black stone, $$W makes "1" a white stone.
- -, |, + can be used as borders.
- All diagrams are also available as SGF files -- you can download them by clicking on the diagram graphic.
You can also refer to moves with images like " is good" by writing "B3 is good", and in the same way to marked stones: "WS is good" gives "
is good".
Read more about it in How Diagrams Work.
Images
Tools
Table of Contents
- Use the %%TOC%% macro to create the table of contents (as the one on the top of this very page).
- %%TOC+%% will also add a table of content of subpages (as made by %%Subpages%%).
- %%TOC-%% will omit the table of diagrams, and only show the table of contents
Navigation Box
- Subsequent lines preceded by => are displayed in a distinct right aligned box. This can be useful as a navigating aid. See the example at the right side.
- Lines preceded by =< are displayed in a left aligned box.
Prefabricated Boxes
- Prefabricated boxes are in the List of Templates
CJK-box
Box placed in the top right corner for displaying Chinese, Korean and Japanese translation of (Go-)terms.
Search box
%%Search%% will add a search box in the page
Tables
- Use the table template to add tables.
Miscellaneous
- Lines starting with a single '%' are comments / remarks and are not shown when viewing a page. This behaviour can be changed in User Preferences.
SL Writing Guidelines
You may follow some SL Conventions, but they are less important than your ideas and insights!
[1] Charles: I consistently make that eight per-cents, in order to give a good clearance below diagrams. But I don't know whether that depends on the browser in use (I have IE).
[2] Preformatted text does not wrap, so please do not enter long lines in preformatted text.
See also: