(anonymous guest) (logged out)

Copyright (C) by the contributors. Some rights reserved, license BY-SA.

Sponsored by the Wiki Symposium and the Nuveon GmbH.

 
View Attach Info

Add new attachment

Only authorized users are allowed to upload new attachments.

This page (revision-22) was last changed on 13-Oct-2008 13:51 by ChristophSauer  

This page was created on 01-Dec-2006 15:07 by ChuckSmith

Only authorized users are allowed to rename pages.

Only authorized users are allowed to delete pages.

Difference between version and

At line 1 changed one line
This is the proposed v0.3 spec of Creole (1 Dec 2006) which will be discussed until 15 Dec 2006. Also see: [Creole 0.2].
This is the stable v0.3 spec of Creole (19 Dec 2006).
At line 4 changed one line
* [Tables|Creole0.3#Tables]
* [Tables|Creole0.3#Tables] - all cells separated by single pipes
* Removed rule: "Links should not be allowed to contain a linebreak."
* Added summary of reasoning for markup elements in comment boxes.
At line 16 added 4 lines
%%commentbox
A star ({{{*}}}) is the most used symbol to emphasize text online. Double symbols are generally used in Creole to avoid accidentally parsing text not meant to be parsed.
%%
At line 30 added 4 lines
%%commentbox
A slash ({{{/}}}) looks like slanted italics, so it is intuitive and thus easier to remember.
%%
At line 115 added 3 lines
%%commentbox
A large majority of wiki engines use an asterisk ({{{*}}}) to denote bullet lists. The multiple asterisk approach for sublists was the first wiki syntax for sublists. Users do not need to count leading spaces like in markups where a sublist level is determined by the number of its leading spaces.
%%
At line 144 added 4 lines
%%commentbox
The number sign ({{{#}}}) is used for ordered lists in most wikis.
%%
At line 172 added one line
At line 156 changed one line
Only three different sized levels of headings are required. Closing (right-side) equal signs are optional. If both left side and right side equal signs exist, the left side takes precedence. Whitespace is not allowed before the left-side equal signs. Only whitespace characters are permitted after the closing equal signs. No linebreaks are allowed within headings (this includes logical linebreaks made by using a backslash at the end of a line, for example). Bold, italics, links and preformatted text are allowed in headings.
%%commentbox
Using equal signs ({{{=}}}) is the most popular wiki header markup. Since there are more equal signs for smaller headers, subheaders will become more indented making it easier to get a visual overview from the markup alone. Closing equal signs are optional, making Creole more flexible since many wiki engines do not require them.
%%
At line 178 added 2 lines
Only three different sized levels of headings are required. Closing (right-side) equal signs are optional. If both left side and right side equal signs exist, the left side takes precedence. Whitespace is not allowed before the left-side equal signs. Only whitespace characters are permitted after the closing equal signs. No linebreaks are allowed within headings (this includes logical linebreaks made by using a backslash at the end of a line, for example). Bold, italics, links and preformatted text are not allowed in headings.
At line 181 changed one line
<h3><strong>not</strong> <em>parsed</em></h3>
<h3>**not** //parsed//</h3>
At line 184 changed 2 lines
!!Internal and External Links
Links should not be allowed to contain a linebreak. Any markup except for images within a link will __''not''__ be parsed.
!!Links - Internal and External
%%commentbox
Almost all wikis use square brackets ({{{[[]]}}}) to make links. Using double square brackets allows single square brackets to be used freely without worry of turning them into links.
%%
At line 211 added 2 lines
Any markup except for images within a link will __''not''__ be parsed.
At line 243 added 4 lines
%%commentbox
No markup tags should be necessary to start a new paragraph.
%%
At line 238 changed one line
!!Linebreaks
!!Line breaks
%%commentbox
Non-technical users generally expect that putting a line break in wiki text will cause it to become a line break in the output.
%%
At line 318 added 4 lines
%%commentbox
There must be a way for users to enter text which will not be formatted by the wiki engine. Triple curly brackets ({{{{{{~}}}}}}) were chosen due to their visibility and unlikeliness to be in the "code" itself.
%%
At line 360 added 4 lines
%%commentbox
All non-WYSIWYG wikis use hyphens ({{{----}}}) to denote horizontal rules. Most wikis require four.
%%
At line 372 added 3 lines
%%commentbox
The most common image markup was double curly brackets ({{{ {{}} }}}) which will then have the same internal structure as links for consistency.
%%
At line 337 removed 6 lines
!!Placeholder
When there is something advanced, a placeholder will show up, so users will not be confused seeing more than one syntax. (optional for wiki developers)
Creole:
{{{ <<x>> }}}
At line 344 changed one line
Header cells will be separated by double pipes and ordinary cells by single pipes. The ending pipe(s) are optional. Comparison details found on [List Of Table Markups]
%%commentbox
Most wikis use single or double pipes to separate table cells. Single pipes ({{{|}}}) allow better use of space and are faster to type than double pipes since pipes are not usually needed in table cells.
%%
At line 387 added 2 lines
All cells are separated by single pipes. The ending pipe is optional. You can embed links, bold, italics, and monospace in table cells. Comparison details found on [List Of Table Markups]
At line 348 changed one line
||Heading Col 1 ||Heading Col 2|
|Heading Col 1 |Heading Col 2 |
At line 357 changed 2 lines
<th>Heading Col 1</th>
<th>Heading Col 2</th>
<td>Heading Col 1</td>
<td>Heading Col 2</td>
At line 372 changed one line
||Heading Col 1 ||Heading Col 2
|Heading Col 1 |Heading Col 2
At line 419 added 11 lines
!!Placeholder
%%commentbox
This is the only new markup introduced in Creole. Few wikis use angle brackets ({{{<<>>}}}) for markup and it is easy to type on most international keyboards. This was mainly developed due to MediaWiki's extensive use of special characters making it practically impossible to implement Mixed Creole mode.
%%
When there is something advanced, a placeholder will show up, so users will not be confused seeing more than one syntax. (optional for wiki developers)
Creole:
{{{ <<x>> }}}
Version Date Modified Size Author Changes ... Change note
22 13-Oct-2008 13:51 11.724 kB ChristophSauer to previous restore
21 24-Sep-2008 02:50 0.054 kB 80.86.200.172 to previous | to last great site thanks http://allfullsoftgoogle.com see u
« This page (revision-22) was last changed on 13-Okt-2008 13:51 by ChristophSauer