asciidoc 命令

常用示例

说明

asciidoc converts plain text documents written in AsciiDoc markup to HTML, DocBook, and other formats. AsciiDoc is a lightweight markup language designed for writing documentation, articles, books, and man pages. The default backend is HTML (xhtml11). DocBook output can be further processed with tools like dblatex for PDF generation or xmlto for various formats. The tool reads configuration from /etc/asciidoc/ and ~/.asciidoc/. Document attributes control output features like table of contents (-a toc), embedded images (-a data-uri), icons (-a icons), and maximum width (-a max-width=55em). Attributes can also be set within the document itself. If FILE is -, input is read from standard input, enabling pipeline processing.

参数

-b _backend_, --backend=_backend_

Output format: html, html5, xhtml11, html4, docbook, docbook45, docbook5, slidy, wordpress, latex

-d _doctype_, --doctype=_doctype_

Document type: article (default), book, manpage

-o _file_, --out-file=_file_

Write output to file (default: input filename with new extension)

-a _name=value_, --attribute=_name=value_

Set a document attribute

-f _file_, --conf-file=_file_

Use additional configuration file

-n, --section-numbers

Auto-number section titles

-s, --no-header-footer

Output document body only (no HTML head/body tags)

--safe

Enable safe mode (disable potentially dangerous features)

-v, --verbose

Print processing information to stderr

--help _topic_

Print help (topics: syntax, manpage)

--version

Print version number