A2X(1) A2X(1) (NAME) a2x - AsciiDoc (SYNOPSIS) a2x [] SOURCE_FILE (DESCRIPTION) DocBook AsciiDoc SOURCE_FILE asciidoc(1) ( ) PDF EPUB DVI PS LaTeX XHTML ( ) (man page) HTML Help . SOURCE_FILE DocBook .xml . (OPTIONS) -a, --attribute=ATTRIBUTE (attribute) asciidoc(1) ( --asciidoc-opts="-a ATTRIBUTE"). . --asciidoc-opts=ASCIIDOC_OPTS asciidoc(1). . --conf-file=CONF_FILE . (CONF FILES) . -D, --destination-dir=DESTINATION_DIR . SOURCE_FILE . HTML (chunked epub htmlhelp xhtml manpage) . -d, --doctype=DOCTYPE DocBook: article manpage book. article manpage ( manpage ). -b, --backend=BACKEND BACKEND (backend plugin) . a2x a2x-backend.py BACKEND . SOURCE_FILE to_BACKEND a2x-backend.py BACKEND . -f, --format=FORMAT : chunked docbook dvi epub htmlhelp manpage pdf () ps tex text xhtml. AsciiDoc a2x-format FORMAT . -h, --help stdout. --icons (admonition) . . --icons-dir=PATH ( ) . images/icons . --icons . -k, --keep-artifacts (build) . --lynx lynx(1) ( : LYNX) . w3m(1) ( : W3M) . -L, --no-xmllint asciidoc xmllint(1). ---epubcheck EPUB epubcheck(1). -n, --dry-run . -r, --resource=RESOURCE_SPEC . . (RESOURCES) . -m, --resource-manifest=FILE FILE ( ). FILE --resource . . --stylesheet=STYLESHEET CSS HTML DocBook XSL Stylesheets . docbook-xsl.css . . (resource file) . HTML : xhtml epub chunked htmlhelp. -v, --verbose stderr. -v . --version stdout. --xsltproc-opts=XSLTPROC_OPTS xsltproc(1). . --xsl-file=XSL_FILE XSL XSL XSL_FILE. --fop FOP PDF. dblatex(1) . --fop-opts --fop . --fop-opts=FOP_OPTS fop(1). FOP PDF . . --dblatex-opts=DBLATEX_OPTS dblatex(1). . --backend-opts=BACKEND_OPTS --backend . . AsciiDoc . SOURCE_FILE (comment) // a2x: a2x . : // a2x default options. // a2x: -dbook --epubcheck // Suppress revision history in dblatex outputs. // a2x: --dblatex-opts "-P latex.output.revhistory=0" o . o (white space) // a2x: . o . (OUTPUT FILES) --destination-dir . --destination-dir SOURCE_FILE . SOURCE_FILE : .html xhtml .epub epub .hhp htmlhelp .pdf pdf .text text .xml docbook. (manpages) .man ( ). HTML (chunked) .chunked HTML Help .htmlhelp . . HTML xhtml epub chunked htmlhelp . (RESOURCES) ( CSS ) HTML ( xhtml epub chunked htmlhelp) . a2x HTML CSS . --resource . a2x : 1. SOURCE_FILE. 2. --resource ( ). 3. --resource-manifest ( ). 4. images stylesheets asciidoc(1) ( ). 5. . . . : 1. . 2. . --resource : [=] .= : ( SOURCE_FILE) . . ( SOURCE_FILE) . . . ( ). FORMAT ( (OUTPUT FILES) ): chunked, htmlhelp (chunked). epub OEBPS. xhtml DESTINATION_DIR. .= EPUB MIME MIME . .= MIME . MIME . : --resource ../images/ --resource doc/README.txt=README.txt --resource ~/images/tiger.png=images/tiger.png --resource .ttf=application/x-font-ttf (EXAMPLES) a2x -f pdf doc/source-highlight-filter.txt doc/source-highlight-filter.pdf. a2x -f xhtml -D ../doc --icons -r ../images/ team.txt HTML ../doc/team.html ../images/ . a2x -f manpage doc/asciidoc.1.txt doc/asciidoc.1. (REQUISITES) a2x : o Asciidoc: https://asciidoc.org o xsltproc: ( ): http://xmlsoft.org/XSLT o DocBook XSL Stylesheets ( ): https://github.com/docbook/xslt10-stylesheets o dblatex ( pdf dvi ps tex): http://dblatex.sourceforge.net o FOP ( pdf -- PDF): https://xmlgraphics.apache.org/fop o w3m ( ): http://w3m.sourceforge.net/index.en.html o Lynx ( -- ): https://invisible-island.net/lynx o epubcheck ( epub -- EPUB): https://github.com/w3c/epubcheck README . (CONF FILES) a2x.py . : 1. a2x.conf a2x.py. 2. a2x.conf AsciiDoc. ( ) . 3. a2x.conf $HOME/.asciidoc AsciiDoc. 4. CONF_FILE --conf-file. : # Optional environment variable dictionary passed to # executing programs. If set to None the existing # environment is used. ENV = None # External executables. ASCIIDOC = 'asciidoc' XSLTPROC = 'xsltproc' DBLATEX = 'dblatex' # pdf generation. FOP = 'fop' # pdf generation (--fop option). W3M = 'w3m' # primary text file generator. LYNX = 'lynx' # alternate text file generator. XMLLINT = 'xmllint' # Set to '' to disable. EPUBCHECK = 'epubcheck' # Set to '' to disable. # External executable default options. ASCIIDOC_OPTS = '' BACKEND_OPTS = '' DBLATEX_OPTS = '' FOP_OPTS = '' LYNX_OPTS = '-dump' W3M_OPTS = '-dump -cols 70 -T text/html -no-graph' XSLTPROC_OPTS = '' W3M LYNX links: http://links.twibright.com elinks: http://elinks.or.cz. LYNX_OPTS W3M_OPTS . ( -dump : w3m lynx links elinks stdout ). (BUGS) BUGS AsciiDoc . (AUTHORS) a2x Stuart Rackham . . (RESOURCES) : https://github.com/asciidoc/asciidoc-py3 : https://asciidoc.org (SEE ALSO) asciidoc(1) (COPYING) Copyright (C) 2002-2013 Stuart Rackham. Copyright (C) 2013-2022 AsciiDoc Contributors. (GNU General Public License) (Free Software Foundation) ( ) . . . 07/17/2024 A2X(1)