memomem

備忘録・メモ置き場

AsciiDoc ことはじめ

ドキュメントを簡単に書いてpdfやhtmlに出力したいと思い調べる。

調べるとAsciidoc というものがある。markdownを拡張したようなもっと多機能。

visualStudioCodeでは、 Visual Studio Code拡張機能で、AsciiDoc を検索し入れれば良い。

ある程度markdownとの互換性もあるので、.mdで書いた物をhtml, pdfに書き出すだけでも使えそう。

あとは書類の拡張子を .adoc でドキュメント記載して [Command Palette] から [AsciiDoc: Save HTML Document] や [AsciiDoc: Export document as PDF]などを選べば書き出し完了。

こんな感じの設定を書類の頭に入れて諸々書類の設定ができる。

:lang: ja
:doctype: book
:toc: left
:toclevels: 3
:toc-title: 目次
:sectnums:
:sectnumlevels: 3
:sectlinks:
:data-uri: ./images
:imagesdir: ./images
// css を外部参照する
// :linkcss:
:stylesdir: ./stylesheets
:stylesheet: style.css
:icons: font
:source-highlighter: highlightjs
:highlightjs-theme: atom-one-dark

qiita.com

qiita.com

qiita.com

takumon.github.io

asciidoctor-pdfでかっこいいPDFを作る(1) - Qiita