PART 04 — 要素の表記方法
リスト・表・コードブロック・画像・admonition

// 箇条書き（* の数でネストの深さを表現）
* 項目A
* 項目B
** 項目B-1（ネスト）
** 項目B-2（ネスト）
* 項目C

// 番号付きリスト（. の数でネスト、番号は自動採番）
. 手順1：環境を準備する
. 手順2：ファイルを作成する
.. サブ手順2-1
.. サブ手順2-2
. 手順3：変換コマンドを実行する

// 説明リスト（用語 :: 説明）
AsciiDoc:: 軽量マークアップ言語の一種。
Asciidoctor:: AsciiDocの変換エンジン。Ruby実装。
xref:: 相互参照を行うためのマクロ。

[cols="1,2,1", options="header"]
|===
|項目 |説明 |必須

|name
|ユーザー名を指定する
|○

|email
|連絡先メールアドレスを指定する
|×
|===

[source,python]
----
def greet(name: str) -> str:
    return f"Hello, {name}!"

print(greet("AsciiDoc"))
----

// 行番号を表示する場合
[source,python,linenums]
----
import sys
print(sys.version)
----

// インラインコードはバッククォート1つ
本文中では `pip install asciidoctor` のように書きます。

// ブロック画像（独立した図として表示、キャプション付き）
.システム構成図
image::img/architecture.png[システム構成図,600,400]

// インライン画像（文中に埋め込み、アイコンなどに使う）
ステータスは image:img/ok-icon.png[OK,16,16] のように表示されます。

// 画像の役割：alt="説明文", width, height の順で指定

NOTE: これは補足情報です。読み飛ばしても本筋には影響しません。

TIP: 作業を効率化するコツです。

IMPORTANT: 見落とすと後工程で問題になる重要事項です。

WARNING: 実行すると元に戻せない操作の前に置きます。

CAUTION: 一時的な不具合やデータ破損の可能性がある操作に使います。

// 複数行にわたる場合はブロック形式で書く
[NOTE]
====
複数段落にわたる長い補足説明も、
====で囲むことでまとめて1つのadmonitionにできます。
====