NAME¶asciidoctor - converts AsciiDoc source files to HTML, DocBook, and other formats
SYNOPSIS¶asciidoctor [OPTION]... FILE...
DESCRIPTION¶The asciidoctor(1) command converts the AsciiDoc source file(s) FILE to HTML5, DocBook 5, man(ual) page, and other custom output formats.
If FILE is - then the AsciiDoc source is read from standard input.
Security Settings¶-B, --base-dir=DIR
Document Settings¶-a, --attribute=ATTRIBUTE
ATTRIBUTE is normally formatted as a key-value pair, in the form NAME=VALUE. Alternate forms are NAME (where the VALUE defaults to an empty string), NAME! (unsets the NAME attribute), and NAME=VALUE@ (or NAME@=VALUE) (where VALUE does not override the NAME attribute if it’s already defined in the source document). Values containing spaces should be enclosed in quotes.
This option may be specified more than once.
Document Conversion¶-D, --destination-dir=DIR
If there is a subfolder that matches the engine name (if specified), that folder is appended to the template directory path. Similarly, if there is a subfolder in the resulting template directory that matches the name of the backend, that folder is appended to the template directory path.
This option may be specified more than once. Matching templates found in subsequent directories override ones previously discovered.
Program Information¶-h, --help [TOPIC]
-v can also be used if no source files are specified.
ENVIRONMENT¶Asciidoctor honors the SOURCE_DATE_EPOCH environment variable. If this variable is assigned an integer value, that value is used as the epoch of all input documents and as the local date and time. See <https://reproducible-builds.org/specs/source-date-epoch/> for more information about this environment variable.
BUGS¶Refer to the Asciidoctor issue tracker at <https://github.com/asciidoctor/asciidoctor/issues?q=is%3Aopen>.
AUTHORS¶Asciidoctor was written by Dan Allen, Ryan Waldron, Jason Porter, Nick Hengeveld, and other contributors.
AsciiDoc was written by Stuart Rackham and has received contributions from many other individuals.
RESOURCES¶Project web site: <https://asciidoctor.org>
Git source repository on GitHub: <https://github.com/asciidoctor/asciidoctor>
GitHub organization: <https://github.com/asciidoctor>
Discussion list / forum: <http://discuss.asciidoctor.org>
COPYING¶Copyright (C) 2012-2019 Dan Allen, Ryan Waldron, and the Asciidoctor Project. Free use of this software is granted under the terms of the MIT License.