共通デスクトップ環境 プログラマーズ・ガイド (ヘルプ・システム編)

簡易マークアップ

簡易マークアップは、標準テキスト・エディタを使用して手動でタグ付けする設計者向けに設計されたむだを省いたタグ・セットです。簡易マークアップにはいくつかの省略方法が用意されています。まず、終了タグの使用を最小化します。たとえば、章、節、または段落には終了タグを入力する必要はありません。さらに可能であれば、中間タグは自動的に想定されます。たとえば、章と節の要素により <head> タグを省略できます。したがって、ヘッダを入力するだけで済みます。

簡易マークアップは、文体の変更だけでなく多くのインライン要素へのマークアップも簡単にできます。テキストを区切るには、開始と終了のタグを入力するよりも、次のように縦線が使用されます。

<element| ... text ... |

たとえば、次の例は前に表示した <book> 要素の略式です。

<book| Geographical Survey of Northern Wisconsin|

要素にパラメータがある場合、要素とパラメータは次のように最初の縦線の前に入力します。

<element parameters| ... text ... |

開始と終了のタグを特殊な 2 文字のショートカットで置き換えるようなさらに略した形式をサポートしている要素もあります。たとえば、<emph> (強調表示) 要素の場合、その通常の形式は次のようになります。

<emph>  ... text ... <¥emph> 

上記の形式は、次のように簡易形式を使用して入力することもできます。

!! ... text ... !!

第 3 章「ヘルプ・トピックの記述」 では、簡易マークアップを紹介し、最も頻繁に使用される要素の例を示しています。第 5 章「ヘルプタグ・マークアップのリファレンス」では、要素をアルファベット順に並べて、各要素について詳細に説明しています。