WikiMarkupLanguage

Featured: Featured Stories | Picture Gallery

William Paley | KernelWiki

Chat11.com Web Bible11.com MyBibleCenter.com

The Wiki Way More About This Book

Wiki Markup Language

See Wiki:MarkupLanguage for some interesting comments on this. The reality is that whatever you call it there are conventions and rules about the way we do things around here - see ours at TextFormattingRules . Further it seems that one of the differentiating features of wikis is the power they provide users to do more and more with wiki pages thru added constructs and syntax.

Suggestions and Discussion

Existing Guidelines

• carriage returns are significant in formatting
• white space and tabs are not significant
• lines can be concatenated by the use of "\" as the last character of a line
• in principle we should use simple HTML elements rather than invent something different (see HtmlTags?Create)

hence we deprecate '' and ''' in favour of <i> and <b>

There are some of us who prefer using double and triple quotes over the Html tags. Please keep this feature.

we also already use the following simple HTML elements <b> <i> <pre> <tt> <code>

• the first character of a line plays a significant part role in formatting

formatting that affects paragraphs should be required to be in the first character position (eg bullets, heading, lines)

• CascadingStyleSheets?Create should be used to control overall look and feel, eg WikiWithCascadingStyleSheet?Create
• there are some wiki only elements, eg <nowiki> that use HTML syntax, lets keep doing it this way, is using elements delimited by < and >

Special Syntax

• #REDIRECT

Inconsistencies

Carriage Return inconsistency

• Ending a paragraph requires two consecutive carriage returns, eg

  Sentence entered of first line.
  Second sentence entered on a second line - ie separated by a carriage return.

• Yet a bullet point is terminated by a single carriage return,eg
• First sentence of a bullet point

First character inconsistency

nowiki and ""

paired WikiMarkup?Create

=Test 1=
= Test 2

Test 1

Bold and italic makup are paired, but not indentation or bullets - contributing to the Carriage Return Inconsistency above.

New Proposals

• WikiPatches/TableSyntaxCommonMarkup?Create
• WikiPatches/ImageTags?Create

List of Some New Proposals

• ~~~ WikiPatches/AutoSignature?Create
• | WikiPatches/TableSyntax?Create
• @@@ Red+bold @@@ ^^^ Green ^^^ ~~~ Blue ~~~ --- Small --- +++ Big +++ WikiPatches/TextColours?Create
• #foo# WikiPatches/SeparateCounters?Create
• [#test] WikiPatches/NamedAnchors?Create
• 
  WikiPatches/ForcedLineBreaks?Create
• == # head ==, === # head ===, etc WikiPatches/NumberedHeadings?Create
• <toc> WikiPatches/TableOfContents?Create
• @x@imagename.extension WikiPatches/ImageTags?Create
• ::: WikiSuggestions/Html?Create (centres text)
• /text/ *text* _text_ WikiSuggestions/Html?Create (italic, bold, underline respectively)

I think http://www.iawiki.net/ has a syntax for 'overstrike' mode. Does anyone know?

yes, it is -/strike/- or -\strike\-

On UnrealWiki?Create we've:

• standardised carriage returns: \n is always a paragraph break. Our reasoning was that the original reason for single "\n" having no effect was that some older browsers could not word-wrap in edit fields. This is no longer an issue with newer software.
• seperated the behaviour for < nowiki >, < pre > and "initial whitespace".
• use the | table syntax, with < , > , ^ at the start of a cell giving alignment
• ">" at the start of a line makes a blockquote, email-style.
• introduced the <wiki> tag. This is extremely powerful. Anything within it is re-parsed as wiki text: basically, this allows:
  • paragraph breaks in entities which close on "\n", such as *, # and ;:
  • nesting of tags.

Thus:

; A definition term : <wiki>This term is:
* interesting
* useful
* amusing</wiki>

This will produce the HTML bullet list nested inside the Definition list, and thus indented. Also very useful for putting lists, headings etc in tables. For example, with the <wiki> tag, this entire section, complete with the sample above, would be indented as part of the bullet point.

I might add that the example above could also be produced by the following markup. <wiki> is more useful if you intend to put complex markup at places where the syntax would usually just allow for a single paragraph to the end of the line -- a bit like braces in C or similar programming languages. -- MichaelBuschbeck?Create

  ; A definition term : This term is
  ; * interesting
  ; * useful
  ; * amusing

Other mixed-type lists work too:

 * a bullet
 * second bullet, but this has
 * # sub point  one
 * # sub point two

DIV and SPAN

See also

WikiSuggestions/MarkupProcessing?Create

This page written by Garnet

Bobsgear - Get A Free Enterrpise Wiki Space!
Review: The Bobsgear Project was started to develop a variety of Confluence plugins. This installation of the Confluence Enterprise wiki includes flexible attachments, many Confluence plugins, personal blogs, interesting articles, and more. Bobsgear already has spaces related to politics, art and photography wiki, technical issues wiki, ediscovery wiki, health, Christian theology and Sabbath School wiki, the bible, book reviews, and quotations. Bobsgear allows free signup, and invites anyone to create a free hosted Confluence wiki space.

NEW USERS CLICK HERE! for a quick introduction to Wiki.

Elapsed:0