かんがるーさんの日記

最近自分が興味をもったものを調べた時の手順等を書いています。今は Spring Boot をいじっています。

AsciiDoc&Asciidoctor&Antora 覚書(大目次)

Translate to English
https://translate.google.com/translate?sl=auto&tl=en&u=https%3A%2F%2Fksby.hatenablog.com%2Fentry%2F2021%2F01%2F06%2F003727

GitHub
https://github.com/ksby/ksbysample-asciidoctor
https://github.com/ksby/ksbysample-antora
https://github.com/ksby/ksbysample-antora-playbook

  1. Asciidoctor+Gradle の環境で AsciiDoc 形式のドキュメントから HTML ファイルを生成してみる
  2. include directive で章毎に adoc ファイルを分けてみる
  3. include directive で adoc ファイルを分ける時に AsciiDoc Plugin の preview が表示されるようにする
  4. TOC(Table of Contents)を自動生成して表示させる
  5. Antora で AsciiDoc 形式のドキュメントが保存されたレポジトリからドキュメントサイトを生成してみる
  6. Asciidoctor Diagram を使用して AsciiDoc 形式のドキュメントに PlantUML の図を埋め込む
  7. PlantUML の図を生成するモジュールを Asciidoctor Diagram → Kroki に変更する
  8. PlantUML 以外の diagram を AsciiDoc のドキュメントに埋め込んで見る(bpmn、bytefield 編)
  9. PlantUML 以外の diagram を AsciiDoc のドキュメントに埋め込んで見る(ditaa、C4 model 編)
  10. Antora で PlantUML 等の diagram を埋め込む
  11. Antora で生成するドキュメントサイトに antora-lunr で検索機能を追加する