# SmartDocクイックスタート

# SmartDoc Quick Start

浅海 智晴
ASAMI, Tomoharu
http://www.netpassport.or.jp/~wtasami
1999年9月23日
Sep. 23, 1999

# Hello World

## テキスト

## Text

もっとも単純なSmartDocドキュメントは以下のようになります。

The simplest SmartDoc document is as shown below.

ただしこれは英語の場合。 日本語の場合にはもう少しお呪いが必要に なります。

日本語ために必要な設定は以下の2つです。

- エンコーディングの指定
- 言語の指定

エンコーディングはSmartDocのテキストが使用しているコード系を指定します。 この例ではWindowsで使われているシフトJISを指定していますが、UNIXの場合 には日本語EUCを指定することになるでしょう。

コード系 | プラットフォーム | 指定
--- | --- | ---
シフトJIS | Windows 95/98/NT | Shift_JIS
日本語EUC | UNIX | EUC-JP
JIS | 電子メール | ISO2022-JP

言語の指定にはタグの属性`xml:lang`を使用します。 `ja`は日本語を表しています。 タグに指定した属性は、指定されたタグの中に配置されているタグに引き継 がれます。 この例ではルートのタグである`doc`に指定しているので、文書全 体で有効になっています。

SmartDocのドキュメントを作成するうえにおいて以上の設定の理由については 深く考える必要はありません。 単に決まり文句として覚えておけばよいでしょう。

## 実行

## Execution

SmartDocのドキュメントをHTMLやLaTeXに変換するのはSmartDocコマンドで行います。

Conversion from a SmartDoc document to HTML/LaTeX is performed using the SmartDoc command.

さきほどのテキストを`HelloWorld.sdoc`という名前で格納してあ るとします。 このテキストからHTMLを生成するのは次のようになります。

For example, the conversion of the text file `HelloWorld.sdoc` into an HTML file is as shown below:

C:\tmp>sdoc HelloWorld.sdoc

この場合は`HelloWorld.html`が生成されます。

In this case, `Helloworld.html` is created.

LaTeXを生成する場合にはformatオプションを使います。 formatオプションにパラメタとしてlatex2eを指定するとLaTeX2eのドキュメン トが生成されます。

To make a LaTeX file, the format option is used. When latex2e is specified for the parameter of the format option, a LaTeX2e document is created.

C:\tmp>sdoc -format:latex2e HelloWorld.sdoc

HTMLとLaTeXを同時に生成することもできます。

It is also possible to make both an HTML and a LaTeX file at once.

formatオプションにhtml4とlatex2eの両方を指定すると、HTML4とLaTeX2eのド キュメントが同時に生成されます。

If both html4 and latex2e are specified for the parameter of the format option, both an HTML4 and a LaTex2e document are created.

C:\tmp>SmartDoc -format:html4,latex2e HelloWorld.sdoc

# Text input

# 文章の入力

SmartDocには以下の2つの文章の入力方法があります。

SmartDoc has the following two text input methods:

- パラグラフタグ
- 自然入力

- Paragraph Tag
- Natural Input

## Paragraph Tag

## パラグラフタグ

SmartDocはHTMLと同様、パラグラフを入力するためのタグとして `p`タグを用意しています。

SmartDoc also has the `p` tag for entering paragraphs, the same as HTML.

<p> パラグラフはこのように記述します。 </p> <p> 次のパラグラフはこのようになります。この行は折り返しの効果を見るために 長ああああああああああああああああああああああああああああああああああ あああああああああああああああああああああいパラグラフになっています。 </p>
<p locale="en"> Paragraphs are written as follows: </p> <p locale="en"> This paragraph turns out like this. It is a very very very very very very very very very very very very very very very very very very very long paragraph to see the effects of wrapping. </p>

パラグラフはこのように記述します。

次のパラグラフはこのようになります。この行は折り返しの効果を見るために 長ああああああああああああああああああああああああああああああああああ あああああああああああああああああああああいパラグラフになっています。

Paragraphs are written as follows:

This paragraph turns out like this. It is a very very very very very very very very very very very very very very very very very very very long paragraph to see the effects of wrapping.

## Natural Input

## 自然入力

パラグラフタグによる入力はいかにもXMLらしい入力方法なのですが、入力が 繁雑であることは否めません。 この問題を解決するためにSmartDocではLaTeXライクな自然な入力方法を用意 しています。 SmartDocではこの入力方法を自然入力と呼びます。

Entering by paragraph tag is a very similar method to XML, but it is complicated. To simplify this, SmartDoc also has a LaTex-like input method. This method is called natural input.

自然入力は以下のルールによってパラグラフを特定します。

For natural input, a paragraph is specified as shown below:

- 空白行をパラグラフの変更とみなす

- A blank line is recognized as a paragraph change.

エディタでSmartDocのドキュメントを入力する場合、この入力方法がとても便 利なのはLaTeXをお使いの方は実感されていると思います。

It is well-known by LaTeX users that entering a document in a text editor by this method is very convenient.

自然入力の例を以下に示します。

An example of natural input is as shown below:

パラグラフはこのように記述します。

次のパラグラフはこのようになります。この行は折り返しの効果を見るために 長ああああああああああああああああああああああああああああああああああ あああああああああああああああああああああいパラグラフになっています。
Paragraphs are written as follows:

This paragraph turns out like this. It is a very very very very very very very very very very very very very very very very very very very long paragraph to see the effects of wrapping.

この入力は`p`を使った以下の入力と同じ意味を持っています。

The function of this entry is the same as `p` as shown below:

<p> パラグラフはこのように記述します。 </p> <p> 次のパラグラフはこのようになります。この行は折り返しの効果を見るために 長ああああああああああああああああああああああああああああああああああ あああああああああああああああああああああいパラグラフになっています。 </p>
<p> Paragraphs are written as follows: </p> <p> This paragraph turns out like this. It is a very very very very very very very very very very very very very very very very very very very long paragraph to see the effects of wrapping. </p>
パラグラフはこのように記述します。

次のパラグラフはこのようになります。この行は折り返しの効果を見るために 長ああああああああああああああああああああああああああああああああああ あああああああああああああああああああああいパラグラフになっています。
Paragraphs are written as follows:

This paragraph turns out like this. It is a very very very very very very very very very very very very very very very very very very very long paragraph to see the effects of wrapping.

# Section, SubSection

# セクション、サブセクション

SmartDocでは文書の論理構造を指定するためのタグとして以下の５つを用意し ています。 この構造はLaTeX2eのものと同じです。

SmartDoc has 5 tags for specifying the logical structure of documents. This structure is the same as LaTeX2e.

- part
- chapter
- section
- subsection
- subsubsection

たとえばこの「クイックスタート」の構造は次のような感じになっています。

For example, this Quick Start structure is shown as below:

<doc> <head> ...略... </head>

<body> <section title="Hello World"> <subsection title="テキスト"> ...略... </subsection> <subsection title="実行"> ...略... </subsection> </section>

...略...

</body> </doc>
<doc> <head> ...... </head>

<body> <section title="Hello World"> <subsection title="Text"> ...... </subsection> <subsection title="Execution"> ...... </subsection> </section>

......

</body> </doc>

# Title

# タイトル

文書のタイトルや著者名、作成日付は`head`に記述します。

The title, author, and date are written as `head`.

たとえばこの「クイックスタート」の`head`は以下のようになっ ています。

For example, this Quick Start `head` is shown as below:

<head> <title>SmartDoc FAQ</title> <author>浅海 智晴</author> <date>1999年7月15日</date> </head>
<head> <title>SmartDoc FAQ</title> <author>ASAMI, Tomoharu</author> <date>Sep. 15, 1999</date> </head>

# List

# リスト

SmartDocではHTMLと同じ以下の3つのリストタグを用意しています。

SmartDoc has the following three list tags, the same as HTML:

- `ul`
- `ol`
- `dl`

`ul`は番号なしのリスト、 `ol`は番号つきのリスト、 `dl`は説明つきのリストを作るために使用します。

`ul` is used to make a list without numbers, `ol` is used to make a list with numbers, `dl` is used to make a list with explanations.

いずれの場合も使い方はHTMLと同じです。

In each case, the method is the same as HTML.

`ul`と`ol`のリストの項目は`li`タグを使います。 これもHTMLと同じです。

`li` tag is used for the items of the `ul` and `ol`, the same as HTML.

ただしXMLとHTMLの文法の違いによって若干違いがあります。 HTMLでは`li`タグはリスト項目の先頭にあればよかったのですが、 XMLでは要素は必ずタグで囲まなければならないのでその点に注意が必要です。

However, there are minor differences between the syntax of XML and HTML. In the HTML, the `li` tag only needs to be located of the beginning of the list item, but in XML, the element must be enclosed by tags.

`dl`では`dt`タグと`dd`タグによって要素を記述します。 これもHTMLと同じ。

`dl` elements are written with the `dt` tag and the `dd` tag. This is also the same as HTML.

## ul

`ul`は番号なしのリストを記述するためのタグです。

`ul` is the tag for writing a list without numbers.

<ul> <li>最初の項目</li> <li>次の項目</li> <li>その次の項目</li> </ul>
<ul> <li>First item</li> <li>Second item</li> <li>Third item</li> </ul>

- 最初の項目
- 次の項目
- その次の項目

- First item
- Second item
- Third item

## ol

`ol`は番号つきのリストを記述するためのタグです。

`ol` is the tag for writing a list with numbers.

<ol> <li>最初の項目</li> <li>次の項目</li> <li>その次の項目</li> </ol>
<ol> <li>First item</li> <li>Second item</li> <li>Third item</li> </ol>

1. 最初の項目
2. 次の項目
3. その次の項目

- First item
- Second item
- Third item

## dl

`dl`は単語の定義のリストを記述するためのタグです。

`dl` is the tag for writing a list of word definitions.

<dl> <dt>最初の項目</dt> <dd>最初の説明</dd> <dt>次の項目</dt> <dd>次の説明</dd> <dt>その次の項目</dt> <dd>その次の説明</dd> </dl>
<dl> <dt>First item</dt> <dd>First explanation</dd> <dt>Second item</dt> <dd>Second explanation</dd> <dt>Third item</dt> <dd>Third explanation</dd> </dl>

最初の項目
  最初の説明
次の項目
  次の説明
その次の項目
  その次の説明

First item
  First explanation
Second item
  Second explanation
Third item
  Third explanation

# Table

# 表

SmartDocでは`table`タグを使用します。 基本的な使い方はHTMLと同じですが、大幅な機能拡張が行われています。 特に木構造の表の入力やCSVによるデータ入力は非常に強力です。

SmartDoc uses the `table` tag. The fundamental usage is the same as HTML, but the functions have been greatly enhanced. It especially has great functionality for entering tree charts and CSV data.

## Basics

## 基本

まず基本的な表の使い方です。 HTML4とほとんど同じであることが分かります。

First, basic charts are similar to HTML4.

<table> <thead> <tr> <th>カラム1</th> <th>カラム2</th> <th>カラム3</th> </tr> </thead> <tbody> <tr> <td>データ1-1</td> <td>データ1-2</td> <td>データ1-3</td> </tr> <tr> <td>データ2-1</td> <td>データ2-2</td> <td>データ2-3</td> </tr> </tbody> </table>
<table> <thead> <tr> <th>Column 1</th> <th>Column 2</th> <th>Column 3</th> </tr> </thead> <tbody> <tr> <td>Data 1-1</td> <td>Data 1-2</td> <td>Data 1-3</td> </tr> <tr> <td>Data 2-1</td> <td>Data 2-2</td> <td>Data 2-3</td> </tr> </tbody> </table>

カラム1 | カラム2 | カラム3
--- | --- | ---
データ1-1 | データ1-2 | データ1-3
データ2-1 | データ2-2 | データ2-3

Column 1 | Column 2 | Column 3
--- | --- | ---
Data 1-1 | Data 1-2 | Data 1-3
Data 2-1 | Data 2-2 | Data 2-3

theadタグ、tbodyタグは見慣れない方もいらっしゃると思いますが、HTML4で 新規の導入されたタグで、テーブルの論理構造をより正確に表現するためのも のです。

The thead tag and tbody tag are not familiar. They have just been introduced in HTML4, and using them shows the table logic structure more accurately.

## Complex Tables

## 複雑な表

SmartDocではHTMLと同様に`colgroup`, `colspan`, `rowspan`を駆使した複雑な表を作成することができます。

By SmartDoc, very complex chart can be craeated with `colgroup`, `colspan`, `rowspan` ,which is like HTML.

<table title="表のサンプル"> <colgroup> <col align="left" class="key" /> </colgroup> <colgroup span="2"> <col align="center"/> <col align="right"/> </colgroup> <thead> <tr> <th>カラム(align=left,class=key)</th> <th>カラム(align=center)</th> <th>カラム(align=right)</th> </tr> </thead> <tbody> <tr> <td>データ</td> <td>データ</td> <td>データ</td> </tr> <tr> <td align="center">データ(align=center)</td> <td align="right">データ(align=right)</td> <td align="left">データ(align=left)</td> </tr> <tr> <td rowspan="2">データ(rowspan=2)</td> <td>データ</td> <td>データ</td> </tr> <tr> <td colspan="2">データ(colspan=2)</td> </tr> <tr> <td rowspan="2" colspan="2" align="center">データ(rowspan=2,colspan=2,align=center)</td> <td>データ</td> </tr> <tr> <td>データ</td> </tr> <tr> <td colspan="3" align="right">データ(colspan=3,align=right)</td> </tr> </tbody> </table>
<table title="Sample Table"> <colgroup> <col align="left" class="key" /> </colgroup> <colgroup span="2"> <col align="center"/> <col align="right"/> </colgroup> <thead> <tr> <th>Column(align=left,class=key)</th> <th>Column(align=center)</th> <th>Column(align=right)</th> </tr> </thead> <tbody> <tr> <td>Data</td> <td>Data</td> <td>Data</td> </tr> <tr> <td align="center">Data(align=center)</td> <td align="right">Data(align=right)</td> <td align="left">Data(align=left)</td> </tr> <tr> <td rowspan="2">Data(rowspan=2)</td> <td>Data</td> <td>Data</td> </tr> <tr> <td colspan="2">Data(colspan=2)</td> </tr> <tr> <td rowspan="2" colspan="2" align="center">Data(rowspan=2,colspan=2,align=center)</td> <td>Data</td> </tr> <tr> <td>Data</td> </tr> <tr> <td colspan="3" align="right">Data(colspan=3,align=right)</td> </tr> </tbody> </table>

この表は以下のように表示されます。 全くHTML4.0と一緒ですね。

This chart is shown as below. It is identical with HTML , isn't it.

カラム(align=left,class=key) | カラム(align=center) | カラム(align=right)
--- | --- | ---
データ | データ | データ
データ(align=center) | データ(align=right) | データ(align=left)
データ(rowspan=2) | データ | データ
データ(colspan=2)
データ(rowspan=2,colspan=2,align=center) | データ
データ
データ(colspan=3,align=right)

Column(align=left,class=key) | Column(align=center) | Column(align=right)
--- | --- | ---
Data | Data | Data
Data(align=center) | Data(align=right) | Data(align=left)
Data(rowspan=2) | Data | Data
Data(colspan=2)
Data(rowspan=2,colspan=2,align=center) | Data
Data
Data(colspan=3,align=right)

もちろんXMLで書いた表をHTMLで表示できるだけなら、たいしたことではない のですが、SmartDocの特筆すべき特徴は、このような複雑な表をそのまま LaTeX2eの表として再現できること。 LaTeXの表で苦労したことのある方なら、このことの価値を実感することがで きるでしょう。

Of　cource the chart written by XML can be merely displayed is not paticular function,　thouth the fantastic characteristic of SmatrDoc is that such a complex chart can be translated to the chart of LaTex2e without additional operation. It is beyond descrioption, writer who has struggled with making LaTex chart feels it tremendously.

## Tree Charts

## 木構造の表

表の中には木構造の構造を持ったデータを持つものが存在します。

Some charts have tree-structured data.

もちろん前述の方法でも`td`の`rowspan`を駆使すれば、 そのような表を作成することは可能ですが、文書の論理構造を入力するという SmartDocのコンセプトから、もう少し突っ込んだ記述方法を用意しています。

Of course, the above-mentioned entry method can also be used to prepare a tree chart by using the `rowspan` of the `td`. However, the SmartDoc concept of entering the logical structure of documents, enables a better solution.

SmartDocでは木構造のデータを`ul`と`li`の組合わせ で表現することができます。

SmartDoc allows tree-structured data to be written with the combination of the `ul` and `li`.

この`ul`と`li`の組合わせによるツリーの表現を `tbody`に記述することでツリー構造のデータを持つ表が作成され ます。

A tree chart is made by writing the combination of the `ul` and the `li` in the `tbody`.

<table title="木構造の表"> <thead> <tr> <th>大分類</th> <th>中分類</th> <th>小分類</th> </tr> </thead> <tbody> <ul> <li>動物</li>

<ul> <li>哺乳類</li> <ul> <li>犬</li> <li>猫</li> <li>馬</li> </ul>

<li>爬虫類</li> <ul> <li>蛇</li> <li>蛙</li> </ul>

<li>昆虫</li> <ul> <li>蜻蛉</li> <li>蝶</li> <li>蜂</li> <li>蟋蟀</li> </ul> </ul>

<li>植物</li> <ul> <li>針葉樹</li> <ul> <li>杉</li> </ul> </ul>

</ul>

</tbody> </table>
<table title="Tree Chart"> <thead> <tr> <th>General category</th> <th>Middle category</th> <th>Detailed category</th> </tr> </thead> <tbody> <ul> <li>Animal</li>

<ul> <li>Mammal</li> <ul> <li>Dog</li> <li>Cat</li> <li>Horse</li> </ul>

<li>Reptile</li> <ul> <li>Snake</li> <li>Frog</li> </ul>

<li>Insect</li> <ul> <li>May-fly</li> <li>Butterfly</li> <li>Bee</li> <li>Mantis</li> </ul> </ul>

<li>Plant</li> <ul> <li>Coniferous tree</li> <ul> <li>Cedar</li> </ul> </ul>

</ul>

</tbody> </table>

大分類 | 中分類 | 小分類
--- | --- | ---

- 動物

- 哺乳類

- 犬
- 猫
- 馬

- 爬虫類

- 蛇
- 蛙

- 昆虫

- 蜻蛉
- 蝶
- 蜂
- 蟋蟀

- 植物

- 針葉樹

- 杉

General category | Middle category | Detailed category
--- | --- | ---

- Animal

- Mammal

- Dog
- Cat
- Horse

- Reptile

- Snake
- Frog

- Insect

- May-fly
- Butterfly
- Bee
- Mantis

- Plant

- Coniferous tree

- Cedar

## CSV Entry

## CSVによる入力

SmartDocは表のデータをCSVで入力する機能を提供しています。

SmartDoc offers the functionality of entering chart data by CSV.

<table title="CSVの表"> <thead> カラム1,カラム2,カラム3 </thead> <tbody> データ1,データ2,データ3 データ4,データ5,データ6 データ7,データ8,データ9 </tbody> </table>
<table title="CSV Table"> <thead> Column 1,Column 2,Column 3 </thead> <tbody> Data 1,Data 2,Data 3 Data 4,Data 5,Data 6 Data 7,Data 8,Data 9 </tbody> </table>

カラム1,カラム2,カラム3
データ1,データ2,データ3 データ4,データ5,データ6 データ7,データ8,データ9

Column 1,Column 2,Column 3
Data 1,Data 2,Data 3 Data 4,Data 5,Data 6 Data 7,Data 8,Data 9

# Figure

# 図

図は`figure`タグを用いてSmartDocドキュメントに取り込みます。

Figures are inserted into SmartDoc documents by using the `figure` tag.

<figure src="sample" title="図のサンプル"/>
<figure src="sample" title="Figure Sample"/>

図のサンプル

Figure Sample

図として取り込むファイルは`src`属性で指定するのですが、以下 のものを","を区切りにして複数指定することができます。

The figure file is specified by the `src` attribute. The following files are all specified at the same time by using "," to delineate them.

- ファイル名
- ファイル名のボディ部

- File name
- Core part of the file name

ファイル名の場合はサフィックスから図のフォーマットを認識し、適切なファ イルを取り込みます。

If the file name I specified, the format of the figure is recognized by the suffix and the appropriate file is inserted.

ファイル名のボディ部のみが指定された場合には、SmartDocのターゲットの フォーマットに適した図のフォーマットを自動的に選択します。

If only the core part of the file name is specified, the format of the figure is selected automatically by the SmartDoc target format.

# Program and Console

# プログラムとコンソール

SmartDocではプログラムのソースコードとコマンド実行などコンソール入出力 を取り込むためのタグを用意しています。

SmartDoc has tags for console input/output such as program source code and command execution.

この機能を使用することでプログラムのマニュアルやソフトウェア技術に関す る記事などの執筆が非常に楽に行えるようになります。

This function simplifies writing program manuals and software technology articles.

## Program

## プログラム

プログラムと本文の内容を常に同期させておくことは結構手間のかかる作業で す。

Maintaining consistency between the program and document can be time-consuming.

動作確認の済んだプログラムをわざわざ文書内に取り込むのはあまりにもめん どくさいのでSmartDocではプログラムを外部から取り込む機能を用意しました。 もちろん本文内にプログラムを記述することもできます。

It is troublesome to enter a confirmed program into a document. Therefore, SmartDoc has a function to insert an external program. Of course, it is also possible to write the program within the document.

このプログラムの取り込みは`program`タグによって実現します。

Inserting the program is done with the `program` tag.

`program`は通常の`pre`と比べて以下の点が拡張され ています。

The `program` tag functionality has been expanded from the `pre` as shown below:

- タイトルが図、表ではなくリストとなる
- リスト番号が採番される
- リスト表示に適した形にレイアウトされる
- コメントを使ってハイライトの指定ができる

- The title is a list, not a chart or figure.
- List index number is automatically added.
- The layout is prepared according to the list display.
- Comments can be used to specify high-lights.

これらの機能の詳細についてはユーザガイド(作成中)、リファレンスマニュア ル(作成中)で説明する予定です。 ここではQuick Startの趣旨に沿って基本的な使い方を説明します。

These functions will be explained in detail in the Users' Guide (being prepared now) and the Reference Manual (being prepared now). The fundamental methods are shown here from a Quick Start perspective.

Inserting an External File

### 外部からの取り込み

<program src="Sample.java">

Internal Definition

### 内部での定義

なお内部で定義する場合にはXMLの標準エンティティをエスケープしなければ ならないことに注意が必要です。

For internal definition, note that the standard XML entity is escaped.

public class Sample { public static void main(String[] args) { if (args.length > 0) { System.out.println("Hello"); } } }

またエスケープする場所が多い場合にはXMLの持っているCDATAセクション機能 を使うのが便利でしょう。 CDATAセクション内ではXMLの文法にとらわれず自由にテキストを記述すること ができます。

f many escape have to be performed, it is better to use the CDATA section function of XML. In the CDATA section, text can be entered freely without concern for the XML syntax.

## Console

## コンソール

コンソールの場合も使い方はプログラムの場合と同様です。

The method for using the console is the same as for a program.

もちろん`console`タグを使った場合にはコンソールに適切な形態 で表示されることになります。

Of course, if a `console` tag is used, it is displayed in a form appropriate to the console.

External Insertion

### 外部からの取り込み

コンソールの場合も外部からの取り込みはプログラムの場合と同じような形に なります。

For the console, external insertion is the same as for a program.

<console src="sample.console"/>

Internal definition

### 内部での定義

<console> C:\tmp>SmartDoc sample.sdoc Copyright (c) 1998,1999 ASAMI, Tomoharu. All rights reserved. SmartDoc Version 0.2.3 (19990327) by ASAMI@Yokohama </console>
C:\tmp>SmartDoc sample.sdoc Copyright (c) 1998,1999 ASAMI, Tomoharu. All rights reserved. SmartDoc Version 0.2.3 (19990327) by ASAMI@Yokohama

# The differences between XML and HTML

# XMLとHTMLの違い

以上のようにSmartDocのフォーマットはほぼHTMLと同様であることがおわかり いただけたと思います。

The similarity between the SmartDoc format and HTML should now be clear.

しかし、もちろんXMLとHTMLには機能的な違いがありこれを正しく理解してい ないとSmartDocを使用することが難しいのも事実です。 HTMLで許されている文法のいくつかはXMLでは無効で、少なくてもこの点を押 さえておかないと混乱の元になるでしょう。

However, there are some functional differences between XML and HTML, and these need to be properly recognized to use SmartDoc.

## Document Start Declaration

## 文章の開始宣言

HTML
  開始宣言はない
XML
  UTF-8以外のエンコーディングの場合、開始宣言は省略はできない

HTML
  No declaration
XML
  Case of encoding other than UTF-8, declaration required

## Omission of End Tag

## 終了タグの省略

HTML
  終了タグの省略は可能
XML
  終了タグの省略はできない

HTML
  Omission of end tag is permitted.
XML
  Omission of end tag is not permitted.

## Omission of Attributes

## 属性値の省略

HTML
  属性は属性名だけの記述が可能で属性値は省略できる
XML
  属性値は省略できない

HTML
  Including only the attribute name is possible, with the value omitted.
XML
  Omission of attribute is not permitted.

## Specifing Attribute Value

## 属性値の指定

HTML
  属性値は引用符で囲んでも囲まなくてもよい
XML
  属性値は引用符で囲まなければならない

HTML
  Attribute value may, or may not be enclosed in quotes.
XML
  Attribute value has to be enclosed in quotes.

# Option

# オプション

SmartDocでは実行時オプションによって目次や索引などの情報を生成するドキュ メントに自動的に付加する機能を持っています。

SmartDoc has the functionality to add the table of contents and index data automatically to the created document.

オプション,引数,機能
format,"フォーマット名[,フォーマット名...]",生成するフォーマット toc,true|false,目次の生成

Options, References, Functions
Format,"Format Name [,Format Name...]", Creation Format toc, true|false, creating contents

名前,フォーマット
html4,HTML4.0 html3,HTML3.2 latex2e,LaTeX2e javahelp,JavaHelp pure,PureSmartDoc

Name, Format
html4,HTML4.0 html3,HTML3.2 latex2e,LaTeX2e javahelp,JavaHelp pure,PureSmartDoc

# Thanx

English translation is strongly supported by WANAKA, Yoshinori and Jim Winebrenner.