イントロダクション

あなたはこれから何らかのオンライン・ハイパーテキストを書こうと(あるいは生成しようと)しています。ハイパーテキストというのは、いろいろなことができるので、ちょっと怖じ気付いてしまうかも知れませんね。ご心配なく。好きなようにシンプルなドキュメントを書けばよいのです。いろんな意味で、シンプルなほどより良いのですから。

これから別々に分かれた多くのファイルを書くことでしょう。それらのファイルはお互いに、あるいは外部の文書とリンクし合い、最終的な作品を構成することになります。

あなたの作品は「ドキュメント」と考えて良いでしょう。紙の場合はそれをその通り呼びますが、オンラインの場合は個々のファイルをドキュメントと呼ぶことが多いようです。本との対比でいえば、ドキュメントは一つの章や節に、あるいは脚注に相当します。このガイドにおいては、その全体を作品と呼ぶことにします。

ドキュメントは情報を取り上げる単位です。どんな時点においても、一つのドキュメントは利用者のコンピュータに完全に読み込まれます。また普通は、ドキュメントとはあなたが一度に編集する分量でもあります。もっとも、優れたエディタを使えば、同時に複数のドキュメントを開いておくことはできるでしょうけどね。

このガイドは、ストラクチャについての章では、手持ちの材料をどうやってドキュメントにまとめるかということについて考えます。別の章では、材料を ドキュメントの内部できちんとまとめる方法について考えます。