From f8f6ab6e4f5bb55d04f30c17e91a10fe852ebbab Mon Sep 17 00:00:00 2001 From: Miles Glapa-Grossklag Date: Fri, 3 Sep 2021 13:09:11 -0700 Subject: [PATCH] asciidoctor: add page (#6455) --- pages/common/asciidoctor.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 pages/common/asciidoctor.md diff --git a/pages/common/asciidoctor.md b/pages/common/asciidoctor.md new file mode 100644 index 0000000000..b071f9d7b4 --- /dev/null +++ b/pages/common/asciidoctor.md @@ -0,0 +1,20 @@ +# asciidoctor + +> A processor that converts AsciiDoc files to a publishable format. +> More information: . + +- Convert a specific `.adoc` file to HTML (the default output format): + +`asciidoctor {{path/to/file.adoc}}` + +- Convert a specific `.adoc` file to HTML and link a CSS stylesheet: + +`asciidoctor -a stylesheet={{path/to/stylesheet.css}} {{path/to/file.adoc}}` + +- Convert a specific `.adoc` file to embeddable HTML, removing everything except the body: + +`asciidoctor --embedded {{path/to/file.adoc}}` + +- Convert a specific `.adoc` file to a PDF using the `asciidoctor-pdf` library: + +`asciidoctor --backend={{pdf}} --require={{asciidoctor-pdf}} {{path/to/file.adoc}}`