初学者の時の経験ですが、説明文やプログラムの理解に苦労しました。それは、表記されている「単語」がプログラムで使う予約の様に固定されて決まっている単語なのか、それとも特別な意味ないので自由に変更して良いのか、つまりプログラマが勝手に変更しても用のかでした。今では当たり前の様に認識していますが最初は理解に苦労しました。
このwebでは可能な限り、以下の様にしたいと思います。たたじ、文書の流れで分かる場合は、省略します。
表示例 |
文字修飾 |
通常の説明や解説 |
プログラム説明等で利用 |
word |
無し |
一般的な名詞 |
言語の予約語、予め指定されている単語 |
word |
斜体 |
説明に利用する例示 |
ユーザが文法の範囲で変更できる文字 |
word |
太字 |
重要な部分 |
複数の選択しがある予約語or指定語 |
word |
太字斜体 |
|
|
<word> |
<>括り |
|
省略可能な単語 |
「word」 |
「」括り |
本書独自の意味のことば、一般的な意味と異なる単語 |
|
(word) |
()括り |
前の単語等の補足等 |
|
[word] |
|
|
|
"word" |
|
|
|
|