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

<doc>
<head>
<title>SmartDoc</title>
<subtitle>Ver. 1.0</subtitle>
<author locale="ja">浅海 智晴</author>
<author locale="en">ASAMI, Tomoharu</author>
<hp>http://www.netpassport.or.jp/~wtasami</hp>
<date locale="ja">2002年2月4日</date>
<date locale="en">Feb. 4, 2002</date>

</head>

<body>

<section title="SmartDocとは">
<title locale="en">About SmartDoc</title>

<span locale="ja">
SmartDocはXMLをベースにしたドキュメント生成ツールです。

SmartDoc形式のドキュメントをHTML4.0, HTML3.2, LaTeX2e, JavaHelp, プレインテキストに変換します。

同一のドキュメントでWWWによる公開と、LaTeXによる高品質印刷を行うことが
できます。

</span>
<span locale="en">
SmartDoc is the XML utility to create documents.

It can convert SmartDoc format document to HTML4.0, HTML3.2, LaTeX2e, 
Java Help and plain text.

By using the same document , possible to open by WWW , and high
quality printing by LaTeX.
</span>

</section>

<section title="SmartDocの特徴">
<title locale="en">Features</title>

<span locale="ja">
<ul>
  <li>XMLベースのマークアップ言語</li>
  <li>HTMLライクな文法で記述したドキュメントをHTML4.0、HTML3.2, LaTeX2e, JavaHelp, プレインテキストに変換</li>
  <ul>
    <li>HTML4とLaTeX2eのタグをベースにドキュメント記述に必要なタグを用意
    </li>
    <li>HTML4、LaTeX2eそれぞれの不足機能はSmartDocが補完</li>
    <li>目次、参考文献、索引の生成</li>
    <ul>
      <li>HTML4ではSmartDocが生成</li>
      <li>LaTeX2eではLaTeX2eの機能を使用</li>
    </ul>
    <li>表</li>
    <ul>
      <li>HTML4ライクの文法(rowspan, colspan, align)でLaTeX2eの表もゲット</li>
    </ul>
    <li>図</li>
    <ul>
      <li>HTML4.0/3.2生成ではGIF, LaTeX2e生成ではEPSを取り込む</li>
    </ul>
    <li>プログラム</li>
    <ul>
      <li>プログラムソースコードの取り込み機能</li>
      <li>マニュアル作成に便利</li>
    </ul>
    <li>コンソール</li>
    <ul>
      <li>コンソール出力の取り込み機能</li>
      <li>マニュアル作成に便利</li>
    </ul>
    <li>HTML4.0/3.2、LaTeX2eの固有機能の埋め込み機能</li>
    <ul>
      <li>LaTeX2eの数式もこの方法で記述可能<note>数式に関してはいずれMathML(XMLの数式向け拡張文法)でサポートする予定</note></li>
    </ul>
    <li>マルチロケール機能</li>
    <ul>
      <li>同一ドキュメント内に複数のロケールのコンテンツを記述</li>
      <li>フォーマット変換時にロケール向けに整形</li>
      <li>I18Nアプリケーションのマニュアル作成に便利</li>
    </ul>
    <li>マルチリンガル機能</li>
    <ul>
      <li>Unicodeを使うことによって複数言語を同時に記述可能</li>
      <li>言語はXMLのxml:lang属性で指定</li>
    </ul>
  </ul>
</ul>
</span>
<span locale="en">
<ul>
  <li>Mark-up language based on XML</li>
  <li>Convert the documents written by the format like HTML to
  HTML4.0, HTML3.2, LaTeX2e and plain text</li>
  <ul>
    <li>It is ready the tag to describe the ducuments based on the tag of HTML4 and LaTeX2e</li>
    <li>SmartDoc supports uncomfortable matter of HTML4 and LaTeX2e</li>
    <li>Generate table of contents, bibliography, index automatically</li>
    <ul>
      <li>In HTML4, SmartDoc handles</li>
      <li>In LaTeX2e, use LaTeX2e function</li>
    </ul>
    <li>Table</li>
    <ul>
      <li>It can get LaTex2e table by the format like HTML4 (rowspan, colspan, align)</li>
    </ul>
    <li>Graphic</li>
    <ul>
      <li>HTML4.0/HTML3.2 mode : GIF</li>
      <li>LaTeX2e mode : EPS</li>
    </ul>
    <li>Program</li>
    <ul>
      <li>The getting in function of program source code</li>
      <li>To manual preparation convenient</li>
    </ul>
    <li>Console</li>
    <ul>
      <li>The getting in function of console output</li>
      <li>To manual preparation convenient</li>
    </ul>
    <li>Multi-locale</li>
    <ul>
      <li>Contents of plural locales are able to be described into the
      same documents</li>
      <li>Restoration for locales at the time of format
      transformation</li>
      <li>To the manual preparation of an I18N application convenient</li>
    </ul>
    <li>Multilingual</li>
    <ul>
      <li>Possibility that describe a plural language simultaneously
      by using Unicode </li>
      <li>Language designated with xml:lang attribute of XML</li>
    </ul>
    <li>HTML4 and LaTeX2e individual function of insertion</li>
    <ul>
      <li>The formula of LaTeX2e is described by this method as well<note>The formula will be supported by MathML(XML expand formula)</note></li>
    </ul>
  </ul>
</ul>
</span>

<table title="マークアップ言語機能比較">
<title locale="en">Mark up language function comparison</title>
<colgroup>
<col class="key"></col>
</colgroup>
<colgroup span="7" align="center">
</colgroup>
<thead>
<tr>
<th></th>
<th>SmartDoc</th>
<th>DocBook</th>
<th>LinuxDoc</th>
<th>HTML</th>
<th>LaTeX</th>
<th>RTF</th>
<th locale="ja">プレイン</th>
<th locale="en">Plain</th>
</tr>
</thead>
<tbody>
<tr>
<td locale="ja">論理構造</td>
<td locale="en">Logical structure</td>
<td>A</td>
<td>A</td>
<td>A</td>
<td>B</td>
<td>A</td>
<td>?</td>
<td>x</td>
</tr>
<tr>
<td locale="ja">コンバート</td>
<td locale="en">Convert</td>
<td>A</td>
<td>B</td>
<td>A</td>
<td>C</td>
<td>x</td>
<td>?</td>
<td>C</td>
</tr>
<tr>
<td locale="ja">目次の自動生成</td>
<td locale="en">TOC automatic generation</td>
<td>A</td>
<td>A</td>
<td>A</td>
<td>x</td>
<td>A</td>
<td>?</td>
<td>x</td>
</tr>
<tr>
<td locale="ja">索引の自動生成</td>
<td locale="en">Index automatic generation</td>
<td>A</td>
<td>A</td>
<td>?</td>
<td>x</td>
<td>A</td>
<td>?</td>
<td>x</td>
</tr>
<tr>
<td locale="ja">参考文献の自動生成</td>
<td locale="en">Bibliography automatic generation</td>
<td>A</td>
<td>?</td>
<td>?</td>
<td>x</td>
<td>A</td>
<td>?</td>
<td>x</td>
</tr>
<tr>
<td locale="ja">用語集の自動生成</td>
<td locale="en">Glossary automatic generation</td>
<td>A(Plan)</td>
<td>?</td>
<td>?</td>
<td>x</td>
<td>x</td>
<td>?</td>
<td>x</td>
</tr>
<tr>
<td locale="ja">RDFの自動生成</td>
<td locale="en">RDF automatic generation</td>
<td>A(Plan)</td>
<td>x</td>
<td>x</td>
<td>x</td>
<td>x</td>
<td>x</td>
<td>x</td>
</tr>
<tr>
<td locale="ja">CDFの自動生成</td>
<td locale="en">CDF automatic generation</td>
<td>A(Plan)</td>
<td>x</td>
<td>x</td>
<td>x</td>
<td>x</td>
<td>x</td>
<td>x</td>
</tr>
<tr>
<td locale="ja">マルチリンガル</td>
<td locale="en">Multilingual</td>
<td>A</td>
<td>?</td>
<td>?</td>
<td>B</td>
<td>x</td>
<td>x</td>
<td>B</td>
</tr>
<tr>
<td locale="ja">マルチロケール</td>
<td locale="en">Multi locale</td>
<td>A</td>
<td>x</td>
<td>x</td>
<td>B</td>
<td>x</td>
<td>x</td>
<td>x</td>
</tr>
</tbody>
<tnote>
<dl locale="ja">
<dt>A</dt>
<dd>フルサポート</dd>
<dt>B</dt>
<dd>実用レベルサポート(一部制限付き)</dd>
<dt>C</dt>
<dd>制限付きで可能</dd>
<dt>?</dt>
<dd>不明</dd>
<dt>x</dt>
<dd>非常に困難</dd>
</dl>
<dl locale="en">
<dt>A</dt>
<dd>full</dd>
<dt>B</dt>
<dd>Practical use level(minor restriction)</dd>
<dt>C</dt>
<dd>Possibility with a restriction accompaniment</dd>
<dt>?</dt>
<dd>Unknown</dd>
<dt>x</dt>
<dd>Difficult</dd>
</dl>
</tnote>
</table>

</section>

<section title="インストール">
<title locale="en">Install</title>

<span locale="ja">
インストールディレクトリに入っているsdoc(UNIX)または
sdoc.bat(Windows)を適当にいじってください。
</span>
<span locale="en">
Customize sdoc(UNIX) or sdoc.bat(Windows) included in the
installation directory properly. 
</span>

</section>

<section title="実行方法">
<title locale="en">How to use</title>

<console>C:\tmp&gt;sdoc foo.sdoc
</console>

</section>

<section title="Status">
<p locale="ja">
現在のバージョンのフォーマットはまだ安定していません。
このためDTDはまだ提供されていません。
</p>
<p locale="ja">
実用上問題なく動作しますが、マニュアルはまだ完備されていません。
</p>
<p locale="en">
The format of this version is not stabilizing.
Because of this DTD has not been offered yet. 
</p>
<p locale="en">
This version runs without any problem on practical use.
However the manual has not been equipped. 
</p>
</section>

<section title="Thanks">

<ul locale="ja">
<li>XMLパーサには<a href="http://xml.apache.org/xerces-j/index.html">Xerces Java Parser 1.2</a>を使用しています。</li>
<li>XSLTプロセッサには<a href="http://xml.apache.org/xalan-j/index.html">Xalan-Java version 1.2</a>を使用しています。</li>
<li>正規表現エンジンには<a href="http://www.savarese.org/org/">Savarese.Org</a>のPerlTools-1.2を使用しています。</li>
<li>桜井雅史さん提供のJavaソースのシンタクスハイライト機能を使っています。</li>
<li>桜井雅史さん提供のTeX/MathML変換機能を使っています。</li>
</ul>
<ul locale="en">
<li><a href="http://xml.apache.org/xerces-j/index.html">Xerces Java Parser 1.2</a> is being used for a XML Parser.</li>
<li><a href="http://xml.apache.org/xalan-j/index.html">Xalan-Java version 1.2</a> is being used for a XSLT Processor.</li>
<li>PerlTools-1.2 of <a href="http://www.savarese.org/org/">Savarese.Org</a> is being used for a regex engine.</li>
<li>SAKURAI, Masashi provides a Syntax hilight facility for Java source.</li>
<li>SAKURAI, Masashi provides a TeX to MathML translator.</li>
</ul>

</section>

</body>

</doc>
