At line 1 changed 2 lines |
%%commentbox |
Here is a first draft of a v0.1 spec of Creole. I would still personally prefer asterisks for bullet lists, but dashes were agreed upon at [Wikisym 06]. In v0.2, I would also like to have a syntax for images, lists with sublevels and possibly tables. I would like to make this live and static by Friday. Please comment on the Discussion page. |
This is the final v0.1 spec of Creole (11 Sep 2006). Also see: [Creole 0.2]. |
At line 4 removed 8 lines |
Possible additions/changes in v0.2: |
* image links |
* links to image |
* changing unordered list to asterisk |
* tables |
--[ChuckSmith] |
%% |
|
At line 17 changed one line |
Bold and Italics should be able to embed in lists and one should be able to make links bold and italic. Text should not be bold or italic across paragraphs. |
Bold and Italics should be able to embed in lists and one should be able to make links bold and italic. Bold and/or italics __can__ span lines, but __not__ span across lines in lists __nor__ across different paragraphs. |
At line 56 changed one line |
Bold and italics should <em>be</br> |
Bold and italics should <em>be<br /> |
At line 67 added 29 lines |
!Bold Italics |
Creole: |
{{{ |
**//bold italics//** |
//**bold italics**// |
//This is **also** good.// |
}}} |
|
Recommended XHTML: |
{{{ |
<strong><em>bold italics</em></strong> |
<em><strong>bold italics</strong></em> |
<em>This is <strong>also</strong> good.</em> |
}}} |
|
Sample Output: |
|
__''Bold italics''__\\ |
''__Bold italics__''\\ |
''This is __also__ good'' |
|
---- |
|
Unacceptable: |
{{{ |
**//bold italics**// |
//**bold italics//** |
}}} |
|
At line 77 changed one line |
Bold, italics, links, pre can be embedded in lists. Whitespace is optional before and after the - or # character. It is recommended to have support for a depth of at least five levels. |
Bold, italics, links, pre can be embedded in lists. Whitespace is optional before and after the * or # character, however a space is required afterwards if someone wishes to start a list element with bold text. A list element ends at the end of a line. It is recommended to have support for a depth of at least five levels. |
At line 99 added 2 lines |
__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 83 changed 3 lines |
- Item 1 |
-- Item 1.1 |
- Item 2 |
* Item 1 |
** Item 1.1 |
* Item 2 |
At line 105 removed 2 lines |
---- |
|
At line 132 removed 39 lines |
---- |
|
!Mixed Lists |
Creole: |
{{{ |
* Item A |
## Item A.1 |
## Item A.2 |
* Item B |
}}} |
|
or |
|
{{{ |
* Item A |
*# Item A.1 |
*# Item A.2 |
* Item B |
}}} |
|
Recommended XHTML: |
{{{ |
<ul> |
<li>Item A |
<ol> |
<li>Item A.1</li> |
<li>Item A.2</li> |
</ol> |
</li> |
<li>Item B</li> |
</ul> |
}}} |
|
Sample Output: |
* Item A |
## Item A.1 |
## Item A.2 |
* Item B |
|
At line 172 changed one line |
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. No markup within a heading will be parsed. |
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. |
At line 197 changed one line |
<h3>**not** //parsed//</h3> |
<h3><strong>not</strong> <em>parsed</em></h3> |
At line 201 changed one line |
Links should not be allowed to contain a linebreak. |
Links should not be allowed to contain a linebreak. Any markup within a link will __''not''__ be parsed. |
At line 208 changed one line |
[[http://www.wikicreole.org/ | Visit the WikiCreole website]] |
http://www.rawlink.org/ |
[[http://www.wikicreole.org/|Visit the WikiCreole website]] |
[[Weird Stuff|**Weird** //Stuff//]] |
At line 199 added one line |
<a href="http://www.rawlink.org/">http://www.rawlink.org/</a> |
At line 201 added one line |
<a href="http://www.examplewiki.com/Weird_Stuff">**Weird** //Stuff//</a> |
At line 219 changed one line |
Sample Output:\\ |
Sample Output: |
|
At line 223 changed one line |
[Visit the WikiCreole website|http://www.wikicreole.org/] |
[http://www.rawlink.org/]\\ |
[Visit the WikiCreole website|http://www.wikicreole.org/]\\ |
[**Weird** //Stuff//|Weird_Stuff] |
At line 242 changed one line |
Sample Output:\\ |
Sample Output: |
At line 259 changed one line |
This is the first line.<br/> |
This is the first line.<br /> |
At line 264 changed one line |
Sample Output:\\ |
Sample Output: |
|
At line 257 added 23 lines |
---- |
|
Creole: |
{{{ |
* This is a single list item |
followed by a paragraph? |
}}} |
|
Recommended XHTML: |
{{{ |
<ul> |
<li>This is a single list item</li> |
</ul> |
<p> |
followed by a paragraph |
</p> |
}}} |
|
Sample Output: |
|
* This is a single list item |
followed by a paragraph |
|
At line 269 changed one line |
This works in-line or as a block. __No wiki markup is interpreted between these characters.__ (triple curly brackets should have no spaces between them) |
This works in-line or as a block. __No wiki markup is interpreted between these characters and all characters become monospace.__ As a block, the three curly braces should be on one line by itself to open and another line of three curly braces should be on a line by itself to close. |
At line 273 changed one line |
{{{ //This// does **not** get [[formatted]] ~}}} |
{{{ |
//This// does **not** get [[formatted]] |
~}}} |
At line 302 added 16 lines |
---- |
|
Creole: |
{{{ |
Some examples of markup are: {{{** <i>this</i> ** ~}}} |
}}} |
|
Recommended XHTML: |
{{{ |
Some examples of markup are: <tt>** <i>this</i> **</tt> |
}}} |
|
Sample output: |
|
Some examples of markup are: {{{** <i>this</i> **}}} |
|
At line 294 changed one line |
{{{ <hr> }}} |
{{{ <hr /> }}} |
At line 301 changed 2 lines |
XHTML: |
{{{ <img src="myimage.png"> }}} |
Recommended XHTML: |
{{{ <img src="myimage.png" /> }}} |
At line 310 removed 2 lines |
Conflicts with OLPC image tag. |
|
At line 313 removed 3 lines |
!!Bold Italics |
Creole: |
{{{ **//bold italics//** }}} |
At line 317 removed 23 lines |
Recommended XHTML: |
{{{ <strong><em>bold italics</em></strong> }}} |
|
Sample Output: |
__''Bold italics''__ |
|
---- |
|
Creole: |
{{{ //**bold italics**// }}} |
|
Recommended XHTML: |
{{{ <em><strong>bold italics</strong></em> }}} |
|
Sample Output: |
''__Bold Italics__'' |
|
Unacceptable: |
{{{ |
**//bold italics**// |
//**bold italics//** |
}}} |
|
At line 363 changed 2 lines |
- **bold** item |
- //italic// item |
* **bold** item |
* //italic// item |