% a2x
Usage: a2x [OPTIONS] SOURCE_FILE
A toolchain manager for AsciiDoc (converts Asciidoc text files to other file
formats)
Options:
--version show program's version number and exit
-h, --help show this help message and exit
-a ATTRIBUTE, --attribute=ATTRIBUTE
set asciidoc attribute value
--asciidoc-opts=ASCIIDOC_OPTS
asciidoc options
--copy DEPRECATED: does nothing
--conf-file=CONF_FILE
configuration file
-D PATH, --destination-dir=PATH
output directory (defaults to SOURCE_FILE directory)
-d DOCTYPE, --doctype=DOCTYPE
article, manpage, book
-b BACKEND, --backend=BACKEND
name of backend plugin
--epubcheck check EPUB output with epubcheck
-f FORMAT, --format=FORMAT
chunked, epub, htmlhelp, manpage, pdf, text, xhtml,
dvi, ps, tex, docbook
--icons use admonition, callout and navigation icons
--icons-dir=PATH admonition and navigation icon directory
-k, --keep-artifacts do not delete temporary build files
--lynx use lynx to generate text files
-L, --no-xmllint do not check asciidoc output with xmllint
-n, --dry-run just print the commands that would have been executed
-r PATH, --resource=PATH
resource file or directory containing resource files
-m FILE, --resource-manifest=FILE
read resources from FILE
--resource-dir=PATH DEPRECATED: use --resource
-s, --skip-asciidoc DEPRECATED: redundant
--stylesheet=STYLESHEET
HTML CSS stylesheet file name
--safe DEPRECATED: does nothing
--dblatex-opts=DBLATEX_OPTS
dblatex options
--backend-opts=BACKEND_OPTS
backend plugin options
--fop use FOP to generate PDF files
--fop-opts=FOP_OPTS options for FOP pdf generation
--xsltproc-opts=XSLTPROC_OPTS
xsltproc options for XSL stylesheets
--xsl-file=XSL_FILE custom XSL stylesheet
-v, --verbose increase verbosity
% a2x --format=text --destination-dir=/tmp /usr/doc/documentation/content/en/books/handbook/book.adoc
a2x: WARNING: --destination-dir option is only applicable to HTML and manpage based outputs
% du -h book.xml
2.4M book.xml
% rm book.xml
% pwd
/tmp
% a2x --format=text --destination-dir=/tmp --lynx /usr/doc/documentation/content/en/books/handbook/book.adoc
a2x: WARNING: --destination-dir option is only applicable to HTML and manpage based outputs
% du -h book.text.html
2.2M book.text.html
% head -n 10 book.text.html
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="generator" content="AsciiDoc 10.1.3">
<title></title>
</head>
<body>
<p>---
title: FreeBSD Handbook
% lynx -dump ./book.text.html > /usr/home/grahamperrin/Documents/IT/BSD/FreeBSD/FreeBSD\ handbook.txt
% cd
% amfora Documents/IT/BSD/FreeBSD/FreeBSD\ handbook.txt
%
don't intend to run any of it for myself.