(anonymous guest) (logged out)

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

Sponsored by the Wiki Symposium and the Nuveon GmbH.

 

Add new attachment

Only authorized users are allowed to upload new attachments.

This page (revision-14) was last changed on 25-Apr-2007 16:46 by ChuckSmith  

This page was created on 29-Dec-2006 08:26 by 69.156.31.254

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.4 spec of Creole (10 Jan 2007) to be discussed until 31 Jan 2007.
This is the stable v0.4 spec of Creole (31 Jan 2007). Also see [[reasoning]] for more information about individual markup elements.
At line 4 changed one line
* wiki developers can choose whether to treat line breaks as line breaks (blog-style) or to ignore single line breaks and add code {{{ \\ }}} (wiki-style) for line breaks with a recommendation to use blog-style when possible - ([List Of Line Break Markup], see [ChangeLinebreakMarkupProposal])
* requirement to support wiki-style linebreaks {{{ \\ }}} - (see [ChangeLinebreakMarkupProposal])
At line 17 changed one line
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.
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. [[Bold and Italics Reasoning|Reasoning]]
At line 31 changed one line
A slash ({{{/}}}) looks like slanted italics, so it is intuitive and thus easier to remember.
A slash ({{{/}}}) looks like slanted italics, so it is intuitive and thus easier to remember. [[Bold and Italics Reasoning|Reasoning]]
At line 112 changed one line
__About unordered lists and bold:__ a line starting with ** (including optional whitespace before and afterwards), immediately following an unordered list element a line above, will be treated as a nested unordered list element. Otherwise it will be treated as the beginning of bold text. Also note that bold and/or italics cannot span lines in a list.
**About unordered lists and bold:** a line starting with {{{ ** }}} (including optional whitespace before and afterwards), immediately following an unordered list element a line above, will be treated as a nested unordered list element. Otherwise it will be treated as the beginning of bold text. Also note that bold and/or italics cannot span lines in a list.
At line 116 changed one line
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.
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. [[Lists Reasoning|Reasoning]]
At line 145 changed one line
The number sign ({{{#}}}) is used for ordered lists in most wikis.
The number sign ({{{#}}}) is used for ordered lists in most wikis. [[Lists Reasoning|Reasoning]]
At line 175 changed one line
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.
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. [[Headings Reasoning|Reasoning]]
At line 210 changed one line
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.
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. [[Links Reasoning|Reasoning]]
At line 246 changed one line
No markup tags should be necessary to start a new paragraph.
No markup tags should be necessary to start a new paragraph. [[Paragraphs and Line Breaks Reasoning|Reasoning]]
At line 271 changed 2 lines
anges from [Creole 0.3]:
Wiki developers can choose whether to treat line breaks as line breaks (blog-style) or to ignore single line breaks and add code {{{ \\ }}} (wiki-style) for line breaks. However, since users are generally more used to line breaks being treated as ling breaks, we recommend the blog-style line breaks.
%%commentbox
__blog-style vs. wiki-style__\\
There was a [long discussion|Talk.Change Linebreak Markup Proposal] whether to use blog-style or wiki-style (legacy-style) line breaks. We decided to change the original blog-style line break recommendation (treat linebreaks as line breaks) from [Creole 0.3] to the wiki-style linebreaks recommendation. Wikis __must__ support forced line break syntax {{{ \\ }}}.
At line 275 added 5 lines
We encourage engine developers that have already implemented the Creole 0.3 style (blog-style) line breaks not to throw away their implementation, but to add an option so that administrators can choose in which mode to run their installation. This way we hope to gain more experience with blog-style line breaks. In a blog-style line break mode, the forced line break syntax must be supported, so that line breaks will properly migrate when people copy text from a wiki with forced line break characters. [[Paragraphs and Line Breaks Reasoning|Reasoning]]
%%
{{{ \\ }}} (wiki-style) for line breaks.
At line 289 removed one line
At line 315 changed one line
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.
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. [[Preformatted and Nowiki Reasoning|Reasoning]]
At line 348 changed one line
Some examples of markup are: <tt>** &lt;i&gt;this&lt;/i&gt; **</tt>
Some examples of markup are: <tt>** <i>this</i> **</tt>
At line 357 changed one line
All non-WYSIWYG wikis use hyphens ({{{----}}}) to denote horizontal rules. Most wikis require four.
All non-WYSIWYG wikis use hyphens ({{{----}}}) to denote horizontal rules. Most wikis require four. [[Horizontal Rule Reasoning|Reasoning]]
At line 369 changed one line
The most common image markup was double curly brackets ({{{ {{}} }}}) which will then have the same internal structure as links for consistency.
The most common image markup was double curly brackets ({{{ {{}} }}}) which will then have the same internal structure as links for consistency. [[Images Reasoning|Reasoning]]
At line 380 changed one line
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.
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. [[Tables Reasoning|Reasoning]]
At line 387 changed 3 lines
|Heading Col 1 |Heading Col 2 |
|Cell 1.1 |Cell 1.2 |
|Cell 2.1 |Cell 2.2 |
|Heading Col 1 |Heading Col 2 |
|Cell 1.1 |Two lines\\in Cell 1.2 |
|Cell 2.1 |Cell 2.2 |
At line 401 changed one line
<td>Cell 1.2</td>
<td>Two lines\\in Cell 1.2</td>
At line 412 changed one line
|Cell 1.1 |Cell 1.2
|Cell 1.1 |Two lines\\in Cell 1.2
At line 417 changed one line
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.
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. [[Placeholder Reasoning|Reasoning]]
Version Date Modified Size Author Changes ... Change note
14 25-Apr-2007 16:46 12.927 kB ChuckSmith to previous fixed Creole rendering problem in Lists
13 31-Jan-2007 17:14 12.931 kB ChuckSmith to previous | to last added individual markup reasoning links
12 31-Jan-2007 11:24 12.359 kB ChuckSmith to previous | to last final -> stable
11 31-Jan-2007 11:24 12.358 kB ChuckSmith to previous | to last final spec
10 30-Jan-2007 10:44 12.395 kB ChuckSmith to previous | to last typos, added line break in table example
9 27-Jan-2007 11:20 12.319 kB ChristophSauer to previous | to last changed linebreak specification to "require \\", added comments
8 24-Jan-2007 13:01 11.896 kB ChuckSmith to previous | to last line breaks up to implementer - discussion extended to 31 Jan
7 20-Jan-2007 16:43 11.412 kB PatrickMichaud to previous | to last linebreaks no longer produce
6 20-Jan-2007 16:32 11.418 kB PatrickMichaud to previous | to last headers -> headings
5 16-Jan-2007 10:33 11.416 kB Christoph to previous | to last
4 11-Jan-2007 13:46 11.379 kB ChuckSmith to previous | to last line breaks in table cells
3 10-Jan-2007 17:17 11.329 kB ChuckSmith to previous | to last new spec, discussed til 24 Jan 2007
2 29-Dec-2006 08:12 0.002 kB 69.156.31.254 to previous | to last
1 29-Dec-2006 08:26 0.295 kB 69.156.31.254 to last
« This page (revision-14) was last changed on 25-Apr-2007 16:46 by ChuckSmith