From: bernie Date: Sat, 29 Sep 2007 19:48:05 +0000 (+0200) Subject: Edit page WikiDesignPrinciples X-Git-Url: https://codewiz.org/gitweb?a=commitdiff_plain;h=2300f752af97339fdcc78384ad602c5756c79559;p=wiki.git Edit page WikiDesignPrinciples --- diff --git a/EditingTips b/EditingTips index 58d2c05..d310cff 100644 --- a/EditingTips +++ b/EditingTips @@ -1,21 +1,12 @@ -Note: You should use formatting sparingly, WikiWikiWeb is about content, not look. - ---- - -This wiki syntax is deliberately similar to MoinMoin and WikiCreole. - -Click '''Raw Text''' in the header to see the markup for this page, and try it +Click '''Raw Text''' to see the markup for this page, and try it yourself in WikiSandBox. +--- -== Text Styles == +Our wiki syntax is deliberately similar to MoinMoin and WikiCreole. -Leave blank lines between paragraphs. - -To write //italics//, enclose the text in double slashes: /''''''/word/''''''/. -To write **bold**, enclose the text in double stars: *''''''*word*''''''*. -Double and triple quotes are also supported for backwards compatiblity with other wiki's. -These keywords are highlighted: FIXME, TODO, DONE. +Note: You should use formatting sparingly, WikiWikiWeb is about content, not look. +See WikiDesignPrinciples. == Links == @@ -32,6 +23,12 @@ Anchored links also work with [[FrontPage|wiki pages]], [[/index.html | local pa == Block elements == +Leave blank lines between paragraphs. + +You can insert line\\ +breaks\\ +with double backslashes: \****\. + If you indent text like this, then it is indented in the output you can have multiple levels of indent @@ -54,6 +51,18 @@ To insert program source without reformatting in a monospace font, use three cur Just like that. + +== Text Styles == + +To write **bold text**, enclose the text in double stars: *''''''*some word*''''''*. \\ +To write //italic text//, enclose the text in double slashes: /****/some word/****/. \\ +Double quotes are also supported for backwards compatiblity with other wikis. \\ +These keywords are highlighted: FIXME, TODO, DONE. + +TIP: four consecutive stars (*////*////*////*) or slashes (/****/****/****/****) are a good +way to prevent the syntax. :-) + + == Rulers == --- @@ -81,7 +90,10 @@ TODO: support table headers == Inline HTML == -
You can use {{div}}, {{span}} and {{iframe}} elements with any attribute.
+
+You can use {{div}}, {{span}} and {{iframe}} elements with any attribute, including +CSS, of course. +
== Access Control Lists == diff --git a/WikiDesignPrinciples b/WikiDesignPrinciples new file mode 100644 index 0000000..9002166 --- /dev/null +++ b/WikiDesignPrinciples @@ -0,0 +1,11 @@ + * Open - Should a page be found to be incomplete or poorly organized, any reader can edit it as they see fit. + * Incremental - It must be both possible and useful to cite unwritten pages. (incomplete) + * Organic - The structure of the site is expected to grow and evolve with the community that uses it. (co-evolution) + * Mundane - A small number of conventions provide all necessary formatting.(undistracted) + * Universal - The mechanisms of editing and organizing are the same as those of writing so that any writer is automatically and editor and organizer. + * Overt - The formatted and printed output will suggest the input required to reproduce it. (concrete) + * Unified - Page names will be drawn from a flat space so that no additional context is required to interpret them. (vocabulary) + * Precise - Pages will be titled with sufficient precision to avoid most name clashes, typically by forming noun phrases. (happy accidents) + * Tolerant - All input will produce output even when the output is not likely to be that desired. + * Observable - Activity within the site can be watched and reviewed by any other visitor. + * Convergent - Ambiguity and duplication can be removed by finding and citing similar or related content.