(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-68) was last changed on 26-Sep-2008 22:52 by 134.65.2.117  

This page was created on 20-Feb-2007 12:32 by ChuckSmith

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
1...
This page is in no way yet official. This has optional markup that wiki developers can choose whether they wish to implement or not.
//Please discuss the features below or new proposals on [[Talk.Creole Additions]] first!//
[{TableOfContents title='Overview'}]
== Plug-in/Extension
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
For those wiki engines which wish to support superscript, we recommend the following syntax.
{{{ This is ^^superscripted^^ text. }}}
Recommended XHTML: {{{ This is <sup>superscripted</sup> text. }}}
Output: This is %%(vertical-align: super) superscripted%% text.
Comparison:
http://www.wikimatrix.org/syntax.php?i=28
see also [[SuperscriptAndSubscriptProposal]]
== Subscript
For those wiki engines which wish to support subscript, we recommend the following syntax.
{{{ This is ,,subscripted,, text. }}}
Recommended XHTML: {{{ This is <sub>subscripted</sub> text. }}}
This is %%(vertical-align: sub) subscripted%% text.
Comparison on wikimatrix:
http://www.wikimatrix.org/syntax.php?i=29
see also [[SuperscriptAndSubscriptProposal]]
== Underline
For those wiki engines which wish to support underlining, we recommend the following syntax.
{{{ This is __underlined__ text. }}}
Recommended XHTML: {{{ This is <u>underlined</u> text. }}}
Output: This is %%(text-decoration: underline) underlined%% text.
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.
== Alternate Link Syntax
Spaces before and after the arrow are not required. If there are multiple {{{->}}}, then a link cannot have a {{{->}}}, so that gets passed to the description.
{{{
[[description -> link]]
[[the -> can be used to make a link -> TextFormattingRules]]
}}}
Recommended XHTML:
{{{
<a href="http://www.examplewiki.com/link">description</a>
<a href="http://www.examplewiki.com/TextFormattingRules">the -> can be used to make a link</a>
}}}
Sample output:
[description|link]\\
[the characters -> can be used to make a link|TextFormattingRules]
== 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>
}}}
Version Date Modified Size Author Changes ... Change note
68 26-Sep-2008 22:52 4.767 kB 134.65.2.117 to previous
67 29-Feb-2008 16:15 4.767 kB YvesPiguet to previous | to last Discussion on talk page plz
66 29-Feb-2008 16:12 4.755 kB YvesPiguet to previous | to last Mv discussion to Talk.Creole Additions
65 23-Feb-2008 15:10 6.211 kB WeakishJiang to previous | to last inline and block quote
64 23-Feb-2008 13:03 5.736 kB WeakishJiang to previous | to last one term with multi-definitions in dl
63 22-Feb-2008 15:04 5.55 kB WeakishJiang to previous | to last
62 22-Feb-2008 15:03 5.548 kB WeakishJiang to previous | to last I suggest that descriptions (or definitions) //must// begin on a new line beginn
61 22-Feb-2008 14:20 5.133 kB WeakishJiang to previous | to last we should consider output HTML more carefully.
« This page (revision-68) was last changed on 26-Sep-2008 22:52 by 134.65.2.117