概要

現在 Texinfo に移行を計画中

過去への回帰っぽいですが、XMLよりLaTeXの方が純粋な文書記述では強力なのかもしれないです。

DocBookがあまりにひどいのでほかの文書記述用XML形式を探していたときに見つけたもの。

とりあえず日本語とかは問題ないし、最低限の機能は実装されている。

初期設定の色が派手すぎたり、出力するHTMLやLaTeXの一部が変だったりするのはご愛嬌だと思っている。

最近の文書は大概SmartDoc形式で記述している。

http://www.asahi-net.or.jp/~dp8t-asm/java/tools/SmartDoc/index_ja.html

インストール

http://www.XMLSmartDoc.org/download/beta.zip

sudo java -cp setup.zip setup
sudo chmod 755 /usr/local/bin/sdoc

マニュアル

配布物を解凍した中にarchive.jarというjarがあります。これをさらに解凍すると、docフォルダがあります。

この中にリファレンスマニュアルが同梱されていますので、説明を読んでHTMLを作成しておくとよいでしょう。

PGSMLでSmartDocを記述する

SmartDocModeが同梱されていますが、これがぼくは使いずらいので、psgml-modeで記述できるようにしています。

PSGMLでSmartDoc文書を書くを参考に改造した。

.emacsのsgml-custom-dtdに以下追加

("SmartDoc"
    "&lt;!DOCTYPE doc PUBLIC
    \"-//Tomoharu Asami//DTD PureSmartDoc XML V1.0.0//EN\"
    \"file:////Users/sakito/etc/psgml/PureSmartDoc.dtd\"&gt;\n")

CATALOG.txtに以下追加

PUBLIC  "-//Tomoharu Asami//DTD PureSmartDoc XML V1.0.0//EN" "PureSmartDoc.dtd"

ECAT.txtに以下追加

PUBLIC  "-//Tomoharu Asami//DTD PureSmartDoc XML V1.0.0//EN" cdtd/PureSmartDoc.dtd

PureSmartDoc.dtdを改造してしまいます。

&lt;!ENTITY % HTMLlat1 PUBLIC "-//W3C//ENTITIES Latin 1 for XHTML//EN"
   "file:///Users/sakito/etc/psgml/xhtml-lat1.ent"&gt;
%HTMLlat1;
&lt;!ENTITY % HTMLsymbol PUBLIC "-//W3C//ENTITIES Symbols for XHTML//EN"
   "file:///Users/sakito/etc/psgml/xhtml-symbol.ent"&gt;
%HTMLsymbol;
&lt;!ENTITY % HTMLspecial PUBLIC "-//W3C//ENTITIES Special for XHTML//EN"
   "file:///Users/sakito/etc/psgml/xhtml-special.ent"&gt;
%HTMLspecial;
&lt;!ATTLIST doc xml:lang NMTOKEN #IMPLIED&gt;
&lt;!ATTLIST div xml:lang NMTOKEN #IMPLIED&gt;
&lt;!ATTLIST div normalizer (none) #IMPLIED&gt;
&lt;!ATTLIST span xml:lang NMTOKEN #IMPLIED&gt;
&lt;!ATTLIST a href CDATA #IMPLIED&gt;
&lt;!ATTLIST native format (html|latex2e|plain) #IMPLIED&gt;
&lt;!ATTLIST native src CDATA #IMPLIED&gt;

を付加し、titleなどの幾つかの要素を属性に変更します。

以下の関数を定義しておくと便利かもしれません。

(setq sdoc-command-line "sdoc")
(defun sdoc ()
  (interactive)
  (let (
        (sdocbuf "*SmartDoc*"))
    (call-process sdoc-command-line nil sdocbuf nil (buffer-file-name))
    (display-buffer sdocbuf)
    ))
;; ぼくはあまりC-cC-c(sgml-show-context)利用しないので以下に設定している。
(define-key xml-mode-map "\C-c\C-c" 'sdoc)

複数のSdocファイルをまとめてあつかう

&lt;p src="hogehoge.sdoc" /&gt;

を記述する事で、外部のファイルを読み込む事が可能です。

以下のような方法もあります。

&lt;?xml version='1.0' encoding="iso-2022-jp"?&gt;

&lt;!DOCTYPE doc [
  &lt;!ENTITY sdocpart1 SYSTEM "/Users/sakito/doc/emacs21/part1.sdoc"&gt;
  &lt;!ENTITY sdocpart2 SYSTEM "/Users/sakito/doc/emacs21/part2.sdoc"&gt;
  &lt;!ENTITY sdocpart3 SYSTEM "/Users/sakito/doc/emacs21/part3.sdoc"&gt;
]&gt;

&lt;doc xml:lang="ja"&gt;
&lt;head&gt;
&lt;title&gt;Emacs21&lt;/title&gt;
&lt;author&gt;sakito&lt;/author&gt;
&lt;date&gt;&lt;/date&gt;
&lt;/head&gt;
&lt;body&gt;
&amp;sdocpart1;

&amp;sdocpart2;

&amp;sdocpart3;

&lt;/body&gt;
&lt;/doc&gt;

概要

インストール

マニュアル

PGSMLでSmartDocを記述する

複数のSdocファイルをまとめてあつかう

関連