「Asciidoc」の版間の差分

 

 

 

 

Markdown については文法が異なるので、このページでは解説しない。

次のように最近のrubyのバージョンや日付が表示されれば、成功である。日付などが最近のものでなく極端に古い場合、すでにrubyが入っている可能性がある。

 

C:\Users\ユーザー名>ruby --version

ruby 3.1.2p20 (2022-04-12 revision 4491bb740a) [x64-mingw-ucrt]

 

 

実行すれば、下記の通りである。

 

C:\Users\ユーザー名>gem install asciidoctor

Fetching asciidoctor-2.0.17.gem

Done installing documentation for asciidoctor after 17 seconds

1 gem installed

 

上記コマンドを実行して、asciidoctorをインストールできたと思ったら、念のためバージョン確認をしよう。

 

C:\Users\ユーザー>asciidoctor --version

Asciidoctor 2.0.17 [https://asciidoctor.org]

crt]) (lc:Windows-31J fs:UTF-8 in:UTF-8 ex:UTF-8)

 

 

 

なので、とりあえず、asciidoctor で表を描くサンプルコードを下記に。

 

.おもな税金

|===

|たばこ税

|===

 

 

のような表を作りたい場合、

 

.おもな税金

|===

|たばこ税

|===

 

である。

例えば、今、あなたの見ているwikiみたいな見出しをasciidocで表示したいなら、

 

== 文法

 

=== 見出しの作りかた

 

である。

 

 

== レベル1

 

=== レベル2

 

のように、対応している。

 

asciidoc は、そのテキスト位置での見出しのレベルを数えている。なので、下記はエラーになる。

=== レベル2

 

== レベル1

 

 

いっぽう、

== レベル1

 

=== レベル2

 

は正常に動作するだろう。

 

たとえば

= 今日の予定

晩ご飯はカレーにしよう。

 

だったら、タブのタイトル欄に「今日の予定」と表示されるだろう。

 

いっぽう、

これはエラーになるか、危険。

 

晩ご飯はカレーにしよう。

= 今日の予定

 

のように、1行目以外で、レベル0　を使うと、エラーになる。

こめ印（アスタリスク）「 * 」 を使って、箇条書きを作れる。

 

* 箇条書きの出だし

** ああああ

*** いいい

 

実行結果

 

ソース

. ひとよの生き血をすすり

. ふらちな悪行ざんまい

. 右にもハゲがある

 

表示結果

1.ひとよの生き血をすすり

2.ふらちな悪行ざんまい

3.右にもハゲがある

 

ソースでは、ピリオドと見出し名のあいだに半角スペースが必要。

 

半角スペースが無い場合に、太字にさせたい場合は、

*太字A* と **太字B** と**太字C**

 

のように「**」と2つ続ければいい。

同様に、斜体（イタリック体）は、アンダーバー「_」で囲めばいい。

 

_斜体（イタリック）_ と __斜体（イタリック） __

 

実行結果

 

ソース例

ルビーは赤い。footnote:[ルビーとは宝石のこと]

 

 

ジャバは外国産.footnote:disclaimer[]

 

;実行結果

 

コード例

:aaaa: ウィンドウズ10

 

 

{aaaa} はマイクロソフト社の製品のはずです。

 

結果

ウィンドウズ10 での動作確認済みです。

 

ウィンドウズ10 はマイクロソフト社の製品のはずです。

 

たとえば、もし誤記で「ウィンドウズ9」と書き間違えても、定数の定義の行だけを書き直せば、定数の各所の呼び出し先では、書き直す必要が無い。これは、定数の利用回数が増えるほど、編集の効率が高まる。

 

コード例

:icons: font

 

====

 

 

=== キーボードアイコン画像の挿入 ===

 

コード例

:experimental:

 

kbd:[Ctrl] + kbd:[C] でクリップボードにコピーします。

 

 

== スタイルシート ==