Edit page WikiDesignPrinciples
authorbernie <bernie@18.85.46.35>
Sat, 29 Sep 2007 19:48:05 +0000 (21:48 +0200)
committerPiki Plus <webmaster@codewiz.org>
Sat, 29 Sep 2007 19:48:05 +0000 (21:48 +0200)
EditingTips
WikiDesignPrinciples [new file with mode: 0644]

index 58d2c056bcf570e308cbeba1ff0ad20a49ebdffa..d310cffae612b3ac97218bc7e27ab707acd0ff52 100644 (file)
@@ -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 ==
 
-<div style="align:right; clear:right; font-size:24px; width:20em; max-width:60%; margin:1ex 0ex 1ex 1ex; border:3px outset #969; background-color:#faf; color: #f00; padding:.3em; text-align:center;">You can use {{div}}, {{span}} and {{iframe}} elements with any attribute.</div>
+<div style="align:right; clear:right; font-size:24px; width:20em; max-width:60%; margin:1ex 0ex 1ex 1ex; border:3px outset #969; background-color:#faf; color: #f00; padding:.3em; text-align:center;">
+You can use {{div}}, {{span}} and {{iframe}} elements with any attribute, including
+<span style="color: green">CSS</span>, of course.
+</div>
 
 == Access Control Lists ==
 
diff --git a/WikiDesignPrinciples b/WikiDesignPrinciples
new file mode 100644 (file)
index 0000000..9002166
--- /dev/null
@@ -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.