2021-09-03 21:09:11 +01:00
|
|
|
# asciidoctor
|
|
|
|
|
2024-02-14 20:25:13 +00:00
|
|
|
> Convert AsciiDoc files to a publishable format.
|
2021-09-03 21:09:11 +01:00
|
|
|
> More information: <https://docs.asciidoctor.org>.
|
|
|
|
|
|
|
|
- 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}}`
|