AsciiDocのAttributeとは？

文書の設定をするもの。

開発環境

• LinuxMint 17.3 MATE 32bit
  • rbenv
    • Ruby 2.4.0
      • AsciiDoctor
  • Firefox
    • AsciiDoc ビューア
  • pluma
    • AsciiDoc ハイライト

前回まで

ブログを書くのにAsciiDocを使いたい。

• AsciiDoctorでcoderayを使いシンタックスハイライトする
• AsciiDoctorのドキュメントを探してみた
• AsciiDocの拡張子は？

横着して使ってみるも、やりたいことができず。

• AsciiDoctorでCSSを外部化したいが理解が追いつかなかった

AsciiDocの仕様などわからないことだらけ。資料を読んで理解するしかないと悟る。

AsciiDoctorのドキュメント

http://asciidoctor.org/docs/

翻訳

メタデータ

AsciiDoctorでcoderayを使いシンタックスハイライトするとき、ハイライトに使うツールを指定した。

:source-highlighter: coderay

AsciiDoc Syntax Quick Reference | Asciidoctor

Syntax highlighting is enabled by setting the source-highlighter attribute in the document header or passed as an argument.

このコロンではじまる記述、どうやらAsciiDoctorのメタデータを指示するものらしい。Attributeという概念のようだ。Attributeの一覧が欲しい。

Attributes

Syntaxクイックリファレンスがあった。その一部にAttributesの項がある。

http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/#attributes-and-substitutions

• Predefined attributes for character replacements
• Environment attributes
• Counter attributes

Attributesに属するものは上記3種類あるらしい。私がイメージしていたのはEnvironment attributesだと思う。記法が同じだから。しかし一覧にない。

リンクがあるので後はソースコードasciidoc.confを見ろということか？source-highlighterの文字列は存在したが、よくわからなかった。

Environment attributes

:homepage: http://asciidoctor.org

homepage url is {homepage}.

たぶんSyntaxリファレンスの一覧にあった:homepage:などは予約されたものなのだろう。ユーザが独自に作れるのか？わからん。

所感

とりあえずハイライトについてもう少し詳しく知りたい。