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 63 changed one line |
!!Monospace |
== Indented paragraphs |
At line 65 changed one line |
For those wiki engines which wish to support monospace, we recommend the following syntax. |
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. |
At line 67 changed one line |
{{{ This is ##monospace## text. }}} |
{{{ |
This is a normal paragraph. |
:This is an indented |
paragraph in two lines. |
::This is more indented. |
}}} |
At line 69 changed one line |
Recommended XHTML: {{{ This is <tt>monospace</tt> text. }}} |
or |
At line 71 changed one line |
Output: This is {{{monospace}}} text. |
{{{ |
This is a normal paragraph. |
> This is an indented |
paragraph in two lines. |
>> This is more indented. |
}}} |
At line 73 changed 2 lines |
Comparison: |
http://www.wikimatrix.org/syntax.php?i=28 |
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> |
}}} |