From 5bb7ee2f88b8c841a18ad25bd66e28388f886122 Mon Sep 17 00:00:00 2001
From: Jermolene <jeremy@osmosoft.com>
Date: Fri, 6 Dec 2013 16:24:11 +0000
Subject: [PATCH] Docs updates

---
 .../tw5.com/tiddlers/Release 5.0.1alpha.tid   |  4 +-
 .../wikitext/Block Quotes in WikiText.tid     | 68 +++++++++++++++++++
 .../tiddlers/wikitext/Lists in WikiText.tid   | 19 +++++-
 3 files changed, 87 insertions(+), 4 deletions(-)
 create mode 100644 editions/tw5.com/tiddlers/wikitext/Block Quotes in WikiText.tid

diff --git a/editions/tw5.com/tiddlers/Release 5.0.1alpha.tid b/editions/tw5.com/tiddlers/Release 5.0.1alpha.tid
index a93f940f4..c1bdeb2ba 100644
--- a/editions/tw5.com/tiddlers/Release 5.0.1alpha.tid	
+++ b/editions/tw5.com/tiddlers/Release 5.0.1alpha.tid	
@@ -1,6 +1,6 @@
 created: 20131201132300007
 creator: JeremyRuston
-modified: 20131205152854723
+modified: 20131206161343895
 modifier: JeremyRuston
 tags: releasenote
 title: Release 5.0.1-alpha
@@ -14,7 +14,7 @@ type: text/vnd.tiddlywiki
 ** Ignores attempts to import plugins that are older than currently installed plugins
 ** System tiddlers are now imported as usual
 * If `$:/theme` isn't defined or refers to a missing tiddler, then fallback through ''Snow White'' to ''Vanilla''. This means that `empty.html` now defaults to ''Snow White''
-* Added support for blockquotes by extending the list parser
+* Added support for [[Block Quotes in WikiText]]
 ** Contributed by StephanHradek (@Skeeve on GitHub)
 
 !! Bug fixes
diff --git a/editions/tw5.com/tiddlers/wikitext/Block Quotes in WikiText.tid b/editions/tw5.com/tiddlers/wikitext/Block Quotes in WikiText.tid
new file mode 100644
index 000000000..3abff761b
--- /dev/null
+++ b/editions/tw5.com/tiddlers/wikitext/Block Quotes in WikiText.tid	
@@ -0,0 +1,68 @@
+created: 20131206154636572
+creator: JeremyRuston
+modified: 20131206162157596
+modifier: JeremyRuston
+tags: wikitext
+title: Block Quotes in WikiText
+type: text/vnd.tiddlywiki
+
+There are two ways to produce HTML block quotes in TiddlyWiki5, one for content spread across multiple lines, and one for single line content.
+
+! Multi-line Block Quotes
+
+The syntax for multi-line block quotes is:
+
+<<wikitext-example src:"<<<
+This is a block quoted paragraph
+written in English
+<<<
+">>
+
+!! Citation
+
+A citation can be added to the quote like this:
+
+<<wikitext-example src:"<<<
+Computers are like a bicycle for our minds
+<<< Steve Jobs
+">>
+
+!! CSS Classes
+
+CSS classes can be added to a block quote:
+
+<<wikitext-example src:"<<<.myClass.another-class
+Operating systems are like a brick wall for our minds
+<<< Nobody
+">>
+
+! Single-line Block Quotes
+
+The single-line syntax for block quotes is actually an extension of the syntax for [[Lists in WikiText]]. For example:
+
+<<wikitext-example src:"> Quoted text
+> Another line of quoted text
+">>
+
+You can also nest quotes like this:
+
+```
+> A top quote
+>> A subquote
+> Another top quote
+```
+
+Which renders as:
+
+> A top quote
+>> A subquote
+> Another top quote
+
+You can also mix block quotes with other list items. For example:
+
+<<wikitext-example src:"* List One
+** List Two
+**> A quote
+**> Another quote
+* List Three
+">>
diff --git a/editions/tw5.com/tiddlers/wikitext/Lists in WikiText.tid b/editions/tw5.com/tiddlers/wikitext/Lists in WikiText.tid
index c49323b99..d1d97922a 100644
--- a/editions/tw5.com/tiddlers/wikitext/Lists in WikiText.tid	
+++ b/editions/tw5.com/tiddlers/wikitext/Lists in WikiText.tid	
@@ -1,11 +1,13 @@
 created: 20131205160257619
 creator: JeremyRuston
-modified: 20131205160620014
+modified: 20131206154613715
 modifier: JeremyRuston
 tags: wikitext
 title: Lists in WikiText
 type: text/vnd.tiddlywiki
 
+! Unordered Lists
+
 You can create unordered lists with `*` characters:
 
 <<wikitext-example src:"* First list item
@@ -14,6 +16,8 @@ You can create unordered lists with `*` characters:
 * Third list item
 ">>
 
+! Ordered Lists
+
 Ordered lists use `#` instead of `*`:
 
 # First item
@@ -30,6 +34,8 @@ You can also mix ordered and unordered list items:
 *## And the other
 ">>
 
+! CSS Classes
+
 You can also assign a CSS class to an individual member of a list with this notation:
 
 <<wikitext-example src:"* List One
@@ -37,4 +43,13 @@ You can also assign a CSS class to an individual member of a list with this nota
 * List Three
 ">>
 
-Note that [[Block Quotes in WikiText]] can be mixed with lists.
+! Mixing Lists and Block Quotes
+
+Note that [[Block Quotes in WikiText]] can be mixed with lists. For example:
+
+<<wikitext-example src:"* List One
+** List Two
+**> A quote
+**> Another quote
+* List Three
+">>