The Article Title

Author's Name

Revision History
Revision 7.1.013 January 2006AN

Table of Contents

The First Section
Sub-section with Anchor
The Second Section
A. Example Appendix
Appendix Sub-section
Bibliography
Glossary
Index

This is the optional preamble (an untitled section body). Useful for writing simple sectionless documents consisting only of a preamble.

Abstract

The optional abstract (one or more paragraphs) goes here.

This document is an AsciiDoc article skeleton containing briefly annotated element placeholders plus a couple of example index entries and footnotes. The preface, appendix, bibliography, glossary and index section titles are significant (specialsections).

The First Section

Article sections start at level 1 and can be nested up to four levels deep. [1]

And now for something completely different: monkeys, lions and tigers (Bengal and Siberian) using the alternative syntax index entries.

Note that multi-entry terms generate separate index entries.

Here are a couple of image examples: an images/smallnew.png example inline image followed by an example block image:

Figure 1. Tiger block image

Tiger image

Followed by an example table:

Table 1. An example table

Option Description
-a USER GROUP Add USER to GROUP.
-R GROUP Disables access to GROUP.

Sub-section with Anchor

Sub-section at level 2.

A Nested Sub-section

Sub-section at level 3.

Yet another nested Sub-section

Sub-section at level 4.

This is the maximum sub-section depth supported by the distributed AsciiDoc configuration. [2]

The Second Section

Article sections are at level 1 and can contain sub-sections nested up to four deep.

An example link to anchor at start of the first sub-section.

An example link to a bibliography entry [taoup].

A. Example Appendix

AsciiDoc article appendices are just just article sections with specialsection titles.

Appendix Sub-section

Appendix sub-section at level 2.

Bibliography

The bibliography list is an example of an AsciiDoc SimpleList, the AsciiDoc source list items are bulleted with a + character.

[taoup] Eric Steven Raymond. The Art of Unix Programming. Addison-Wesley. ISBN 0-13-142901-9.

[walsh-muellner] Norman Walsh & Leonard Muellner. DocBook - The Definitive Guide. O'Reilly & Associates. 1999. ISBN 1-56592-580-7.

Glossary

Glossaries are optional. Glossaries entries are an example of AsciiDoc VariableList entries, the AsciiDoc source entry terms are terminated by the ":-" characters.

A glossary term

The corresponding (indented) definition.

A second glossary term

The corresponding (indented) definition.

Index

B

Bengal Tiger, The First Section
Big cats
Lions, The First Section
Tigers
Bengal Tiger, The First Section
Siberian Tiger, The First Section

E

Example index entry, The First Section

S

Second example index entry, The Second Section
Siberian Tiger, The First Section

T

Tigers
Bengal Tiger, The First Section
Siberian Tiger, The First Section


[1] An example footnote.

[2] A second example footnote.