ASCIIDOC(1) Manual Page

Define or delete document attribute. ATTRIBUTE is formatted like NAME=VALUE. Command-line attributes take precedence over document and configuration file attributes. Alternate acceptable forms are NAME (the VALUE defaults to an empty string); NAME! (delete the NAME attribute); NAME=VALUE@ (do not override document or configuration file attributes). Values containing spaces should be enclosed in double-quote characters. This option may be specified more than once. A special attribute named trace controls the output of diagnostic information.

Backend output file format: docbook45, docbook5, xhtml11, html4, html5, slidy, wordpress or latex (the latex backend is experimental). You can also use the backend alias names html (aliased to xhtml11) or docbook (aliased to docbook45). Defaults to html. The --backend option is also used to manage backend plugins (see PLUGIN COMMANDS).

Use configuration file CONF_FILE.Configuration files processed in command-line order (after implicit configuration files). This option may be specified more than once.

Run Python doctests in asciidoc module.

Document type: article, manpage or book. The book document type is only supported by the docbook backends. Default document type is article.

Dump configuration to stdout.

Specify the name of a filter to be loaded (used to load filters that are not auto-loaded). This option may be specified more than once. The --filter option is also used to manage filter plugins (see PLUGIN COMMANDS).

Print help TOPIC. --help topics will print a list of help topics, --help syntax summarizes AsciiDoc syntax, --help manpage prints the AsciiDoc manpage.

Exclude implicitly loaded configuration files except for those named like the input file (infile.conf and infile-backend.conf).

Suppress document header and footer output.

Write output to file OUT_FILE. Defaults to the base name of input file with backend extension. If the input is stdin then the outfile defaults to stdout. If OUT_FILE is - then the standard output is used.

Auto-number HTML article section titles. Synonym for --attribute numbered.

Enable safe mode. Safe mode is disabled by default. AsciiDoc safe mode skips potentially dangerous scripted sections in AsciiDoc source files.

Specify a theme name. Synonym for --attribute theme=THEME. The --theme option is also used to manage theme plugins (see PLUGIN COMMANDS).

Verbosely print processing information and configuration file checks to stderr.

Print program version number.

asciidoc(1) --filter, --backend or --theme option specifying the type of plugin.

A unique plugin name containing only alphanumeric or underscore characters.

A Zip file containing plugin resources, the name must start with the plugin name e.g. my_filter-1.0.zip packages filter my_filter.

The directory containing installed plugins. Each plugin is contained in its own separate subdirectory which has the same name as the plugin. PLUGINS_DIR defaults to the $HOME/.asciidoc/filters (for filter plugins) or $HOME/.asciidoc/backends (for backend plugins) or $HOME/.asciidoc/themes (for theme plugins).

The name of a directory containing the plugin source files or the name of a single source file.

Create a subdirectory in PLUGINS_DIR with the same name as the plugin then extract the ZIP_FILE into it.

Delete the PLUGIN_NAME plugin subdirectory and all its contents from the PLUGINS_DIR.

List the names and locations of all installed filter or theme plugins (including standard plugins installed in the global configuration directory).

Create a plugin file named ZIP_FILE containing the files and subdirectories specified by PLUGIN_SOURCE. File and directory names starting with a period are skipped.

If the SOURCE_DATE_EPOCH environment variable is set to a UNIX timestamp, then the {docdate}, {doctime}, {localdate}, and {localtime} attributes are computed in the UTC time zone, with any timestamps newer than SOURCE_DATE_EPOCH replaced by SOURCE_DATE_EPOCH. (This helps software using AsciiDoc to build reproducibly.)

Simply generate an html file from the asciidoc_file_name.txt that is in current directory using asciidoc.

Use the -b switch to use one of the proposed backend or another one you installed on your computer.

Use the -a switch to set attributes from command-line. AsciiDoc generated its stand-alone HTML user guide containing embedded CSS, JavaScript and images from the AsciiDoc article template with this command.

Generating the asciidoc manpage using the html5 backend.

Success

Failure (syntax or usage error; configuration error; document processing failure; unexpected error).