diff options
author | Stuart Rackham <srackham@methods.co.nz> | 2009-11-19 12:36:41 +1300 |
---|---|---|
committer | Stuart Rackham <srackham@methods.co.nz> | 2009-11-19 12:36:41 +1300 |
commit | e1961013e22ba0726778182ceca3c8ac904e2a4d (patch) | |
tree | 5f25d35985ca0cd705e203f4a30e97f6141088be /doc/article.txt | |
parent | 0e2b53e89673c12d98cde63339eb0b1a699b70b3 (diff) | |
download | asciidoc-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.txt | 28 |
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.
|