(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-28) was last changed on 26-Sep-2007 09:42 by ChuckSmith  

This page was created on 28-Aug-2006 10:46 by Chuck Smith

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
These are the notes regarding the [Creole Markup Extension|http://www.oddmuse.org/cgi-bin/oddmuse/Creole_Markup_Extension] for [Oddmuse|http://www.oddmuse.org/].
These are the notes regarding the [Creole Markup Extension|http://www.oddmuse.org/cgi-bin/oddmuse/Creole_Markup_Extension] for [Oddmuse|http://www.oddmuse.org/]. This extension is currently used
concurrently with some other extensions at [Wiki Ohana|http://wikiohana.org/].
At line 3 changed one line
Lists: No nested lists, a single space or tab required after the # or -.
The unsupported stuff first: Oddmuse doesn't know about placeholders. Creole coexists with all the other markup that the administrators happen to have installed.
At line 5 changed one line
Bold and Italic tags can be nested within each other, and may contain links. {{{**[[link]]**}}} will create a bold link. In the case of nesting errors, Oddmuse will try to close as many tags as possible. {{{**//bold and italic**//foo}}} will therefore print foo in italic, as the second {{{**}}} will close both {{**}} and {{//}}.
Lists: A single space or tab required after the {{{#}}}, {{{*}}} or {{{-}}}. Oddmuse supports both {{{*}}} or {{{-}}} for bullet lists. Nested lists are allowed, but mixed lists result in invalid XHTML. The list implementation allows multiline list items and empty lines between list items without starting a new list. Mixing numbered and unnumbered lists is not possible. Appropriate ul and ol elements will be generated instead. Leading whitespace before list items will be eaten.
At line 7 changed one line
Headings: {{{==}}} will create H2 headings. Users therefore cannot create H1 headings on a page. The page title is the only H1. Headings allow nested markup and end at the first newline. Therefore {{{== [[link]]}}} will create a link inside a heading. Trailing equal signs inside a heading will be eaten silently. Therefore {{{== foo ====}}} will create a heading "foo" where as {{{== foo != bar}}} will create a heading "foo != bar".
Bold and Italic tags can be nested within each other, and may contain links. {{{**[[link]]**}}} will create a bold link. In the case of nesting errors, Oddmuse will try to close as many tags as possible. {{{**//bold and italic**//foo}}} will therefore print foo in italic, as the second {{{**}}} will close both {{**}} and {{//}}. Bold and Italic may span lines but not paragraphs. Bold sections will use the strong element instead of b, italic sections will use the em element instead of i.
At line 9 changed one line
Preformatted and nowiki: As suggested by Janne, three opening braces at the beginning of a line will open a pre element, whereas three opening braces elsewhere will open a span element. This will usually not be monospaced, unlike pre, code, or tt elements!
Headings: {{{==}}} will create H2 headings. Users therefore cannot create H1 headings on a page. The page title is the only H1.
At line 11 changed one line
In preformatted blocks, any whitespace including a single newline after the opening braces will be eaten. Otherwise, all preformatted blocks will start with a newline (the newline right after the third opening brace.
Links: The alternative text for a link can span lines. Thus the following will work:
{{{
[[foo|this is
the bar]]
[[http://example.com|this is
an example]]
}}}
Oddmuse does not accept whitespace around the pipe symbol when renaming links. Thus: {{{[[page|name]]}}} and not {{{[[page | name]]}}}, for all variants of links.
As for raw links: When raw links are identified in the text, some extra processing takes place: First, some punctuation characters at the end of the URL are stripped again, so that "http://example.org/?" will link to "http://example.org/" and not "http://example.org/?". Furthermore, if the URL ends in a known extension for images (.png, .jpg, etc.), an image is inlined.
Preformatted and nowiki: As suggested by Janne, three opening braces at the beginning of a line will open a pre element (monospaced + unprocessed + preformatted), whereas three opening braces elsewhere will open a code element (monospaced + unprocessed).Both preformatted and unprocessed sections may contain empty lines. For unprocessed sections, these newlines will not be shown by the browser, obviously.
In preformatted blocks, any whitespace including a single newline after the opening braces will be eaten. Otherwise, all preformatted blocks will start with a newline (the newline right after the third opening brace. In addition to that, the closing three braces also need to stand at the beginning of a line.
Images: The extension supports all combinations of internal and external links:
{{{
{{page}}
{{http://example.com}}
[[link|{{page}}]]
[[link|{{http://example.com}}]]
[[http://example.org|{{page}}]]
[[http://example.org|{{http://example.com}}]]
}}}
All transclusions are treated as images to be inlined. This is not (yet) a generalized transclusion mechanism.
Horizontal lines: Oddmuse supported all three variants, but now only supports four dashes or more, starting at the first character of a line. Followed spaces and tab characters are "eaten".
Version Date Modified Size Author Changes ... Change note
28 26-Sep-2007 09:42 3.555 kB ChuckSmith to previous restore
27 26-Sep-2007 01:20 3.598 kB 194.9.85.141 to previous | to last
26 26-Sep-2007 01:19 3.589 kB 161.200.255.162 to previous | to last
25 26-Sep-2007 01:18 3.578 kB 63.241.9.240 to previous | to last
24 26-Sep-2007 01:17 3.564 kB 222.66.48.253 to previous | to last
23 08-Sep-2006 22:36 3.555 kB Alex Schröder to previous | to last Headings no longer allow nested markup, no do they require a
22 08-Sep-2006 22:34 3.945 kB Alex Schröder to previous | to last mixed lists result in invalid XHTML
21 07-Sep-2006 03:50 3.895 kB Alex Schröder to previous | to last [[page|name]] and not [[page | name]]
« This page (revision-28) was last changed on 26-Sep-2007 09:42 by ChuckSmith