At line 1 changed one line |
Hello ! |
Hello !!! |
At line 11 changed one line |
= personal position |
!!! personal position |
At line 25 changed one line |
= glossary |
!!! glossary |
At line 58 changed one line |
**section = heading / content :** Major semantic tailoring of a page. \\ |
**section !!! heading / content :** Major semantic tailoring of a page. \\ |
At line 65 changed one line |
= page structure |
!!! page structure |
At line 67 removed one line |
== page component tree |
At line 68 added 4 lines |
|
|
!!!!!! page component tree |
|
At line 88 changed one line |
(A heading could be a single-section block, thus both a section and a block ? Then, how to mark a subtitle ? There should be a tag, or what ? Splitting a heading with a visual newline is not coherent, as it's not a tag. If we choose a new tag (e.g. '!'), then a heading would become a block with 2 alineas. Similar to a definition block tagged with ;term:explanation) |
(A heading could be a single-section block, thus both a section and a block ? Then, how to mark a subtitle ? There should be a tag, or what ? Splitting a heading with a visual newline is not coherent, as it's not a tag. If we choose a new tag (e.g. '!!!'), then a heading would become a block with 2 alineas. Similar to a definition block tagged with ;term:explanation) |
At line 96 changed one line |
== semantic page structure |
!!!!!! semantic page structure |
At line 99 changed 3 lines |
? ==> this element can be present or not (0 or 1 time) \\ |
+ ==> this element can be repeated (1 or more times) \\ |
¤ ==> this element can be present any number of times (0, 1 or more times) |
? !!!!!!> this element can be present or not (0 or 1 time) \\ |
+ !!!!!!> this element can be repeated (1 or more times) \\ |
¤ !!!!!!> this element can be present any number of times (0, 1 or more times) |
At line 113 changed 2 lines |
imported_block : {{//type// //ID// (|//parameter//=//value//)*}} |
computed_block : ((//type// //ID// (|//parameter//=//value//)*)) |
imported_block : {{//type// //ID// (|//parameter//!!!//value//)*}} |
computed_block : ((//type// //ID// (|//parameter//!!!//value//)*)) |
At line 117 changed one line |
== markup page structure |
!!!!!! markup page structure |
At line 125 changed one line |
== alinea components structure |
!!!!!! alinea components structure |
At line 127 changed 2 lines |
title : =+ text NL |
sub_title : !+ text NL |
title : !!!+ text NL |
sub_title : !!!+ text NL |
At line 139 changed one line |
== inline text structure |
!!!!!! inline text structure |
At line 152 changed one line |
== style markers : |
!!!!!! style markers : |
At line 161 changed one line |
== special tags & marks |
!!!!!! special tags & marks |
At line 166 removed one line |
//Used to split an alinea in visual/semantic lines. Not a tag. Should be NL !!!// |
At line 170 added 2 lines |
//Used to split an alinea in visual/semantic lines. Not a tag. Should be NL !!!!!!!!!// |
|
At line 169 changed one line |
//This mark is used to make a visual line out of two source lines, or the contrary -- may be useful ? Don't confuse with the alinea / visual line distinction. This mark sets a difference between source and displayed text. Very bad indeed ! Rare, cryptic & confusing.// |
//This mark is used to make a visual line out of two source lines, or the contrary -- may be useful ? Don't confuse with the alinea / visual line distinction. This mark sets a difference between source and displayed text. Very bad indeed !!! Rare, cryptic & confusing.// |
At line 173 changed one line |
= what I prize in creole |
!!! what I prize in creole |
At line 183 changed one line |
= what I miss / what I don't like |
!!! what I miss / what I don't like |
At line 187 changed one line |
* page title (!=page_name) & subtitle |
* page title (!!!!!!page_name) & subtitle |
At line 193 changed one line |
* --nowiki and monospace should be totally distinct !-- //they are (or will be ?) ! (thanx to [[YvesPiguet]] for the precision) |
* --nowiki and monospace should be totally distinct !!!-- //they are (or will be ?) !!! (thanx to [[YvesPiguet]] for the precision) |
At line 198 changed 2 lines |
= marking components |
todo |
!!! using words : *pro* internationalisation |
At line 201 removed 47 lines |
= tags : choosing the right character for the right use |
//buiding a matching table// |
|
Below all non-control non-letter non-digit 7-bit-ASCII characters/keys. We should stick to these, as other characters may be problematic with non-english keyboards like mine ;-) : |
{{{!}}} " # $ % & ' ( ) * + , - . / : ; < = > ? @ [ \ ] ^ _ ` { | } ~ NL SP TAB |
|
== feature --> character table |
|
|= feature |= characters |= fit |= example |= note ] |
|= style | | | | | |
| highlight | * ! | ! | | * conflict with list\\! good | |
| distinct | / | / | / | perfect !? | |
| monospace | # = _ | = | | # conflict with anchor & list | |
| litteral/escape | ~ {{{{{{}}}}}} \ = " ' | " | | " pb at start of line | |
|= link/pointer | | | (may be considered\\as generated block) | then use brackets for generated\\& braces are free | |
| to page | {{{[[]]}}} | | | | |
| alias | {{{|}}} \ | | | {{{|}}} conflict with table\\see parameter | |
| to anchor/target | # @ | | {{{[[page@target]]}}} | | |
| anchor/target | {{{## @@}}} | {{{@@}}} | @@target@@ | | |
|= layout | | | | | |
| new alinea\\paragraph | NLNL NL § {{{\\\}}} | | | see alinea break\\§ similar to list & title\\NLNL good display | |
| title+subtitle | =: !: +: | | | | |
| bullet list item | * . | . | | * conflict with highlight | |
| number list item | # ? | | | # conflict with monospace | |
| definition | ;: ?: | ?: | | ? conflict with variable | |
| table cell | {{{|}}} | {{{|}}} | | | |
| table head | {{{|=}}} | {{{|?}}} | | | |
|= blocks | | | | | |
| component | {{}} | | {{image address}} | | |
| (x)html | {{{<<>>}}} | | {{{<<span class="abstract">>}}} | | |
| code | (()) | | | parenthesis ? | |
|= newlines pb. | | | | | |
| alinea break | {{{\\}}} NL | NL | | no need !!!\\not a tag | |
| scissor/glue | {{{\\}}} __ | | | avoid ! (confusion)\\not a tag | |
|= other elements | | | | | |
| parameter | {{{|}}} \ | | | {{{|}}} conflict with table\\see alias | |
| variable | %% ?? | | %%page_name%% | ? conflict with defintion\\ may be considered as generated | |
| | | | | | |
| | | | | | |
|
== feature --> character table |
todo -- the opposite of above, to better see free & matching characters |
|
|
|
= using words : *pro* internationalisation |
|
At line 249 changed one line |
Using words in wiki syntax is //not// an obstacle to internationalisation, rather the contrary ; as long as the author can use his/her own language ! |
Using words in wiki syntax is //not// an obstacle to internationalisation, rather the contrary ; as long as the author can use his/her own language !!! |
At line 252 changed one line |
((page navigation | dynamic=true)) |
((page navigation | dynamic!!!true)) |
At line 254 changed 2 lines |
((box new_page | title="crear nov paj")) |
((image logo.png | tag="logo" | hSize=55)) |
((box new_page | title!!!"crear nov paj")) |
((image logo.png | tag!!!"logo" | hSize!!!55)) |
At line 275 changed one line |
//Note that this principle works for any programming language ! With such an supple editor -- foregroung/background separation --, your could programm C or python or whatever in your own mother tongue. And even change language features to fit your view: I would change assignment to ':' instead of '='.// |
//Note that this principle works for any programming language !!! With such an supple editor -- foregroung/background separation --, your could programm C or python or whatever in your own mother tongue. And even change language features to fit your view: I would change assignment to ':' instead of '!!!'.// |
At line 277 removed 2 lines |
= newline / paragraph : the big problem ! |
todo -- see notes about that everywhere on this page |
At line 235 added 68 lines |
!!! marking components |
todo |
|
|
|
!!! tags : choosing the right character for the right use |
//buiding a matching table// |
|
Below all non-control non-letter non-digit 7-bit-ASCII characters/keys. We should stick to these, as other characters may be problematic with non-english keyboards like mine ;-) : |
{{{!!!}}} " # $ % & ' ( ) * + , - . / : ; < !!! > ? @ [ \ ] ^ _ ` { | } ~ NL SP TAB |
|
!! what do people do ? |
//human-to-human text// |
How de the people already format, style & layout plain text ? |
see [[http://usemod.com/cgi-bin/mb.pl?SillyTextFormattingRules]] |
Especially numbered lists & line breaks. |
|
!! feature --> character table |
|
|== feature |== characters |== fit |== example |== note ] |
|== style | | | | simple char at start of line for alinea style | |
| highlight | ** !! | !! | | * conflict with list\\! good | |
| distinct | // | // | | perfect ==? | |
| monospace | ## !! __ | {{{==}}} | | # conflict with anchor & list | |
| litteral/escape | ~ ~~ {{{{{{}}}}}} \ {{{\\}}} "" '' | " | | " pb at start of line? | |
|== link/pointer | | | | can be treated as component | |
| to page | {{{[[]]}}} | | | | |
| alias | {{{|}}} \ | | | {{{|}}} conflict with table\\see parameter | |
| categorized page\\language\\interWiki| {{{:}}} \ | | | {{{:}}} conflict with definition & subTitle | |
| to anchor/target | # @ | | {{{[[page@target]]}}} | | |
| anchor/target | {{{## @@}}} | {{{@@}}} | @@target@@ | | |
|== layout | | | | | |
| new alinea\\paragraph | NLNL NL § {{{\\\}}} | | | see alinea break\\§ similar to list & title\\NLNL good display | |
| title | == == + | | | | |
| subTitle | : _ | _ | | : similar to def meaning\\_ good ? | |
| bullet list item | * . | . | | * conflict with highlight | |
| number list item | # ? n 1 | | | # conflict with monospace\\why not 'n' or a real number? | |
| def term | ; ? | ? | | ; not explicit at all\\? conflict with variable | |
| def meaning | : | : | | :conflict with category link | |
| table cell | {{{|}}} | {{{|}}} | | | |
| table head | {{{|==}}} | {{{|?}}} | | | |
| horiz. rule | ---- | ---- | | yep ! | |
|== blocks | | | | | |
| component | {{{{{}}}}} | | {{image address}} | | |
| (x)html | {{{<<>>}}} | | {{{<<span class=="abstract">>}}} | | |
| code | (()) | | ((python {{{|}}} print("nohtyp"))) | parenthesis ? | |
|== line breaks | | | | | |
| alinea break | {{{\\}}} NL | NL | | not needed !!==\\not a tag | |
| scissor/glue | {{{\\}}} __ | | | avoid == (confusion)\\not a tag | |
|== elements | | | | | |
| parameter | {{{|}}} \ ? | | | {{{|}}} conflict with table\\see alias | |
| variable | %% ?? | | %%page_name%% | ? conflict with defintion\\may be considered as component | |
| | | | | | |
| | | | | | |
|
(*) A link may also be considered as a generated component. This choice would be consistent with the facts : a link is not only text, and it accepts parameters. Syntax : [[link page | alias]]. Pb : it makes longer a very common feature. But the real typing pb lies in the double double bracket, not in typing a short word, as there's already text to type in the address. Or what ? Side advantage : it makes brackets or braces free for something else (placeholder - variable - what else ?). |
|
!!! character --> feature table |
todo -- the opposite of above, to better see free & matching characters |
|
|
|
!!! newline / paragraph |
[[the user's newline]] |
|
!!! customization alternative |
[[customization alternative]] |
|