<?xml version='1.0' encoding='Shift_JIS' ?>

<doc xml:lang='ja'>
<head>
<title>HTML 4.0</title>
<author>浅海 智晴</author>
<date>2001年12月11日</date>
</head>
<body>

HTML 4.0はW3Cによって仕様制定されたWeb用のマークアップ言語であり、
現在最も多く使われているバージョンです。

HTML 4.0は、伝統的なHTMLの機能に加えて、CSS(Cascading Style Sheets)による
スタイル情報の指定機能とDOM(Document Object Model)によるDynamic HTMLを
サポートしており、非常にビジュアル性の高いWebページを記述することができます。

SmartDocのHTML 4.0ジェネレータは、文書の論理的な情報のみを記述している
SmartDoc文書から、ビジュアル的な効果を付加したHTML 4.0文書を生成します。

<section title="実行">

<subsection title="デフォルト">

HTML4.0の生成はSmartDocのデフォルトなので、単に<code>sdoc</code>コマン
ドを起動するだけでHTML4.0のファイルが生成されます。

<console>
$ sdoc foo.sdoc
</console>

</subsection>

<subsection title="コマンドオプションによる指定">

コマンドラインから指定する場合には<code>-format:html4</code>を指定します。

<console>
$ sdoc -format:html4 foo.sdoc
</console>

</subsection>

<subsection title="プロパティファイルによる指定">

プロパティファイル(<code>SmartDoc.properties</code>)で指定する場合には
以下のようになります。

<program title="SmartDoc.properties">
format=html4
</program>

この設定が格納されているディレクトリ上で<code>sdoc</code>を起動すると
コマンドラインから<code>-format:html4</code>オプションを指定したのと同
じ効果を得ることができます。
なおコマンドラインとプロパティファイルの指定が競合した場合にはコマンド
ラインの指定が優先されます。

</subsection>

</section>

<section title="オプション">

<table>
<thead>
オプション,意味,デフォルト,チューニング
</thead>
<tbody>
<tr>
  <td>html4.suffix</td>
  <td>生成されたHTML4.0ファイルのサフィックス</td>
  <td>html</td>
  <td></td>
</tr>
<tr>
  <td>html4.encoding</td>
  <td>HTML4.0ファイル生成時のエンコーディング。デフォルトでは英語/フランス語/ドイツ語はISO 8859-1、日本語はShift JIS、中国語簡体字はGB2312、中国語繁体字はBig5、それ以外の言語ではUTF-8になります。</td>
  <td>UTF-8;en:ISO-8859-1;ja:Shift_JIS;fr:ISO-8859-1;de:ISO-8859-1;zh_TW:Big5;zh_CN:GB2312</td>
  <td></td>
</tr>
<tr>
  <td>html4.langDir</td>
  <td>複数のロケールを出力する場合に相互にリンクを貼るか否かの指定</td>
  <td>true</td>
  <td></td>
</tr>
<tr>
  <td>html4.powered</td>
  <td>「Powered by SmartDoc」をページの右上に表示</td>
  <td>true</td>
  <td></td>
</tr>
<tr>
  <td>html4.dtd.type</td>
  <td>DTDのタイプの指定(strict/transitional)</td>
  <td>transitional</td>
  <td>transitionalの方が若干運用性に勝ります</td>
</tr>
<tr>
  <td><a href="HTML4CSS_ja.html">html4.css.url</a></td>
  <td>使用するスタイルファイル。デフォルトではSmartDocのデフォルトのス
  タイルファイルが使用される。</td>
  <td>(未設定)</td>
  <td rowspan="2">実運用時にはhtml4.css.includeをlinkにしておいて、html4.css.urlにサイトの標準のCSSを指定しておく方法がお勧めです。</td>
</tr>
<tr>
  <td><a href="HTML4CSS_ja.html">html4.css.include</a></td>
  <td>スタイルファイルの取り込み方法。embedなら<code>style</code>タグでページ内に取り込み、linkなら<code>link</code>タグでリンクする。デフォルトはembed。</td>
  <td>embed</td>
</tr>
<tr>
  <td>html4.dynamic</td>
  <td>Dynamic HTML用ハンドラの指定。デフォルトではHTML4.0/CSSによるダイナミックHTMLをサポートしているブラウザ(現時点ではIE4.0/5.0)なら動作し、それ以外のブラウザなら動作しないハンドラ(ShallowHTML4DynamicHandler)が設定されている。</td>
  <td>ShallowHTML4DynamicHandler</td>
  <td>PlainHTML4DynamicHandler(Dynamic HTMLなし)、
  DeepHTML4DynamicHandler(Dynamic HTMLなしのブラウザだと表示できない、ただし開発中)。フルパス指定でユーザ作成のハンドラを設定するのも可能。</td>
</tr>
<tr>
  <td>html4.imageFormat</td>
  <td>使用するイメージフォーマットの種類と優先度。同じ名前で異なるサフィックスのファイルがあった場合は、優先度の高いものが使用される。</td>
  <td>gif, jpeg, jpg, png</td>
  <td></td>
</tr>
<tr>
  <td>html4.titleNumber</td>
  <td>章番号や節番号を採番の有無。</td>
  <td>false</td>
  <td></td>
</tr>
<tr>
  <td>html4.nnLink</td>
  <td>古いNetscape Navigator(4.0以前)が認識できるリンク情報を生成。</td>
  <td>false</td>
  <td></td>
</tr>
</tbody>
</table>

</section>

<section title="CSSの指定方法">

CSS(Cascading Style Sheet)の指定に関しては以下のオプションが用意されて
います。

<ul>
<li>html4.css.include</li>
<li>html4.css.url</li>
</ul>

<subsection title="html4.css.include">

html4.css.includeはCSSの取り込み方法を指定します。
embedを指定すれば<code>STYLE</code>タグでページ内に埋め込み、linkを指
定すれば<code>LINK</code>タグでページからリンクされます。
デフォルトはembedです。

コマンドラインからlinkに指定したい場合には次のようになります。

<console>
$ sdoc -html4.css.include:link foo.sdoc
</console>

プロパティファイルでは以下のような指定になります。

<program title="SmartDoc.properties">
html4.css.include=link
</program>

</subsection>

<subsection title="html4.css.url">

html4.css.urlオプションは使用するCSSの場所を指定します。
デフォルトはSmartDocのデフォルトの設定が使用されます。

コマンドラインからは以下のような指定になります。

<console>
$ sdoc -html4.css.url:foo.css foo.sdoc
</console>

プロパティファイルでは以下のような指定になります。

<program title="SmartDoc.properties">
html4.css.url=foo.css
</program>

</subsection>

<subsection title="運用時のヒント">

SmartDocのデフォルトの設定だと、SmartDocの用意したCSSが生成されるペー
ジに埋め込まれます。

実運用時にはhtml4.css.includeをlinkにしておいて、html4.css.urlにサイト
の標準のCSSを指定しておく方法がお勧めです。

</subsection>

</section>

</body>
</doc>
