document how to support the ordered list numeration styles
authorDan Allen <dan@opendevise.com>
Sat, 10 Feb 2018 09:01:32 +0000 (02:01 -0700)
committerDan Allen <dan@opendevise.com>
Sat, 10 Feb 2018 09:01:32 +0000 (02:01 -0700)
docs/modules/ROOT/pages/style-guide.adoc

index fc69f67..e1a48e4 100644 (file)
@@ -55,7 +55,52 @@ Here's how it might appear when the title is displayed as text:
 
 WARNING: Watch out!
 
-=== Task lists
+=== Ordered List Numeration Styles
+
+The browser automatically numbers ordered lists and selects a numeration style by list depth in the following order: decimal, lower-alpha, lower-roman, upper-alpha, upper-roman.
+
+AsciiDoc allows the author to override the numeration style for an ordered list.
+Here's an example of that output:
+
+[source,html]
+----
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li><p>a</p></li>
+<li><p>b</p></li>
+<li><p>c</p></li>
+</ol>
+</div>
+----
+
+In order to support this customization, you must assign the list-style-type property to the following classes on the <ol> element in your stylesheet.
+
+|===
+|<ol> class |list-style-type property value
+
+|arabic
+|decimal
+
+|decimal
+|decimal-leading-zero
+
+|loweralpha
+|lower-alpha
+
+|lowergreek
+|lower-greek
+
+|lowerroman
+|lower-roman
+
+|upperalpha
+|upper-alpha
+
+|upperroman
+|upper-roman
+|===
+
+=== Task Lists
 
 A task list is an unordered list with items that are prefixed with a checkbox marker (checked or unchecked).
 Here's an AsciiDoc source example that produces a task list: