»User Guide
Text based document generation

The AsciiDoc website source is included in the AsciiDoc distribution as an example of using AsciiDoc to build a website. The files are principally located under /doc and /website, with a handful of files pulled in from the root directory.

A simple shell script (./build_website.sh) will build the site’s web pages — just set the LAYOUT variable to the desired layout.

Website Layouts

The website layout is determined by the layout configuration file (layout1.conf or layout2.conf) and corresponding layout CSS file (layout1.css or layout2.css). The example website comes with the following layouts:

Layout Description


Table based layout


CSS based layout (this is the default layout)

The default tables based layout (layout1) works with most modern browsers.

Note The simulated frames layout (layout2) does not work with IE6.