asciidoctorには、種々の属性(Attribute)があり、ユーザーが変更することができます。AsciiDoc形式のファイルの先頭で記述することが多いです。
属性は以下のように記述します。
:属性名: 属性値
もしくは、以下のように値無しで記述する場合があります。「属性ON」、「値無し」の設定になります。
:属性名:
属性の例を以下にあげます。(参考)
属性名 | 内容 |
---|---|
:lang: | 言語 |
:doctype: | 文書の種類(book、inline、manpage) |
:author: | 作者名 |
:revdate: | 作成日 |
:revnumber: | バージョン番号 |
:imagesdir: | 画像を保存してあるディレクトリ |
:source-highlighter: | どのシンタックスハイライトを利用するか設定する。 (rouge、coderayなど、参考) |
:icons: | 脚注のアイコン表示をしたい場合は、fontと記述する。 |
:toc: | 目次の位置 (auto、left、right、macro、preamble) |
:toc-title: | 目次のタイトル |
:toclevels: | 目次に表示されるレベル (3ならレベル3まで目次に表示する) |
:sectnums: | セクション番号付けはデフォルトではOFFです。 (empty、all) |
:sectnumlevels: | セクション番号を付けるレベル (3ならレベル3までセクション番号をつける) |
:example-caption: | 例の番号に付く表示 |
:table-caption: | 表の番号に付く表示 |
:figure-caption: | 図の番号に付く表示 |
:title-logo-image: | 指定した画像をロゴにする。(参考) |
:title-page-background-image: | 指定した画像を表紙にする。(参考) |
:front-cover-image: | 指定したPDFを表紙にする。(参考) |
:pdf-themesdir: | スタイルファイルのディレクトリ(参考) |
:pdf-theme: | スタイルファイル名(参考) |
参考にしたHPは、「Asciidoctor Documentation SiteのAttribute」以降の説明です。