README.adoc

docker-asciidoctor-jp

Asciidoctor docker container で日本語が使えるようカスタマイズしたdocker-asciidoctor-jpをベースにしたDockerコンテナです。

何ができるか

• AsciidocテキストをHTML/PDF/EPUB3/mobiへ変換する

  • 図形の描画

    • Graphviz

    • PlantUML

    • ditaa

    • mermaid 7.0.9

    • blockdiag(seqdiag/actdiag/nwdiag)

  • シンタックスハイライト(CodeRay/Pygments/highlightjs/prettify)

• Reveal.jsのプレゼンテーションを作成する

• その他(docker-asciidoctor参照)

環境

• Asciidoctor 1.5.6.1

• asciidoctor-pdf (alpha)

• Asciidoctor-epub3 (alpha)

• asciidoctor-fopub

• asciidoctor-confluence

• asciidoctor-revealjs

• asciidoctor-pdf-cjk-kai_gen_gothic]

• asciidoctor-stylesheet-factory

• VL Gothic

使い方

コンテナを起動

docker run --rm -it -v $(pwd):/documents htakeuchi/docker-asciidoctor-jp

PDFの生成

asciidoctor-pdf -r asciidoctor-pdf-cjk-kai_gen_gothic -a pdf-style=KaiGenGothicJP foo.adoc

HTMLの生成

asciidoctor foo.adoc

Note	必要に応じてオプションを追加してください。(-aのオプションは文書の属性として書くこともできます） 図形を含む -r asciidoctor-diagram 数式を含む -r asciidoctor-mathematical シンタックスハイライト -a source-highlighter=highlightjs スタイルシートの指定 -a stylesheet=/path/to/css/file.css

図形を含むPDFの生成

asciidoctor-pdf -r asciidoctor-diagram -r asciidoctor-pdf-cjk-kai_gen_gothic -a pdf-style=KaiGenGothicJP foo.adoc

HTMLの生成（シンタックスハイライト+スタイルシート指定)

asciidoctor -a source-highlighter=highlightjs -a stylesheet=/stylesheets/github.css foo.adoc

EPUB3の生成

asciidoctor-epub3 foo.adoc

Note	EUB3を生成する場合、いくつかのルールがあります。asciidoctor/asciidoctor-epub3 のサンプルなどを参照してください。

mobi(Kindleフォーマット）の生成

kindlegen foo.epub

プレゼンテーション用HTMLの生成(asciidocotr-revealjs)

asciidoctor-revealjs -a revealjsdir=https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0 foo.adoc

License

MIT