| At line 1 changed one line |
| This page is in no way yet official. This is somewhat a sandbox for starting work on a Creole Additions page. This would have optional markup that wiki developers can choose whether they wish to implement or not. |
| This page is in no way yet official. This has optional markup that wiki developers can choose whether they wish to implement or not. |
| At line 3 added 2 lines |
| //Please discuss the features below or new proposals on [[Talk.Creole Additions]] first!// |
|
| At line 7 changed one line |
| For those wiki engines which wish to support plug-ins, we recommend three double angle brackets: |
| For those wiki engines which wish to support plug-ins, we recommend double angle brackets: |
| At line 26 changed one line |
| http://www.wikimatrix.org/syntax.php?i=28 |
| http://www.wikimatrix.org/syntax.php?i=26 |
| At line 28 removed 62 lines |
| {{{ |
| =Heading |
| ~=Line starting with equal sign, this displays a normal tilde: ~ |
| }}} |
|
| If an escape character is only used in certain combinations we have a minimum of collisions with existing markup. For example if an wiki uses tilde as normal markup, it would not collide with e.g. |
|
| {{{ |
| ~=This is a heading |
| ~this is subscript in certain wikis~ |
| ~~=This is a sentence with a tilde and an equal sign at the beginning... (tilde escapes itself) |
| }}} |
|
| Here's a complete list that would cause the escape character (e.g. tilde) to trigger escaping of the following character combinations. This can be extended as need be. Note also that an escape character can be escaped by putting a space after it, since a space cannot be escaped. |
|
| {{{ |
| Escapes Markup Combination Constraint Example: |
| ============== ========================== ========= |
| Bold Anywhere ~** |
| Italics Anywhere ~// |
| Unordered Lists Hyphen, first chars in line ~- |
| Ordered Lists First chars in line ~# |
| Headings Equal signs, first chars in line ~= |
| Links Open Anywhere ~[[ |
| Inside Links Within Links [[A pipe ~| is used within links]] |
| Links Close Anywhere ~]] |
| Line Breaks Anywhere ~\\ |
| Horizontal Line First chars in line ~---- |
| Image Open Anywhere ~{{ |
| Image Close Anywhere ~}} |
| Table Open First chars in line ~| this is | not a table |
| Inside Tables Pipe used within a table cell | x~|y | |
| Escaping Escape Anywhere ~~ |
| Escaping Escape Anywhere ~<space> |
| Nowiki Open First chars in line ~{{{ |
| Nowiki Close First chars in line ~~}}} |
| }}} |
|
| So, for example, this markup: |
|
| {{{ |
| {{{ |
| int main(int argc, char *argv[]) { |
| if argc>0 { |
| if argc<=1 { |
| --argc; |
| ~~}}} |
| ~}}} |
| }}} |
|
| will produce this result: |
|
| {{{ |
| <pre> |
| int main(int argc, char *argv[]) { |
| if argc>0 { |
| if argc<=1 { |
| --argc; |
| ~}}} |
| </pre> |
| }}} |
|
| At line 43 added 2 lines |
| see also [[SuperscriptAndSubscriptProposal]] |
|
| At line 105 changed one line |
| For those wiki engines which wish to support subscript, we recommend the following syntax. (We need to discuss which is better.) |
| For those wiki engines which wish to support subscript, we recommend the following syntax. |
| At line 107 removed 2 lines |
| {{{ This is ~~subscripted~~ text. }}} |
| or |
| At line 58 added 2 lines |
| see also [[SuperscriptAndSubscriptProposal]] |
|
| At line 70 added 8 lines |
| Using u is not a very good idea. See the reason at section Monospace. |
|
| Usually underline is used to emphasis words. For that we can use ~* or ~**. In some case, we can customize it via css. For example, in Chinese, underline means the word is a name (people name, place, etc) just as first-character-Caps in English. For those wikis, we can produce this XHTML, |
|
| {{{ This is <span class="name">underlined</span>. }}} |
|
| We may set the class name as a variable in wiki engine, so wiki admins can write customize the class name to fit their needs in a config file/page. |
|
| At line 97 added 63 lines |
|
| == Indented paragraphs |
|
| Indented paragraphs are paragraphs which begin with a colon or {{{>}}} sign. The |
| colon must be the first character of the line. Multiple colons define |
| the level of indenting. Indented paragraphs can contain styled text, |
| links, spans of verbatim text, and inline extensions. |
|
| {{{ |
| This is a normal paragraph. |
| :This is an indented |
| paragraph in two lines. |
| ::This is more indented. |
| }}} |
|
| or |
|
| {{{ |
| This is a normal paragraph. |
| > This is an indented |
| paragraph in two lines. |
| >> This is more indented. |
| }}} |
|
| Possible XHTML (separate stylesheets or {{{<dl><dd></dd></dl>}}} also possible): |
|
| At least MediaWiki and Oddmuse are using dl with empty or no dt to indent text. This is simple, but it's a wrong use of definition list. |
|
| {{{ |
| <p>This is a normal paragraph.</p> |
| <div style="margin-left:2em"> |
| <p>This is an indented paragraph in two lines.</p> |
| <div style="margin-left:2em"> |
| <p>This is more indented.</p> |
| </div> |
| </div> |
| }}} |
|
| == Definition lists |
|
| Definition lists are made of two kinds of items: |
| title, typically displayed in bold font, and definition, typically |
| displayed indented. Titles begin with a semicolon at the beginning of |
| a line. Definitions either follow the title, separated with a colon; |
| or they begin on a new line beginning with a colon. |
|
| {{{ |
| ; First title of definition list |
| : Definition of first item. |
| ; Second title: Second definition |
| beginning on the same line. |
| }}} |
|
| Recommended XHTML: |
|
| {{{ |
| <dl> |
| <dt>First title of definition list</dt> |
| <dd>Definition of first item.</dd> |
| <dt>Second title</dt> |
| <dd>Second definition beginning on the same line.</dd> |
| </dl> |
| }}} |
.