The Article Title

Author's Name

Revision History
Revision 8.3.52 February 2009AN

Table of Contents

1. The First Section
1.1. Sub-section with Anchor
2. The Second Section
A. Example Appendix
A.1. 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).

1. 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.


1.1. Sub-section with Anchor

Sub-section at level 2.

1.1.1. A Nested Sub-section

Sub-section at level 3.

1.1.1.1. Yet another nested Sub-section

Sub-section at level 4.

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

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.

A.1. Appendix Sub-section

Appendix sub-section at level 2.

Bibliography

The bibliography list is a style of AsciiDoc bulleted list.

[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 a style of AsciiDoc labeled lists.

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.