Spir

This is version 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 . It is not the current version, and thus it cannot be edited.
[Back to current version]   [Restore this version]

Hello,

I'm here as a simple amateur of all kinds of languages (including some human ones ;-)). Discovered this project while searching for improvements for the wikiDot markup, a really great wiki which engine is beeing delivered as open source. Have looked around, thought and designed a lot already. I'll try to expose the results of this reflexion progressively, here and on talk pages for specific topics.

personal position#

I'm rather looking for a basically better wiki markup language, than for one compatible with the present markups. So that principles such as

• no conflict
• not new

or

• (not really expressed but very present:) mostly used

are not relevant for me: they're rather second stage criteria. What I mean is that, to my opinion, these criteria are fundamental for a interwiki-only markup, precisely for mixing creole with local markup -- which sounds a bit alien to my ears. Otherwise

• author-friendliness
• clarity/simplicity/consistency

&

• speed to learn/memorize/master

are much more prominent goals.

glossary#

newline

:A "cuttink" mark, usually inserted by pressing the return/enter key, which is both a character that creates a new line and, in most cases, a tag that starts a new section (see comment about this below under 'page structure').

section

:A chunk of text between newline marks (except at start/end of page where there may be no start/end NL) (section = cutting)

segment

:A bit of text inside a section -- may be enclosed in style delimiters

block

:Either a sequence of sections of the same type, or a part of page included as a hole instead of beeing written (e.g. TOC, note list, image) -- see "page structure"

header / body

: Major semantic tailoring of a page. A header is a section ; a body is a sequence of blocks -- see "page structure"

page structure#

please improve & criticize on talk page

note the major difference between semantic & markup page structures

page             : title body
title            : = regular_text NL
body             : block*
block            : header | paragraph_block | bullet_list | number_list | table | imported_block | computed_block
header           : =(=)+ regular_text NL
paragraph_block  : paragraph+
paragraph        : text NL
bullet_list      : bullet_list_item NL
bullet_list_item : *+ text NL
number_list      : number_list_item NL
number_list_item : *+ text NL
table            : table_row
table_row        : (|text)+ |
imported_block   : {{//type// //ID// (|//parameter//=//value//)*}}
computed_block   : ((//type// //ID// (|//parameter//=//value//)*))
text             : plain_text | styled_text
styled_text      : distinct_text | important_text | raw_text | monospace_text | link | variable
distinct_text    : //plain_text//
important_text   : **plain_text**
raw_text         : ??plain_text??
monospace_text   : ??plain_text??
link             : [[//address// (|//text/)?]]
variable         : <<//name//>>
plain_text       : (//list of valid text characters separated with '|')*

markup page structure#

page    : title body
title   : = regular_text NL
body    : section*
section : header | paragraph | bullet_list_item | number_list_item | table_row | imported_block | computed_block

n o t e s

what I prize in creole#

• the word "creole"
• the consensus processus
• the focus on the most important features
• the trend toward intuitiveness (self-explaining tags)
• more & more

what I miss / what I don't like#

topics that will be further explained below/later

• page title (!=page_name) & subtitle
• sub-headers
• "distinct" (example, quotation, remark, advice) & "important" sections parallel to "distinct" (italic) & "important" (bold) segments
• syntax for all kinds of magic-words, variables & functions -- see for instance wikiMedia variables
• syntax for "imported" blocks (page, image, widget...)
• syntax for "computed" blocks (toc, index, page list...)
• nowiki and monospace should be totally distinct !
• syntax for native (x)html, including (java)scripts (I propose most simply to double <> tags to )