410
@410

Are you sure you want to delete the question?

If your question is resolved, you may close it.

Leaving a resolved question undeleted may help others!

We hope you find it useful!

AsciiDocの角括弧の記法はどういう記法でしょうか?

例えばこういう文章です。

[preface]
Example Preface
---------------
Optional preface.

[dedication]
Example Dedication
------------------
Optional dedication.

[qanda]
.Q&A
質問 1::
    回答 1
質問 2:: 回答 2

このような角括弧の記法の機能について教えてください。

AsciiDocの角括弧の記法について特に説明を解説しているサイトが見つからなかったので質問した次第です。

ちなみに、上記の角括弧の記法は、
link:index.html[ドキュメント]

〜〜 [.small]#小さい活字# 〜〜〜
のような角括弧の使われ方と同じ記法でしょうか?


また、

[%hardbreaks]
段落にhardbreaksを指定するとテキスト上での改行が、
そのまま改行として表示されます。

や、

[.lead]
この段落は、第一段落のスタイル(文字が大きいスタイル)が適用されます。

のように、角括弧内の1文字目が%.を指定するのはそれぞれに何か意味やルールがありますか?

0

1Answer

[] は属性リスト記法です。ブロック要素やインライン要素に属性を付与することができます。 1

例: [attr1,attr2,named_attr="value"]

ご質問の

[preface]
Example Preface

[.small]#小さい活字# はどちらも属性リストです。

link:index.html[ドキュメント] は別の記法で、 [] の中にはリンクのテキストを書きます。ただし、この [] の中のテキストが ,= を含む場合、その部分だけが属性リストとして解釈されます。2

[.xxx] はロール属性で、 [role="xxx"] の省略記法です。ロールは主に要素の振る舞いを変化させます。3

[%xxx] はオプション属性で、 [options="xxx"] の省略記法です。オプションの意味は様々です。4

  1. Element Attributes :: Asciidoctor Docs

  2. Role Attribute :: Asciidoctor Docs

  3. Options Attribute :: Asciidoctor Docs

0Like

Comments

  1. @410

    Questioner

    3つ全ての質問に丁寧に回答していただき感謝いたします。参考になりました。返信が遅れて恐縮です。

Your answer might help someone💌