Product SiteDocumentation Site

The Article Title

Revision History
Revision 1.02003-12AN

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

Note

The abstract, preface, appendix, bibliography, glossary and index section titles are significant (specialsections).

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

Chapter 2. 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 smallnew example inline image followed by an example block image:


An example footnote.

Chapter 3. Images

vim logo as PNG image vim logo as GIF image

Followed by an example table:

Table 3.1. An example table

OptionDescription

-a USER GROUP

Add USER to GROUP.

-R GROUP

Disables access to GROUP.

Table 3.2. Second example table

Col 1Col 2Col 3

6

Three items

d

1

Item 1

a

2

Item 2

b

3

Item 3

c

Table 3.3. More complicated table

DateDurationAvg HRNotes

22-Aug-08

10:24

157

Worked out MSHR (max sustainable heart rate) by going hard for this interval.

22-Aug-08

152

Back-to-back with previous interval.

24-Aug-08

none

Example 3.1. An example example

Lorum ipum…​

3.1. Sub-section with Anchor

Sub-section at level 2.

3.1.1. A Nested Sub-section

Sub-section at level 3.

3.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]


A second example footnote.

Chapter 4. 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].

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

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

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