![[Welcome to Sensei's Library!]](../../images/stone-hello.png)
StartingPoints
ReferenceSection
About
Paths UsingAndContribut...
Referenced by HowToUseWiki WikiNews AddingPages WikiName RGGFAQFormatGuide... SLConventionsDisc... SLConventions MetaDiscussion2002
|
Text Formatting Rules
Path: UsingAndContributingToSenseiSLibrary
· Prev: WikiEtiquette · Next: AboutPageHeaders
Keywords: SL description
Paragraphs
- Don't indent paragraphs.
- Words wrap and fill as needed.
- Use blank lines as separators.
- Four or more minus signs make a horizontal rule.
- %%% makes a linebreak (in headings and lists too).
- %%%% makes a "clear=all" linebreak, forcing text below a diagram.
- Indent with one or more spaces to use preformated text (monospace font):
This is preformatted text using a monospace font.
This is not.
Lists
- * at the start of a line for first level
- ** for second level, etc.
- Use * for bullet lists, # for numbered lists (mix at will)
- ;Term:def Definition for definition lists
- One line for each item
- Other leading whitespace signals preformatted text, changes font.
Headings
- '!' at the start of a line makes a small heading.
- '!!' at the start of a line makes a medium heading.
- '!!!' at the start of a line makes a large heading.
Emphasis
- Use doubled single-quotes ('') for emphasis (italics).
- Use doubled underscore (__) for strong emphasis (bold).
- Emphasis can be used multiple times within a line, but cannot cross line boundaries.
References (Links)
- Hyperlinks to other pages can be made by JoinCapitalizedWords - a single word can be used by enclosing it in square brackets: [Go].
- It is easier for readers if you use an alternative way to write hyperlinks: put them into square brackets - you can then use space to separate the words, e.g. [join capitalized words] is the same as JoinCapitalizedWords (see Wiki Name for complete description).
- 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:" to create links automatically as in:
http://gtl.jeudego.org/.
- URLs ending with .png,.gif,.jpg are inlined if put in square brackets.
- It is possible to give your link a different name by using square brackets and '|' like this: [Go Teaching Ladder|http://gtl.jeudego.org/] produces:
Go Teaching Ladder.
- 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).
Mark-Up Language (HTML)
- Don't bother.
- < and > and & are themselves.
Diagrams
![[Diagram]](../../diagrams/52/9ed9b4e9c1e6c2ebf0a4f902f3a7c21e.png) | Diag.: A ko |
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 for numbers on stones.
- 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 these by clicking on the diagram graphic.
Read more about it in How Diagrams Work.
Guided Tours aka Paths
How Paths Work explains the [<SomePageName] construction.
SL Writing Guidelines
You may follow some SL Conventions but they are less important
than your ideas and insights.
Discussion
Please do not use lines with length greater than 80, it makes the ``diff'' unreadable in the Recent Changes.
That is not always possible. E.g. list items have to be in one line. I have added a quick hack that tries to underline small changes in long lines (e.g. correction of a typo). It works quite well. I hope that solves the problem sufficiently. -- Arno Hollosi
We have dropped off the instruction for using "semicolon-colon" to create indented blocks of text. Was this intentional or accidental? It still works and is a better way to insert comments in the midst of someone else's text. People tend to use prefomatted text to do this but the problem there is that preformatted doesn't wrap automatically so the page becomes too wide for the browser window.
-- Dave Sigaty
Actually, the semicolon, colon creates a definitionlist (<DL>). You can put the term to be defined between the colon and the semicolon, or leave it out, thusly:
- Aardvark
- Often mistakenly quoted to be the first word in english dictionaries
- Definition of a term without the term :-)
Having said that, it may well be that the use of 'empty' definitions is the best way to make comments. Like you point out, monospaced (first char = space) doesn't do linebreaks, and using italics or bold isn't always appropriate. Let's try it and see how it goes.
-- Morten Pahle
Path: UsingAndContributingToSenseiSLibrary
· Prev: WikiEtiquette · Next: AboutPageHeaders
This is a copy of the living page
"Text Formatting Rules" at
Sensei's Library.
2003 the Authors, published under the OpenContent License V1.0.
|