summaryrefslogtreecommitdiff
path: root/doc/article.txt
diff options
context:
space:
mode:
authorStuart Rackham <srackham@methods.co.nz>2009-11-19 12:36:41 +1300
committerStuart Rackham <srackham@methods.co.nz>2009-11-19 12:36:41 +1300
commite1961013e22ba0726778182ceca3c8ac904e2a4d (patch)
tree5f25d35985ca0cd705e203f4a30e97f6141088be /doc/article.txt
parent0e2b53e89673c12d98cde63339eb0b1a699b70b3 (diff)
downloadasciidoc-e1961013e22ba0726778182ceca3c8ac904e2a4d.tar.gz
- Added FAQ explaining how to override special section titles.
- Added {zwsp} (zero width space) attribute. - Undefined paragraph styles are reported (previously threw a runtime error). - Eliminated empty preamble generation. - Floating titles now processed in all contexts. - Updated example article and book documents with the recommended explicit special section syntax. - Implemented auto-lettered appendix names - Section numbering can be disabled in HTML outputs with a :numbered!: AttributeEntry.
Diffstat (limited to 'doc/article.txt')
-rw-r--r--doc/article.txt28
1 files changed, 18 insertions, 10 deletions
diff --git a/doc/article.txt b/doc/article.txt
index c4b7050..b7754e4 100644
--- a/doc/article.txt
+++ b/doc/article.txt
@@ -11,8 +11,9 @@ NOTE: The abstract, preface, appendix, bibliography, glossary and
index section titles are significant ('specialsections').
-Abstract
---------
+[abstract]
+Example Abstract
+----------------
The optional abstract (one or more paragraphs) goes here.
This document is an AsciiDoc article skeleton containing briefly
@@ -79,8 +80,12 @@ indexterm:[Second example index entry]
An example link to a bibliography entry <<taoup>>.
-Appendix A: Example Appendix
-----------------------------
+
+:numbered!:
+
+[appendix]
+Example Appendix
+----------------
AsciiDoc article appendices are just just article sections with
'specialsection' titles.
@@ -89,8 +94,9 @@ Appendix Sub-section
Appendix sub-section at level 2.
-Bibliography
-------------
+[bibliography]
+Example Bibliography
+--------------------
The bibliography list is a style of AsciiDoc bulleted list.
[bibliography]
@@ -101,8 +107,9 @@ The bibliography list is a style of AsciiDoc bulleted list.
ISBN 1-56592-580-7.
-Glossary
---------
+[glossary]
+Example Glossary
+----------------
Glossaries are optional. Glossaries entries are an example of a style
of AsciiDoc labeled lists.
@@ -115,8 +122,9 @@ A second glossary term::
ifdef::backend-docbook[]
-Index
------
+[index]
+Example Index
+-------------
////////////////////////////////////////////////////////////////
The index is normally left completely empty, it's contents being
generated automatically by the DocBook toolchain.