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

<doc xml:lang='ja'>
<head>
<title>プレインテキスト</title>
<author>浅海 智晴</author>
<date>2001年12月16日</date>
</head>
<body>

<section title="実行">

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

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

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

</subsection>

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

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

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

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

</subsection>

</section>

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

<table>
<thead>
オプション,意味,デフォルト,チューニング
</thead>
<tbody>
<tr>
  <td>plain.suffix</td>
  <td>生成されたテキストファイルのサフィックス</td>
  <td>txt</td>
  <td></td>
</tr>
<tr>
  <td>plain.encoding</td>
  <td>テキストファイル生成時のエンコーディング。デフォルトでは英語/フランス語/ドイツ語は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>plain.width</td>
  <td>テキストの横幅(半角文字数)</td>
  <td>70</td>
  <td></td>
</tr>
<tr>
  <td>plain.keisen</td>
  <td>使用する罫線。asciiはASCII文字の範囲で罫線を描画、jisはJIS罫線を使用</td>
  <td>ascii</td>
  <td></td>
</tr>
</tbody>
</table>

</section>

<section title="サフィックス">

サフィックスの変更は<tt>plain.suffix</tt>オプションで指定します。

</section>

<section title="文字エンコーディング">

文字エンコーディングは<tt>plain.encoding</tt>オプションで指定します。

指定しない場合には、<code>xml:lang</code>で指定されるドキュメントの言語によって
適切な文字エンコーディングが自動選択されます。

ただし、日本語(<code>ja</code>, <code>ja_JP</code>)の場合は、Shift_JISが
デフォルトのコード系になっているので、この点は注意が必要です。
一般にUNIXのコード系はEUC-JPなので、デフォルト値と相性が悪くなっています。
UNIXでお使いの場合は、文字エンコーディングを陽に指定するようにしてください。

</section>

<section title="横幅">

テキスト出力の横幅は<tt>plain.width</tt>オプションで指定します。

</section>

<section title="罫線モード">

罫線モードは<tt>plain.keisen</tt>オプションで指定します。

指定できる値は以下の2つです。

<dl>
  <dt>ascii</dt>
  <dd>ASCIIコードの範囲で罫線を描画(デフォルト)</dd>
  <dt>jis</dt>
  <dd>JIS罫線を使って罫線を描画</dd>
</dl>

asciiモードは、ASCIIコードの範囲で罫線を描画します。

jisモードは、JIS罫線を使って罫線を描画します。
JIS罫線に使用する文字はUnicodeでも定義されているので、
Unicode環境であれば日本語以外の文書に対しても使用することができます。

<program src="src/plain/sample_ascii.txt" id="prog:sample_asciiTxt" title="ASCII罫線モード" encoding="Shift_JIS"/>

<program src="src/plain/sample_jis.txt" id="prog:sampleJisTxt" title="JIS罫線モード" encoding="Shift_JIS"/>


</section>

</body>
</doc>
