| 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 5 changed one line |
| !!Superscript |
| == Plug-in/Extension |
| At line 9 added 23 lines |
| For those wiki engines which wish to support plug-ins, we recommend double angle brackets: |
|
| {{{ <<CurrentTimePlugin format='yyyy.MM.dd'>> }}} |
|
| Output: [{CurrentTimePlugin format='yyyy.MM.dd'}] |
|
| see [[GenericExtensionElementProposal]] and [[HintsOnExtending]] |
|
| == Monospace |
|
| For those wiki engines which wish to support monospace, we recommend the following syntax. |
|
| {{{ This is ##monospace## text. }}} |
|
| Recommended XHTML: {{{ This is <tt>monospace</tt> text. }}} |
|
| Output: This is {{{monospace}}} text. |
|
| Comparison: |
| http://www.wikimatrix.org/syntax.php?i=26 |
|
| == Superscript |
|
| At line 18 changed one line |
| !!Subscript |
| see also [[SuperscriptAndSubscriptProposal]] |
| At line 20 changed one line |
| For those wiki engines which wish to support subscript, we recommend the following syntax. (We need to discuss which is better.) |
| == Subscript |
| At line 22 changed 2 lines |
| {{{ This is ~~subscripted~~ text. }}} |
| or |
| For those wiki engines which wish to support subscript, we recommend the following syntax. |
|
| At line 33 changed one line |
| !!Underline |
| see also [[SuperscriptAndSubscriptProposal]] |
| At line 60 added 2 lines |
| == Underline |
|
| At line 43 changed one line |
| !!Alternate Link Syntax |
| Using u is not a very good idea. See the reason at section Monospace. |
| At line 72 added 8 lines |
| 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. |
|
| == Alternate Link Syntax |
|
| At line 55 changed one line |
| <a href="http://www.examplewiki.com/TextFormattingRules">the -> can be used to make a link</a> |
| <a href="http://www.examplewiki.com/TextFormattingRules">the -> can be used to make a link</a> |
| 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> |
| }}} |