19th July 2022 at 3:29pm
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」以降の説明です。