「Asciidoc」の版間の差分
コメント機能 |
→エスケープシーケンス: 敬体と常体 |
||
103 行 | 103 行 | ||
もし、こめ印そのものを表示したいのに、箇条書きと認識して反応してしまう場合、エスケープシーケンス「\」を先頭につけくわえるなどすればいい。他の制御文字も、だいたい同様の対処法で上手く行くらしい。 |
もし、こめ印そのものを表示したいのに、箇条書きと認識して反応してしまう場合、エスケープシーケンス「\」を先頭につけくわえるなどすればいい。他の制御文字も、だいたい同様の対処法で上手く行くらしい。 |
||
なお、asciidoc のエスケープシーケンスは、バックスラッシュ「\」で |
なお、asciidoc のエスケープシーケンスは、バックスラッシュ「\」である。他の多くの言語でもエスケープシーケンスはバックスラッシュであるので、プログラマー基礎知識として覚えよう。 |
||
「エスケープシーケンス」とは何かについては、手短かに言うと、制御文字そのものを、制御文字としてではなく、単なる表示文字として出力させたい場合に使う特別な制御文字のことがエスケープシーケンスで |
「エスケープシーケンス」とは何かについては、手短かに言うと、制御文字そのものを、制御文字としてではなく、単なる表示文字として出力させたい場合に使う特別な制御文字のことがエスケープシーケンスである。 |
||
「エスケープシーケンス」とは何かについては、これ以上は詳しくは説明し |
「エスケープシーケンス」とは何かについては、これ以上は詳しくは説明しない。標準的なプログラム言語の入門書に書いてある。 |
||
なお、エスケープシーケンスそのものを表示したい場合、2つ続けて「//」のように入力することで、だいたい、どの言語でも上手く表示され |
なお、エスケープシーケンスそのものを表示したい場合、2つ続けて「//」のように入力することで、だいたい、どの言語でも上手く表示されるだろう。 |
||
== コメント機能 == |
== コメント機能 == |
2022年5月31日 (火) 04:45時点における版
何のためのソフトか
対象者は、
- テキストエディタだけだと、表とか表示できなくて不満。
- かといって、ワードとかだと、テキストエディタで編集できなくて不満。
- そこで、HTMLみたいに、テキストエディタで編集できて、なおかつwebブラウザなどで表示できるソフトが欲しい
と思う人向け。
なので、このasciidoc は、拡張子「adoc」のテキストファイルをHTMLに変換するソフトがついている。
なお、「だったら、じゃあHTMLを直接編集すれで十分では? asciidocは不要では?」と思う人は、そうすればいい。
実際、今、あなたが読んでいるwikiでも、asciidocなど使わないで編集されている。
準備と基本の操作方法
インストール方法
Fedora の場合、コマンド
sudo dnf install asciidoc
をする必要がある。(これだけで十分かどうかは未確認。)
asciidoc とは別に、派生ソフトで asciidoctor というのがあるが、微妙に仕様の異なる別ソフトである。
本書では asciidoc のほうを説明する。
短い方の asciidoc は Python で実装されている。
長い方の asciidoctor は Ruby で実装されている。
出力方法
HTMLに出力したい場合、コマンド
asciidoc ファイル名.adoc
である。
何も出力形式を指定しない場合、HTMLファイルが新規に出力される。ソースのadocファイルはそのまま残る。
たとえば、ファイル名が拡張子込みで「sample.adoc」なら、コマンドは
asciidoc sample.adoc
となる。
なお、adocファイルそのものは、テキストエディタを使って、ユーザー個人で作成することになる。
ともかく上記コマンドでファイル「sample.html」が作成されるので、あとはこれを通常のwebブラウザで閲覧すれば、閲覧できる。
- 注意1
実行環境によって、表示が多少、違う可能性があります。
- 注意2
また、本wikiでの表示は、実際のasciidocの表示とは、微妙に異なります。
asciidocで作成されるHTMLファイルのソースコードが長いので、本wikiではソースの短縮のために(wikiサーバーの負担軽減のためです)、擬似的にwikiで似た表示を再現しているので、実際のasciidocとの表示とは差異があります。
文法
見出しの作りかた
文頭に「==」を加えると、見出しになる。
例えば、今、あなたの見ているwikiみたいな見出しをasciidocで表示したいなら、
== 文法 === 見出しの作りかた
である。
もっとも、asciidoc は別に百科事典サイトを作るソフトではないので、表示結果に編集機能だとかは無く、結果は単に文字が大きく表示されるだけだが。
ともかく、上記ソースをHTML化すれば、おおむね
文法
見出しの作りかた
のような結果がブラウザ上で表示されるだろう。
箇条書き
こめ印「 * 」 を使って、箇条書きを作れる。
* 箇条書きの出だし ** ああああ *** いいい
実行結果
- 箇条書きの出だし
- ああああ
- いいい
このように、箇条書きは、Wiki文法とだいたい同じ。
エスケープシーケンス
もし、こめ印そのものを表示したいのに、箇条書きと認識して反応してしまう場合、エスケープシーケンス「\」を先頭につけくわえるなどすればいい。他の制御文字も、だいたい同様の対処法で上手く行くらしい。
なお、asciidoc のエスケープシーケンスは、バックスラッシュ「\」である。他の多くの言語でもエスケープシーケンスはバックスラッシュであるので、プログラマー基礎知識として覚えよう。
「エスケープシーケンス」とは何かについては、手短かに言うと、制御文字そのものを、制御文字としてではなく、単なる表示文字として出力させたい場合に使う特別な制御文字のことがエスケープシーケンスである。
「エスケープシーケンス」とは何かについては、これ以上は詳しくは説明しない。標準的なプログラム言語の入門書に書いてある。
なお、エスケープシーケンスそのものを表示したい場合、2つ続けて「//」のように入力することで、だいたい、どの言語でも上手く表示されるだろう。
コメント機能
一般のプログラム言語などのコメント機能と同様に、実行結果では表示しないテキストである「コメント」を、ソースファイルであるadocファイルに加えることができる。
「コメント」と言っても、べつにSNSみたいに意見を投稿するわけではないので、誤解の無いよう。
行の初めに
// 以下、行末まで表示されない
でadocのコメントになる。
傍注・脚注などの追加
たとえば 「[1]」 みたいな傍注・脚注みたいなのを、asciidoc 用語ではフットノートと言う。
以降のwiki側の処理のため、いったん脚注をクリアする。
- ^ ああああ
↑ 脚注クリア。
さて、asciidocでフットノートを表示するにはキーワード「 \footnote:[] 」を使えばいい。
ソース例
ルビーは赤い。footnote:[ルビーとは宝石のこと] ジャバは黒い.footnote:disclaimer[コーヒー豆でジャバというのがある] ジャバは外国産.footnote:disclaimer[]
- 実行結果
ルビーは赤い。[1]
ジャバは黒い.[2]
ジャバは外国産.[3]
(※以上、実行結果)
そして、ブラウザのページ最下部には、
のような脚注がある。
なお、番号のナンバリングとか微妙に実行結果とwikiが違うかもしれないが、wiki側の編集の都合。