From c6c3e3d4b1c6057c2864d0523d00453537212e2e Mon Sep 17 00:00:00 2001 From: Masanori Kobayasi Date: Mon, 1 Nov 2010 23:06:43 +0900 Subject: [PATCH] add missing html files --- www/workshop/linuxdoc-sgml/FAQj-1.html | 123 ++++++ www/workshop/linuxdoc-sgml/FAQj-2.html | 88 ++++ www/workshop/linuxdoc-sgml/FAQj-3.html | 82 ++++ www/workshop/linuxdoc-sgml/FAQj.html | 56 +++ www/workshop/sgml-jguide/jguide-1.html | 180 ++++++++ www/workshop/sgml-jguide/jguide-2.html | 231 ++++++++++ www/workshop/sgml-jguide/jguide-3.html | 749 +++++++++++++++++++++++++++++++++ www/workshop/sgml-jguide/jguide-4.html | 95 +++++ www/workshop/sgml-jguide/jguide-5.html | 216 ++++++++++ www/workshop/sgml-jguide/jguide-6.html | 95 +++++ www/workshop/sgml-jguide/jguide-7.html | 37 ++ www/workshop/sgml-jguide/jguide.html | 95 +++++ 12 files changed, 2047 insertions(+) create mode 100644 www/workshop/linuxdoc-sgml/FAQj-1.html create mode 100644 www/workshop/linuxdoc-sgml/FAQj-2.html create mode 100644 www/workshop/linuxdoc-sgml/FAQj-3.html create mode 100644 www/workshop/linuxdoc-sgml/FAQj.html create mode 100644 www/workshop/sgml-jguide/jguide-1.html create mode 100644 www/workshop/sgml-jguide/jguide-2.html create mode 100644 www/workshop/sgml-jguide/jguide-3.html create mode 100644 www/workshop/sgml-jguide/jguide-4.html create mode 100644 www/workshop/sgml-jguide/jguide-5.html create mode 100644 www/workshop/sgml-jguide/jguide-6.html create mode 100644 www/workshop/sgml-jguide/jguide-7.html create mode 100644 www/workshop/sgml-jguide/jguide.html diff --git a/www/workshop/linuxdoc-sgml/FAQj-1.html b/www/workshop/linuxdoc-sgml/FAQj-1.html new file mode 100644 index 0000000..3dfe44c --- /dev/null +++ b/www/workshop/linuxdoc-sgml/FAQj-1.html @@ -0,0 +1,123 @@ + + + 日本語版 Linuxdoc-SGML に関するＱ＆Ａ: 入手・インストール・動作環境 + + + Previous

1. 入手・インストール・動作環境

+ + +

1.1 jlinuxdoc-sgml はどこから入手できるのでしょうか？

+ +

[質問] +: jlinuxdoc-sgml はどこから入手できるのでしょうか？
+動作させるためには他にどんなものが必要ですか？
+
[回答] +: JF と呼ばれる Linux の日本語文書群に含まれるので、その匿名 ftp サイト +から入手できます。 +ftp://ftp.kuis.kyoto-u.ac.jp/Linux/JF/misc/ などに置いて +あります。
+英語版の linuxdoc-sgml-1.5 からのパッチとなっているので、英語版も必要と +なります。その他 groff や LaTeX なども必要となります。詳しくは、附属の +README.v1.5j を御覧下さい。
+

+ + +

1.2 jlinuxdoc-sgml は Linux でしか動作しないのですか？

+ +

[質問] +: jlinuxdoc-sgml は Linux でしか動作しないのですか？
+他の OS にインストールした場合にどのような問題が生じますか？
+
[回答] +: jlinuxdoc-sgml は HOWTOs などの Linux の文書の整備を目的として作られた +ために linux という文字列がその名称の中に含まれていますが、 +他の OS で使っても問題ありません。sgmls や roff などを使う都合上、 +UNIX 互換の OS でないとインストールできないと思いますが、Linux に依存 +した部分はありません。ただし、roff の代わりに groff を lex の代わりに +flex を使うなどしているため、若干の変更が必要となるものもあるでしょう。
+

+ + +

1.3 数式や図表の入った文書作成に使えますか？

+ +

[質問] +: SGMLでは様々な形態の文書を作成できるはずですが、jlinuxdoc-sgml では +数式や図表の入った文書作成に使えますか？
+
[回答] +: 残念ながら使えません。
+目的が HOWTOs の文書整備なので、将来的にもサポートされるかどうかは +なんとも言えません。日本語版の独自拡張機能として画像などを扱えるよう +に変更することは可能ですが、あまり拡張すると英語版との互換性が崩れる +ので悩むところです。
+

+ + +

1.4 インストールに失敗しました

+ +

[質問] +: README.v1.5j に書いてある通りにインストールしようとしたの +ですが、./install の途中でエラーになってしまいました。
+
[回答] +: パッチが正しく当っているか、flex が入っているか、スーパーユーザー +になっているか確かめて下さい。
+なお、flex でのコンパイルの際にたくさんの警告を発しますが、これは +エラーではありません。
+

+ + +

1.5 jguide.sgml をプレーンテキストに変換できません

+ +

[質問] +: jguide.sgml をプレーンテキストに変換できません。
+
[回答] +: 1.09以前の groff を使っている場合は、マクロの指定を -ms +の代わりに -mgs とする必要があります。 +また、JE のバージョンによっては、 groff がうまく動かないことがある +ようですから、groff を入れ換えてみたらどうでしょうか。
+

+ + +

1.6 jguide.sgml を DVI ファイルに変換できません

+ +

[質問] +: LaTeX でエラーになってしまい、jguide.sgml を DVI ファイルに変換 +できません。
+
[回答] +: JE ではなく、自分でコンパイルした JLaTeX を使っている場合は、環境変数 +TEXINPUTSの定義をし直さないといけないことがあります。sgml2latex +のTEXINPUTSの定義の記述を変更してみて下さい。
+

+ + +

1.7 jguide.sgml を PS ファイルに変換できません

+ +

[質問] +: jguide.sgml を変換してみて DVI ファイルまでは作れるのですが、PSファイル +への変換で失敗しているようです。
+
[回答] +: sgml2latex の中の jdvi2kps か dvi2ps の記述が正しいか確認して下さい。 +もちろん jdvi2kps や dvi2ps 自身の設定も正しくなくてはいけません。
+

+ + +

1.8 自分で作った SGML ファイルの変換がうまくいきません

+ +

[質問] +: jguide.sgml の変換はうまくいくのですが、自分で作った SGML ファイルの +変換がどうしてもうまくいきません。構文は間違っていないと思うのですが。
+
[回答] +: jlinuxdoc-sgml で扱うことのできる漢字コードは EUC-J だけです。他の +漢字コードを使っていたり、半角カタカナなどが入っていないかどうか +確かめて下さい。
+

+ + +

+ + diff --git a/www/workshop/linuxdoc-sgml/FAQj-2.html b/www/workshop/linuxdoc-sgml/FAQj-2.html new file mode 100644 index 0000000..fc41f0f --- /dev/null +++ b/www/workshop/linuxdoc-sgml/FAQj-2.html @@ -0,0 +1,88 @@ + + + 日本語版 Linuxdoc-SGML に関するＱ＆Ａ: 用語と SGML + + +

2. 用語と SGML

+ + +

2.1 SGMLって何ですか？

+ +

[質問] +: SGMLって何ですか？
+
[回答] +: SGML とは、Standard Generalized Markup Language の略で全文データベース +(DB)を作成・保守するための記述言語です。1986年に ISOの規格 8879になり +欧米で広く使われており、日本でも1992年に JIS規格 X-4151となって最近 +注目を浴びています。主に電子出版のための標準書式として使われており、 +文書構造とタグを DTD と呼ばれるファイルで定義しておき、それに即した +タグ入りの文書を作りそれをフィルタにかけることで、様々な書式に変換 +したりデータベースを作成することが可能となります。
+

+ + +

2.2 DTDって何ですか？

+ +

[質問] +: DTDって何ですか？
+
[回答] +: DTDは Document Type Definition の略で、SGMLの文書構造とそれを表現 +するためのタグに関する定義、あるいは定義をするファイルのことです。 +SGML には標準化された DTD があるわけではなく、自分達の都合に合わせ +て定義します。jlinuxdoc-sgml では linuxdoc.dtd という +ファイルによって定義されています。
+

+ + +

2.3 REP って何ですか？

+ +

[質問] +: REP って何ですか？
+
[回答] +: REPとは、SGML の用語ではなく sgmls というソフトウェアで使う各種 +ファイル形式への変換につかうタグや特殊文字の変換テーブルの定義 +ファイルです。jlinuxdoc-sgml では $LINUXDOCLIB/rep/ 以下 +にファイル形式や言語ごとに別れて入れられています。
+

+ + +

2.4 sgmls って何ですか？

+ +

[質問] +: sgmls って何ですか？
+
[回答] +: sgmlsは ISO 8879 準拠のフリーの SGML パーサ(構文解析ソフトウェア)で、 +James Clark(jjc@jclark.com)によって作成されました。
+sgmlsは、SGML文書を解析して構文チェックを行い、ESIS(Element +Structure Information Set)形式を出力します。ユーザは、ESIS形式を +自分が使用しているフォーマッタ形式(TeX, Troffなど)に変換して +印刷(最終出力)を行うことができます。この変換のためのプログラムとし +て、Cで記述された sgmlsaspが提供されています。
+jlinuxdoc-sgml では土屋哲氏(tsuchiya@sysrap.cs.fujitsu.co.jp) +によって日本語化された sgmls を使用しています。
+

+ + +

2.5 jlinuxdoc-sgml を使うのに SGML の知識は必要ですか？

+ +

[質問] +: jlinuxdoc-sgml を使うためには、SGML について勉強しなければいけないの +でしょうか？
+
[回答] +: その必要はありません。jguide.euc や jguide.sgml を見ながらタグの使い +方と変換方法さえ覚えれば、SGML の詳細については全く知らなくても使い +こなすことができます。ただし、jlinuxdoc-sgml を改良するには多少の知識 +は必要となります。
+

+ + +

+ + diff --git a/www/workshop/linuxdoc-sgml/FAQj-3.html b/www/workshop/linuxdoc-sgml/FAQj-3.html new file mode 100644 index 0000000..8c752c4 --- /dev/null +++ b/www/workshop/linuxdoc-sgml/FAQj-3.html @@ -0,0 +1,82 @@ + + + 日本語版 Linuxdoc-SGML に関するＱ＆Ａ: SGML 文書の作成 + + +

3. SGML 文書の作成

+ + +

3.1 jlinuxdoc-sgml 対応の SGML エディタはありますか？

+ +

[質問] +: jlinuxdoc-sgml 対応の SGML エディタはありますか？
+
[回答] +: 今のところありませんが、そのかわり lnxsgml.el という elisp がある +ので、mule などをお使いであれば lnxsgml.el を読み込むことにより、 +SGML のタグ入力や書式の変換を簡単に行なうことができます。
+lnxsgml.el は jlinuxdoc-sgml に附属しますが、./install ではインス +トールされないので自分の手で適切な場所にコピーして下さい。
+

+ + +

3.2 変換したプレーンテキストが格好悪いのですが

+ +

[質問] +: jLinuxdoc-SGML でプレーンテキストに変換すると、空行が減らされてしまい +期待した出力が得られません。
+
[回答] +: sgml2txt ではデフォルトで余計な空行を削るようにしています。削る空行の +量は -b オプションで調整できます。sgml2txt -b 2 *.sgml とす +ると、2行までの連続する空行を認めそれ以上の空行を削るようにします。
+

+ + +

3.3 入力した文字や行が変換後に消えてしまいます

+ +

[質問] +: SGML のソースで入力したはずの文字が消えたり、ある文字以降の行が +変換後にファイルでは表示されていないのですがバグでしょうか？
+
[回答] +: 制御文字を使っていないかどうかチェックして下さい。直接使ってはいけない +文字は以下のものです。 +
+[, ], &, <, >, </, $, #, +%, \, " +
+ +また、行の先頭に . があってもいけません。
+これらのチェックをしてもまだうまくいかないのならバグである可能性 +があります。
+

+ + +

3.4 行のセンタリングや右揃えなどはできないのでしょうか？

+ +

[質問] +: 行のセンタリングや右揃えなどはできないのでしょうか？ +また、フォントの大きさや色の指定はできないのでしょうか？
+
[回答] +: 現時点ではできませんが将来は対応するかもしれません。
+

+ + +

3.5 <quote> や <tscreen> の環境の中で空行が使えません

+ +

[質問] +: <quote> や <tscreen> の環境の中で空行を入れて改行させよう +と思っているのですが、エラーになってしまいます。
+
[回答] +: 空行のかわりに を使って下さい。
+

+ + +

+ + diff --git a/www/workshop/linuxdoc-sgml/FAQj.html b/www/workshop/linuxdoc-sgml/FAQj.html new file mode 100644 index 0000000..da58830 --- /dev/null +++ b/www/workshop/linuxdoc-sgml/FAQj.html @@ -0,0 +1,56 @@ + + + + 日本語版 Linuxdoc-SGML に関するＱ＆Ａ + + + Previous

日本語版 Linuxdoc-SGML に関するＱ＆Ａ

+ +

小野＠京大環境地球, `ono@jf.gee.kyoto-u.ac.jp`

v0.2, 17 Mar 1996 +

この文書は日本語版 Linuxdoc-SGML(jlinuxdoc-sgml) を使うにあたって +生じる疑問にお答えするものです。この文書自体も SGML で書かれており、 +jlinuxdoc-sgml の FAQ タグを使っています。

1. 入手・インストール・動作環境

+ +

2. 用語と SGML

+ +

3. SGML 文書の作成

+ + +

+ + diff --git a/www/workshop/sgml-jguide/jguide-1.html b/www/workshop/sgml-jguide/jguide-1.html new file mode 100644 index 0000000..c042d86 --- /dev/null +++ b/www/workshop/sgml-jguide/jguide-1.html @@ -0,0 +1,180 @@ + + +日本語版 Linuxdoc-SGML ガイド: 概要 + + +前のページ +次のページ +目次 +

1. 概要

+ +

これは Linux 文書用の日本語版 Linuxdoc-SGML 文書処理システム (以 +降、jLinuxdoc-SGML) のガイドです。本文書では、SGML 形式のファイルから +他の形式の文書ファイルへの変換方法や、SGML 形式の文書を書く方法について +記述しています。

原版の Linuxdoc-SGML は Tom Gordon 作の QWERTZ DTD +(文書型定義 : Document Type Definition)をベースに、Linux の文書整備を +目的として SGML 形式の文書を groff, LaTeX, HTML, GNU info, LyX, RTF +形式へ変換出来るように、DTD と変換定義ファイル(replacement files: 以降 +rep と呼びます)を書き換えたものです。
+jLinuxdoc-SGML はそのうち groff, LaTeX, HTML 形式について +日本語に対応し機能拡張したもので、オリジナルのスーパーセットとなって +います。

jLinuxdoc-SGML は一般的な文書処理システムとして作られているわけ +ではありませんが、HOWTOs、FAQs や (最近の) Linux 文書プロジェクト +(LDP: Linux Documentation Project) のマニュアル作成等に使えるように +作られていますので、様々なタイプの文書で利用することができます。 +ただし、Linux の文書作成に焦点を絞って開発されているので、一般的な +文書作成に十分な機能を持っているわけではありません。例えば画像や数式 +や表や特殊文字を扱うことはできません。より一般的な文書に利用したい +場合は QWERTZ DTD などと組み合わせて利用することをお奨めします。

多数のフォーマットの文書を簡単に生成するのが、このシステムの１つの目標 +です。今まで、ほとんどの Linux 文書は編集の始めから終りまでプレーンテ +キストで作業していました。roff のようにプレーンテキストの整形処理 +ができるシステムもありましたが、(WWW : World Wide Web で使うための) +HTML、(優秀な文書印刷のための) LaTeX や、texinfo を生成してくれる +ものはありませんでした。それゆえ、あなたがこのシステムに無い機能で欲し +いものがあって、たくさんハックする必要が無くて多数のフォーマットで見栄 +えの良い文書が生成できるアイデアがあれば私に知らせて下さい！。

利用者の皆様の御意見で、このシステムをよりよくしていきましょう。

この文書は jLinuxdoc.SGML を使って書かれていますので、あなた +がこの DTD を使って SGML の文書を書くのに必要な事柄が含まれています。 +また、HOWTO の例として JE-HOWTO.sgml が、man ページの例 +としてkon.sgml が、FAQ の例として FAQj.sgml が +linuxdoc-sgml-1.5/doc ディレクトリにありますので、記述の +参考にして下さい。

+ +

1.1 このガイドについて

+ +

このガイドは jLinuxdoc-SGML を用いて SGML 形式で書かれた文書ファイル +を様々な形式のファイルに変換する方法と、jLinuxdoc-SGML 用に定義された +SGML のタグの書き方について例を含めて説明しています。インストールと +設定に関しては、README.v1.5j をご覧ください。

Linuxdoc-SGML の最初のガイドは原版の作者であり LDP のまとめ役である +Matt Welsh 自身の手によって書かれました。その後 Linuxdoc-SGML が他の +人の手で更新されるようになり、v1.4 から Greg Hankins が大幅に更新して +からはガイドも Greg Hankins によって書き直されました。
+一方、日本語版は v1.1 対応版をさとけん＠ＦｏｒＵｓさんが作成し、その +ガイドもさとけんさんが Matt Welsh のガイドをもとに書き下ろしました。 +現在のものは、原版 v1.5 のガイドと日本語版 v1.1 のガイドをもとに、 +小野＠京大環境地球が新たに書き下ろしたものです。

+ + +

1.2 SGML との関係

+ +

jLinuxdoc-SGML を使用するに当たって、SGML についての詳細な知識は必要 +ではありません。ただし、SGML がどのような形式のものであり、DTD がどう +いうものであるかという程度の知識は持っていた方が理解が速いでしょう。 +SGML に関する簡単な解説としては、付属の日本語版 sgmls のガイド +sgmls11j.add/sgmlexp.jpn をご覧になるのがいいでしょう。

Matt Welsh が HOWTOs の公式文書形式として SGML を選択し、Linuxdoc-SGML +を作成したのは、HOWTOs をネットニュースや書籍や WWW といった多くの媒体 +で配布・公開するために、様々な形式の文書ファイルを一元的に作成する必要 +ができたためです。
+SGML を用いることにより、ひとつのファイルから様々な形式のファイルを +高い品質で作成することが可能となります。別の選択肢として HTML や TeX +などを基にし、それぞれのフォーマッタで様々な形式のファイルへ変換する +方法が考えられますが、これでは基となる形式の性質に特化しているため +変換後のファイルには十分な品質と高い柔軟性が得られません。SGML の特徴 +である自由な文書構造の定義によってのみ、高い品質の文書が得られるのです。

Linux JF プロジェクトにおいて、Linuxdoc-SGML の日本語版が作成されたの +も同じ理由からですが、もうひとつの理由があります。JF では FAQ を SGML +形式のタグで括ることで抽出するという試みを行なっています。情報抽出と +データベース化に SGML を利用し、その文書作成に Linuxdoc-SGML を活用 +しようというわけです。
+また、将来文書が全て SGML で統一されれば特定のタグの抽出による文書管理 +も可能となります。

+ + +

1.3 jLinuxdoc-SGML の仕組み

+ +

jLinuxdoc-SGML は SGML の構文を定義する DTD と、その構文を解釈し構文 +エラーをチェックし各種形式への変換を行なうパーサと、変換されたファイル +を整形するためのツールから成ります。DTD は QWERTZ DTD を基に作られて +おり、SGML パーサには土屋哲さん作の日本語版 sgmls を用いています。 +整形・変換用のツールとしては、LaTeX, groff, dvi2ps などが必要となります。 +例として DVI と Postscript への変換の処理の流れを以下に示します。 +


++1. SGML形式 －(構文解釈: sgmls が DTD を解釈)→ 中間形式
+2. 中間形式 －(変換: sgmlsasp が LaTeX 用 rep を基に変換)→ LaTeXソース
+3. LaTeXソース －(整形: jlatex, dvi2ps などで変換)→ DVI, Postscript
+
+

+ +sgmls は正確には、構文解釈を行なう sgmls と各種形式への変換を行なう +sgmlsasp によって構成されています。

DTD は構文を定義するのに使います。例えば、article の定義は +


++<!element article - -
+        (titlepag, header?, 
+         toc?, lof?, lot?, p*, sect*, 
+         (appendix, sect+)?, biblio?) +(footnote)>
+
+

+ +のように記述されます。article は titlepag, header, toc,... +といった要素から成り、それぞれの要素が必要かどうかといった定義がなされます。 +それぞれの要素は、SGML の文書内ではタグとして使われています。この例 +では、<article>, <titlepag>, <toc>といった +タグが使われることになります。
+DTD は sgmls によって解釈されて、ESIS形式と呼ばれる中間ファイルが +作られます。

各種形式に対応する rep(変換定義ファイル)を形式ごとに用意することで、 +様々な形式に変換することができます。 +例えば番号なしの箇条書の LaTeX 用の rep は以下のようになります。 +


++<itemize>       +       "\\begin{itemize}"      +
+</itemize>      +       "\\end{itemize}"        +
+
+

+ +同じことを HTML 用に定義すると以下のようになります。 +


++<itemize>       +       "<UL>"          +
+</itemize>      +       "</UL>"         +
+
+

+ +<itemize> が LaTeX では\begin{itemize} +と変換され、HTML では <UL> と変換されます。
+新たな形式のファイルへ変換したい場合は、DTD を定義し直す必要はなく、 +その形式に合わせた rep を作ればよいのです。

いったん sgmlsasp で各種形式のソースファイルを作ってしまえば、後は +それに合わせたフォーマッタで変換を行ないます。LaTeX では、jlatex +を用いて DVI ファイルを作り、必要なら dvi2ps などで Postscript ファイル +に変換します。プレーンテキストなら groff を使います。実際には、フォーマッタ +だけでなくいくつかのフィルタを使って整形や調整を行なっているものも +あります。

+ + +

1.4 jLinuxdoc-SGML v1.5 の入手とインストール

+ +

jLinuxdoc-SGML v1.5 は、JF の中に含まれます。以下の ftp site の他、国内の +多くの JF の mirror site から入手できます。 +

+JF の里＠京都大学

+ +インストールには、英語版の linuxdoc-sgml-1.5.tar.gz と日本語対応 +のためのパッチ jlinuxdoc-sgml-1.5.0.diff.tgz の他、groff や perl、 +flex、LaTeXなどが必要です。 +インストールは README.v1.5j を参照して行なってください。

jlinuxdoc-sgml に関する最新情報は +

+Linux JFの部屋「linuxdoc-sgml のページ」

+ +にて公開しています。

お気付きの点がありましたら、+ono@jf.gee.kyoto-u.ac.jp 宛にメールでご連絡ください。

+ + +

+前のページ +次のページ +目次 + + diff --git a/www/workshop/sgml-jguide/jguide-2.html b/www/workshop/sgml-jguide/jguide-2.html new file mode 100644 index 0000000..80850ca --- /dev/null +++ b/www/workshop/sgml-jguide/jguide-2.html @@ -0,0 +1,231 @@ + + +日本語版 Linuxdoc-SGML ガイド: SGML 文書を変換する + + +前のページ +次のページ +目次 +

2. SGML 文書を変換する

+ +

変換するファイル形式によって利用するコマンドやコマンドに与える引数 +が異なります。

+ +

2.1 文書の変換

+ +

本章では、HOWTO や faq を含む文書の変換方法を説明します。

+ +

ポストスクリプトファイルの作成

+ +

ポストスクリプト(PS)ファイルへの変換を行うには、sgml2latex +を使います。 +

日本語の SGML ファイルを PS ファイルに変換する。


++sgml2latex -p ファイル名.sgml
+
+

英語の SGML ファイルを PS ファイルに変換する。


++sgml2latex -a -p ファイル名.sgml
+
+

+ +以上により ファイル名.ps が作成されます。作成された +ファイル名.ps は ghostview 等ポストスクリプトファイル +のビューワーで見る事ができます。

なお、-a オプションは原版 Linuxdoc-SGML では A4 サイズの用紙の指定 +となっていますが、日本語版では用紙サイズは A4 がデフォルトなので、 +かわりに -u オプションで US letter を指定できるようになっており、 +-a はASCII 文字の使用を指定することになります。なお、日本語の文書 +を変換する場合は必ず A4 (デフォルト) で使用してください。

+ +

DVI ファイルの作成

+ +

DVI ファイルへの変換を行うには、sgml2latex を使います。 +

日本語の SGML ファイルを DVI ファイルに変換する。


++sgml2latex -d ファイル名.sgml
+
+

英語の SGML ファイルを DVI ファイルに変換する。


++sgml2latex -a -d ファイル名.sgml
+
+

日本語の SGML ファイルを LaTeX のソースファイルに変換する。


++sgml2latex ファイル名.sgml
+
+

+ +-d オプションを付けると ファイル名.dvi が作成され、 +オプションを付けないと ファイル名.tex が作成されます。作成 +された ファイル名.dvi は xdvi 等の dvi ファイルのビューワ +で見る事ができます。

+ +

プレーンテキストファイルの作成

+ +

プレーンテキストファイルへの変換を行うには、sgml2txt を使います。

日本語の SGML ファイルをプレーンテキストファイルに変換する。


++sgml2txt -f ファイル名.sgml
+
+

英語の SGML ファイルをプレーンテキストファイルに変換する。


++sgml2txt -f -a ファイル名.sgml
+
+

+ +-f オプションを付けないと、more や less で見た +ときにはボールド体で強調された文字が表示される状態になります。これはこれで +見やすいのですが、muleやviなどで見るとみにくくなります。 +roff で出力された強調文字をなくすには、-fオプションを付けて +実行します。
+以上により、ファイル名.txt が作成されます。

+ +

HTML ファイルの作成

+ +

HTML ファイルへの変換を行うには、sgml2html を使います。

日本語の SGML ファイルを HTML ファイルに変換する


++sgml2html ファイル名.sgml
+
+

英語の SGML ファイルを HTML ファイルに変換する


++sgml2html -a ファイル名.sgml
+
+

HTML ファイルは章ごとにひとつずつ ファイル名-章番号.html +という名前で作られ、さらにインデックス用に ファイル名.html +というファイルが作られます。これらのファイルは Netscape や Mosaic +等の WWW ブラウザを使って見ることができます。

+ +

man ページの作成

+ +

man ページの変換を行うには sgml2txt を使います。

roff 形式のファイルを作る


++sgml2txt -man ファイル名.sgml
+
+

cat 形式のファイルを作る


++sgml2txt -cat ファイル名.sgml
+
+

いずれの場合も、ファイル名.man というファイルが作られます。 +roff 形式のファイルは、従来の man ページに使われている形式で +


++groff -man -Tnippon ファイル名.man | less
+
+

+ +とすることで、man コマンドを使って見る場合と同じように読む +ことができます。このように roff を通した結果を cat 形式と言います。

roff 形式の man ページファイルは、ファイル名.章番号という名前にして + /usr/man/ja_JP.ujis/man章番号 というディレクトリ +にコピーします(linuxの場合)。cat 形式の man ページファイルは、同じく +ファイル名.章番号という名前にして /usr/man/ja_JP.ujis/cat章番号 +というディレクトリにコピーします。

+ +

GNU info ファイルへの変換

+ +

GNU info 形式のファイルへの変換を行うには、sgml2info を使います。 +残念ながらまだ日本語には対応していません。makeinfo の日本語版に +関する情報がありましたらご連絡ください。


++sgml2info ファイル名.sgml
+
+

とすると、ファイル名.info というファイルが作成されます。 +GNU info 形式のファイルは、emacs の info モードや info +コマンドを使って見ることができます。

+ +

LyX 形式ファイルへの変換

+ +

LyX とは LaTeX のインターフェイスとなって WYSIWYG を実現する一種の +ワープロです。残念ながら LyX の日本語版はありません。 +LyX 形式のファイルへの変換を行なうには、sgml2lyx を使います。

+ +

RTF 形式ファイルへの変換

+ +

筆者の不勉強のため、これが何者なのか全くわかっていません。 +RTF についての情報がありましたらご連絡ください。 +RTF 形式ファイルへの変換は、sgml2rtf を使って行ないます。

+ +

SGML 構文チェックを行うには

+ +

SGML の構文チェックを行うには、sgmlcheck を使います。


++sgmlcheck ファイル名.sgml
+
+

ここでは、DTD に即した構文になっているかをチェックしているだけなので、 +正しい変換が行なわれているかどうかは出力結果を見て自分でチェックする +必要があります。

+ + +

2.2 ISO 8859-1 文字セットの扱い

+ +

原版の Linuxdoc-SGML では ISO 8859-1 (latin1) 文字セットについても、 +プレーンテキストと LaTeX、HTML、LyX、RTF で利用可能となっています。 +日本語版でも利用可能なはずですが試していません。もし問題があったと +しても、若干の修正で利用できるはずです。
+ISO 8859-1 文字セットを利用するには、-l オプションを付けて、各種の +コマンドを実行します。

+ + + +

+前のページ +次のページ +目次 + + diff --git a/www/workshop/sgml-jguide/jguide-3.html b/www/workshop/sgml-jguide/jguide-3.html new file mode 100644 index 0000000..2885be6 --- /dev/null +++ b/www/workshop/sgml-jguide/jguide-3.html @@ -0,0 +1,749 @@ + + +日本語版 Linuxdoc-SGML ガイド: SGML で文書を書くには + + +前のページ +次のページ +目次 +

3. SGML で文書を書くには

+ +

ここでは linuxdoc.dtd を使った文書の書き方について説明します。

+ +

3.1 文書の始め方

+ +

一番最初に覚えなければならないことを簡単に書きます。

+ +

SGML ファイルの最初

+ +

SGML では (コメントは別にして) 必ず +


++<!doctype linuxdoc system>
+
+

+ +で始めなければなりません。 +この命令は簡単にいうと、``linuxdoc.dtd'' を使った文書である事を指定し +ています。

+ +

使用する文字

+ +

入力に使用できるキャラクタとしては、かな、漢字、英数字、および次の記号 +です。


++: ; . , ? ! ` ' ( ) - / * @ ^ _ + = { } |
+
+

【注意】 jlinuxdoc-sgml では、EUC 漢字コードを使うようになっていますので、EUC コードで文書を書くようにして下さい。 +また、半角カナと呼ばれている文字は使えません。

【注意】行頭を . で始めますと、テキストに変換する際に、問題が発生 +します。よって、行頭には . を記述しないようにして下さい。

+ +

特殊文字

+ +

SGML では、以下の記号をコマンドとして認識してしまいますので、その記号 +を文字として使いたい場合には下のように入力して下さい。

左角かっこ ([) を使うには [ と入 +力します
右角かっこ (]) を使うには ] と入 +力します
アンパサンド (&) を使うには & と入 +力します
左ブラケット (<) を使うには < と入力 +します
右ブラケット (>) を使うには > と入力 +します
左ブラケット＋スラッシュ (</) を使うには +&etago; と入力します
ドルマーク ($) を使うには &dollar; +と入力します
シャープ (#) を使うには &num; と入力し +ます
パーセント (%) を使うには &percnt; +と入力します
バックスラッシュ (\) を使うには +\ と入力します
二重引用符を使うには `` と '' と入力するか、 +" を表示させるには &dquot; と入力します

+ + +

3.2 タグ

+ +

SGML でのコマンドはタグと呼ばれます。タグには開始タグと終了タ +グがあり、開始タグは <タグ名> であり、終了タグは +</タグ名> です。また、開始タグしか必要としないものもあり +ますし、<タグ名/内容/ という短縮形式もあります。

開始タグと終了タグではさまれている部分に、そのタグの内容が適用されます。 +LaTeX の環境と同じようなものですね。

+ + +

3.3 原稿の書き方

+ +

ドキュメントつまり原稿は、いづれかのスタイルを指定しなければなりません。 +スタイルには以下のものが指定できます。ほとんど、LaTeX で使われているも +のと同様です。

article: もっともポピュラーなスタイルです。HOWTO にはこれを使いま +す。
+
report: レポート形式です。
+
book: 本の形式です。
+
manpage: man ページの形式です。
+

例えば article を使う場合には、 +


++<!doctype linuxdoc system>
+
+<article>
+
+本文
+
+</article>
+
+

+ +と指定します。

なお、man ページについては、後で詳しく説明します。

+ + +

3.4 タイトル

+ +

文書のタイトル、著者、日付や概要は、スタイル (例えば<article>) +の後に記述します。

<title>: 文書のタイトルを記述します。(必須)
+
<auther>: 著者を記述します。(必須)
+
<trans>: 翻訳者を記述します。(オプション)
+
<date>: 文書のバージョンや日付を記述します。(オプション)
+
<tdate>: 翻訳された文書のバージョンや日付を記述します。(オプション)
+
<abstract>...</abstract>: 概要を記述します。(オプ +ション)
+

例えば、以下のようになります。 +


++<title>SGML を書こう！！
+<author>さとけん＠ＦｏｒＵｓ,<tt/ken@gamba.forus.or.jp/
+<date>v0.1 alpha, 20 September 1994
+<abstract>
+SGML を使って文書を書いてみよう。
+</abstract>
+
+

【注意】 <date> は、<author> もしくは <trans> の +直後でないと、エラーとなります。

+ + +

3.5 文章構成

+ +

文章の構成で、章や節を表すものとして、次のようなセクションタグが用意さ +れています。これらは、タイトルの後に記述することができます。

<sect>: トップレベルの章で、LaTeX の section に相当します。 +(1, 2, ...)
+
<sect1>: 第 2 レベルの章で、LaTeX の subsection に相当します。 +(1.1, 1.2, ...)
+
<sect2>: 第 3 レベルの章で、LaTeX の subsubsection に相当し +ます。(1.1.1, 1.1.2, ...)
+
<sect3>: 第 4 レベルの章で、LaTeX の paragraph に相当します。
+
<sect4>: 第 5 レベルの章で、LaTeX の subparagraph に相当しま +す。
+

また、それぞれのタグの直後に、対応した見出しを記述します。

例えば文書の最初に``概要''という章を記述するには、 +


++<sect>概要
+
+

+ +とすればよいですし、あなたが今読んでいるこの章は +


++<sect1>文章構成
+
+

+ +と記述されています。

セクションタグの後で、実際の本文を書くには タグを本文の前に +記述して下さい。

例えば、次のようになります。 +


++<sect>概要
+<p>
+この文書は、<tt/jlinuxdoc-sgml/ 文書整形システムの...
+
+

これは、sgmls パーサーに章見出しと本文の区切りを教えているのです。 +しかし、段落の区切りを指定する必要があるのは、セクションタグの後だけで、 +その後の段落の区切りは空行で大丈夫です。(こういう段落の区切り方は、 +LaTeX でよくやられていることでしょう。)

例えば、次のようになります。 +


++<p>
+ここは最初の段落です。
+
+ここは次の段落です。
+
+

ただ、最初の段落以外で タグを使ってはいけないわけではありま +せん。最初の段落で必ず指定しなければならないだけです。

+ + +

3.6 文の整形と改行

+ +

jlinuxdoc-sgml では roff、LaTeX、HTML を使って、文 +書を整形しますので、文字列や行を自動的に詰めたり、改行したりします。 +よって、整形ルールはそれぞれのフォーマッタに依存します。

また、通常 SGML のソース文書での改行は無視されます。強制的に改行を行なう +場合は<newline> を行末に挿入してください。また、空行か +を挿入するとその前の文に改行が入り行間が空きます。

また、空白文字の扱いはフォーマッタによって異なります。プレーンテキスト +の場合は空白文字をそのまま空白として出力しますが、DVI や PS, HTML では +つめて出力(表示)されます。

変換前：


++雨が降る降る
+雨が降る
+<p>
+遊びに行きたし<newline>
+傘はなし
+
+草履の    鼻緒も
+擦り切れた
+
+

+ +

変換後：

+雨が降る降る +雨が降る +遊びに行きたし +傘はなし +草履の鼻緒も +擦り切れた +

タイトルページでは、改行は可能ですが空行を作ることはできません。従って +<abstract> タグの中で空行を設けたり を挿入してもエラー +になるか無視されます。

なお、roff の整形はあまり精錬されていないため、他の環境でも空行が無視され +たり、逆に空行が多すぎたりすることがあります。そのため、sgml2txt では +3 行以上の空行を 2 行の空行に縮めています。

+ + +

3.7 コメント

+ +

SGML 文書のなかに、フォーマット出力には含めないコメントを書くには、 +


++<!--
+コメント
+-->
+
+

+ +とします。

+ + +

3.8 打ち込んだ通りに出力する

+ +

LaTeX の verbatim 環境と同じように、打ち込んだ通りに出力させるには、 +<verb>...</verb> で囲みます。

例えば、 +

+ここは、<verb> と </verb> でかこまれています。
+

+ +とするには、 +


++<verb>
+ここは、<verb> と &etago;verb> でかこまれています。
+</verb>
+
+

+ +と記述します。もちろん、空白もそのまま出力されます。

ただし、<verb>...</verb> の中でも、&,</ の 2 文字は +使えませんので、それぞれ、

アンパサンド (&) を使うには &ero;
左ブラケット＋スラッシュ (</) を使うには +&etago;

と入力します。

また、LaTeX の verbatim 環境を使う関係で、\end{verbatim} は記述し +ないで下さい。

+ + + +

3.9 プログラムやアルゴリズム

+ +

プログラムやアルゴリズムをフォーマットするには、基本的には verb 環境を +用いますが、ちょっとアクセントをつける方法を説明します。

プログラムやアルゴリズムの出力には、 +

<code>...</code>: コード環境
+
<tscreen>...</tscreen>: スクリーン環境
+
<quote>...</quote>: クオート環境
+

+ +が使えます。

+ +

コード環境

+ +

<code>...</code> ではさまれた部分をコード環境といいます。 +コード環境は、ほとんど verb 環境と同じですが、上下に線が引かれます。

例えば、 +

+これは <code>...</code> の例です。
+

+ +とするには、 +


++<code>
+これは <code>...&etago;code> の例です。
+</code>
+
+

+ +とします。

+ +

スクリーン環境

+ +

<tscreen>...<tscreen> ではさまれた部分をスクリーン環境とい +います。スクリーン環境では、自動的にインデント、タイプライタ書体の指定 +が行われます。主に verb 環境といっしょに使われます。

例えば、 +


++これは <tscreen><verb>...</verb></tscreen> の例です。
+
+

+ +とするには、 +


++<tscreen><verb>
+これは <tscreen><verb>...&etago;verb>&etago;tscreen> の例です。
+</verb></tscreen>
+
+

+ +とします。

+ +

クオート環境

+ +

<quote>...<quote> ではさまれた部分をクオート環境といいます。 +クオート環境では、自動的にインデントが行われます。

例えば、 +

+これは <quote>...</quote> の例です。 +

+ +とするには、 +


++<quote>
+これは <quote>...&etago;quote> の例です。
+</quote>
+
+

+ +とします。

+ + +

3.10 フォント

+ +

jlinuxdoc-sgml では LaTeX と同じようなフォントの指定をサポートし +ています。ただし、プレーンテキストにする場合にはフォントの指定は無視さ +れます。

em: 強調 (例:em)
+
it: イタリック (例:it)
+
bf: ボールドフェース (例:bf)
+
sf: サン・セリフ (例:sf)
+
sl: スランテッド (例:sl)
+
tt: タイプライタ (例:tt)
+
cparam: cparam (例:cparam) #LaTeX の \cparam{} +に相当します。
+

フォントを指定する場合には、指定する内容をタグではさみます。 +例えば、タイプライタ書体にするには、以下のようにします。 +


++Here is some <tt>typewriter text</tt> to be included in the document.
+
+

また、内容に``/''が含まれない場合には、以下の短縮形式を使う事もできま +す。 +


++Here is some <tt/typewriter text/ to be included in the document.
+
+

ただし、全ての出力形式 (HTML 等) でサポートされているわけではないので、 +bf、it、tt 以外のフォントはあまり使うべきでは無いでしょう。bf、it、tt +だけでも、文書を書くには十分でしょう。

+ + +

3.11 箇条書き

+ +

jlinuxdoc-sgml ではいくつかの箇条書き (リスト) をサポートしていま +す。サポートしているのは、以下の 3 種類の箇条書きです。 +

<itemize>...</itemize>: 頭に記号を付けた箇条書き +です。
+
<enum>...</enum>: 項目に番号を付けた箇条書きです。
+
<descrip>...</descrip>: 見出しを付けた箇条書きで +す。
+

+ +

itemize リスト

+ +

itemize リストでは、それぞれの項目の頭に記号が付けられます。 +例えば、 +

+jlinuxdoc-sgml には + +itemize リスト +enum リスト +descrip リスト + + +があります。 +

+ +と出力するには、 +


++<tt/jlinuxdoc-sgml/ には
+<itemize>
+<item>itemize リスト
+<item>enum リスト
+<item>descrip リスト
+</itemize>
+があります。
+
+

+ +のように、リストの先頭で <itemize> を記述し、それぞれの項目の先 +頭には <item> を付けて、最後に </itemize> を記述します。

当然、ネスト (入れ子) も可能です。

+ +

enum リスト

+ +

enum リストでは、それぞれの項目に番号が付けられます。 +例えば、 +

+jlinuxdoc-sgml には + +itemize リスト +enum リスト +descrip リスト + + +があります。 +

+ +と出力するには、 +


++<tt/jlinuxdoc-sgml/ には
+<enum>
+<item>itemize リスト
+<item>enum リスト
+<item>descrip リスト
+</enum>
+があります。
+
+

+ +のように、リストの先頭で <enum> を記述し、それぞれの項目の先頭に +は <item> を付けて、最後に </enum> を記述します。

当然、ネスト (入れ子) も可能です。

+ +

descrip リスト

+ +

descrip リストでは、それぞれの項目に見出しが付けられます。 +例えば、 +

+jlinuxdoc-sgml でサポートされている箇条書きの種類は + +itemize 頭に・などの記号を付けた箇条書きです。 + enum 項目に番号を付けた箇条書きです。 + descrip 見出しを付けた箇条書きです。 + + +の3種類です。 +

+ +と出力するには、 +


++<tt/jlinuxdoc-sgml/ でサポートされている箇条書きの種類は
+<descrip>
+<tag/itemize/頭に・などの記号を付けた箇条書きです。
+<tag/enum/項目に番号を付けた箇条書きです。
+<tag/descrip/見出しを付けた箇条書きです。
+</descrip>
+の3種類です。
+
+

+ +のように、リストの先頭で <descrip> を記述し、最後に +</descrip> を記述します。また、それぞれの項目は <tag/見出し/ +内容と記述します。なお、見出しの部分に``/''を含めたい場合には、 +<tag>見出し</tag>内容と記述して下さい。

ただし、LaTeX を使う場合、見出しの部分には、 +\ が入力できませんので、注意して下さい。

当然、ネスト (入れ子) も可能です。

+ + +

3.12 相互参照

+ +

<sect?> には自動的に通し番号が付けられますが、これを別の部分から +参照する方法を説明します。

まず、参照される部分へのラベル付けを行います。


++<sect1>概要<label id="sec-intro">
+
+

これで、ラベルが付けられましたので、他の場所で以下のように参照すること +ができるようになります。


++概要については、<ref id="sec-intro" name="概要">を参照して下さい。
+
+

この場合、ref タグによって、sec-intro のセクション番 +号に置き換えられます。

また、name は HTML や nroff に変換する場合 +に必要です。

なお、HTML に変換した場合には、名前の部分をクリックすることに +よって、その場所に移動できます。

例えば、この章は +相互参照です。

【裏技】

せっかくの相互参照も、節や章しか参照できないのではちょっと +機能不足ですね。実は、label は任意の場所に設定することができるのです +が、LaTeX での参照の際に節番号を参照するので、節や章しか参照できない +ようになっているのです。 +だからといってあきらめる必要はありません。<htmlurl> というタグ +を使って解決することができます。

次の節の +htmlurlのタグを参照のこと。

+ + + +

3.13 HTML での URL を記述するには

+ +

W3 (World Wide Web) で使われる URL (Universal Resource +Locators) も記述することができます。

Mosaic 等で``Linux Documentation Projectのホームページ''と書かれている +部分をクリックすることで、sunsite.unc.edu の +/mdw/linux.html ファイルを参照するようにするには以下のように +します。


++<url url="http://sunsite.unc.edu/mdw/linux.html" 
+     name="Linux Documentation Projectのホームページ">
+
+

url の引数には、実際の URL を記述します。また name +の引数には URL の名前や内容を記述しますが、これはオプションですので記 +述しなくても結構です。

また、jf.gee.kyoto-u.ac.jp の +/pub/JF/misc/linuxdoc-sgml-1.5.tar.gz を ftp して来る +ようにするには、 +


++<url url=
+"ftp://jf.gee.kyoto-u.ac.jp/pub/JF/misc/linuxdoc-sgml-1.5.tar.gz">
+
+

+ +とします。

例えば、 +【オリジナルのLinuxdoc-SGML v1.5を入手するにはここをクリックして下さい。】 +となります。

+ + +さらに、より機能の高い HTML の URL を表記するためには +<htmlurl url=.... > というタグを使います。例えば、メールを送る +ためのアドレスを書くときには、 +


++<htmlurl url="mailto:ono@jf.gee.kyoto-u.ac.jp"
+           name="ono@jf.gee.kyoto-u.ac.jp">
+
+

+ +のように書くことにより、Netscape などの WWW ブラウザ上でメールを送る +ためのフォームを出すことができるようになります。 +

例：: ご用命の際は +ono@jf.gee.kyoto-u.ac.jp まで。
+

<htmlurl> タグを使えば以下のようにして、同一文書中のラベルを直接 +指定することもできます。 +


++<htmlurl url="#CrossRef" name="相互参照の節"> を参照のこと。
+
+

+相互参照の節を参照のこと。

+ + +

3.14 目次

+ +

目次を作るのは簡単です。目次をいれたい部分に +


++<toc>
+
+

+ +を記述するだけです。大抵は、</abstract> の後に記述されるのがよい +でしょう。

ただし、実際に目次が挿入されるのは、LaTeX を通して作られる +dvi と PS ファイルのみです。 +textファイルでは単に無視されるだけですし、htmlファイ +ルでは指定しなくても、作成されます。

+ + + +

3.15 横線を引くには

+ +

文書中で +

+このように横線を引くには、 +


++<hrule>
+
+

+ +と記述するだけです。

+ + +

3.16 FAQ を記述するには

+ +

ここでは、Linux コミュニティで利用されている FAQフォー +マットを記述する方法を説明します。

たとえば、 +

[Item] ソフト名やハードウェアや規格・言語などのキーワード
+
[投稿者] 発言者の名前とメールアドレス
+
[日付] 発言した日付
+
[質問] +: 質問の詳細
+
[回答] +: 質問に対する回答
+
[投稿者] 発言者の名前とメールアドレス
+
[コメント] +: 質問あるいは回答に対するコメント(回答に自身がない場合など)
+

+と出力したい場合は、 +


++<faq>
+<keyword>ソフト名やハードウェアや規格・言語などのキーワード
+<poster>発言者の名前とメールアドレス
+<pdate>発言した日付
+<question>
+質問の詳細
+</question>
+<answer>
+質問に対する回答
+</answer>
+<poster>発言者の名前とメールアドレス
+<coment>
+質問あるいは回答に対するコメント(回答に自身がない場合など)
+</coment>
+</faq>
+
+

+ +と記述します。

【注意】本来の FAQ フォーマットとの違いは、以下の通りです。


++<FAQ> → <faq>
+<Item> → <keyword>
+<Subject> → <faq> の前に <sect?> として記述
+<Poster> → <poster>
+<Date> → <pdate>
+<Q> → <question>
+</Q> → </question>
+<A> → <answer>
+</A> → </answer>
+<C> → <coment>
+</C> → </coment>
+</FAQ> → </faq>
+
+

FAQ をまとめた、 faqdb 形式のファイルを、jlinuxdoc-sgml で処 +理できるファイルに変換するためのフィルタとして、bin/faqdb2doc +がありますので、御利用下さい。このフィルタを使えば、上記の違いも変更さ +れます。

+ + +

+前のページ +次のページ +目次 + + diff --git a/www/workshop/sgml-jguide/jguide-4.html b/www/workshop/sgml-jguide/jguide-4.html new file mode 100644 index 0000000..661897e --- /dev/null +++ b/www/workshop/sgml-jguide/jguide-4.html @@ -0,0 +1,95 @@ + + +日本語版 Linuxdoc-SGML ガイド: Man ページの書き方 + + +前のページ +次のページ +目次 +

4. Man ページの書き方

+ +

この章では jlinuxdoc-sgml を使って、Man ページ を書 +く方法について説明します。

+ +

4.1 全体の構成

+ +

Man ページは、以下の様に記述します。 +


++<!doctype linuxdoc system>
+
+<manpage title="名前">
+
+<sect1>名前
+<p>
+名前 - 機能の簡単な説明
+
+<sect1>形式
+<p>
+使用方法
+
+<sect1>機能説明
+<p>
+詳細な説明
+
+<sect1>オプション
+<p>
+コマンドのオプションの説明
+
+<sect1>環境変数
+<p>
+関連する環境変数の説明
+
+<sect1>ファイル
+<p>
+関連するファイルの説明
+
+<sect1>関連項目
+<p>
+関連するマニュアルの紹介
+
+<sect1>バグ
+<p>
+バグの説明
+
+</manpage>
+
+

上記の内、名前(NAME)と形式(SYNOPSIS)と機能説明(DESCRIPTION)は必須です +が、それ以外の章は省略可能ですし、他の章を追加することも可能です。例え +ば「不具合＆改良案」という章を追加し、コマンドの作者名と連絡先(メール +アドレス)を示したりすることはよくあります。

+ + +

4.2 スタイル

+ +

スタイルには、<manpage>...</manpage>を指定しま +す。また、<manpage> の部分で「名前」と「章番号」を指定します。な +お、章番号のデフォルトが 1 に設定されていますので、章番号が 1 の場合に +は省略できます。

名前が mh-alias、章番号が 5 の場合には以下のようになります。 +


++<manpage title="MH-ALIAS" sectnum="5">
+
+

+ + +

4.3 各章

+ +

各章は <sect1> を使用して書くことに注意する以外は、他の文書の書 +き方と同じです。

man ページのサンプルとして、doc/kon.sgml が添付されています。 +御参照下さい。

+ + + +

+前のページ +次のページ +目次 + + diff --git a/www/workshop/sgml-jguide/jguide-5.html b/www/workshop/sgml-jguide/jguide-5.html new file mode 100644 index 0000000..a4b999f --- /dev/null +++ b/www/workshop/sgml-jguide/jguide-5.html @@ -0,0 +1,216 @@ + + +日本語版 Linuxdoc-SGML ガイド: Emacs を使った SGML ファイルの編集 + + +前のページ +次のページ +目次 +

5. Emacs を使った SGML ファイルの編集

+ +

jlinuxdoc-sgml には Emacs で SGML ファイルを編集する +ための、lnxsgml.el が含まれています。ここでは、このパッケージ +を使った SGML ファイルの編集方法について説明します。

なお、lnxsgml.el 以外の Emacs の使い方は説明しませんので、他の解説書を +お読み下さい。

lnxsgml.el は SGML ファイル編集用のメジャーモードです。

筆者は、Mule Version.2 を使っていますので、その他の Emacs をお使いの方で不具合を見付けた方は連絡して下さい。 +善処します。

+ +

5.1 Mule Version.2 での特徴

+ +

Mule Version.2 で lnxsgml.el をお使いになりますと、 +

メニューバーに``SGML''メニューが登録されますので、キーを覚えなく +てもメニュー形式でほとんどの作業ができます。
(hilit19.el をロードしておくと) SGML のタグ等に色が付き +ますので、文との違いが分かりやすくなります。

+ +などの機能があります。

ただし本説明書では、これらの機能については詳しく説明しません。 +お試し下さい。

+ + +

5.2 使う前の準備

+ +

ここでは、lnxsgml.el を使う前にしておかなければならない準備に +ついて、説明します。

+ +

初期化ファイル

+ +

あなたの .emacs ファイルに以下の行を追加して下さい。


++(setq auto-mode-alist (mapcar 'purecopy
+                              '(("\\.sgml$" . sgml-mode))))
+(autoload 'sgml-mode "lnxsgml" "Major mode fo editing files of SGML." t)
+
+

これで、.sgml で終るファイルを編集する時は、自動的に lnxsgml.el が読み +込まれるようになります。

+ + + +

5.3 タグの挿入

+ +

ここでは、各種タグの挿入に関する機能について、説明します。

C-c a (sgml-abstract)

カーソル位置に <abstract> と +</abstract> を挿入し、カーソルをタグの間に移動します。

C-c c (sgml-code)

カーソル位置に <code> と +</code> を挿入し、カーソルをタグの間に移動します。

C-c C-r c (sgml-code-region)

指定されたリージョンの最初に +<code> を、最後に </code> を挿入します。

C-c C (sgml-comment)

カーソル位置に  を挿入 +し、カーソルを開始タグと終了タグの間に移動します。

C-c C-r C (sgml-comment-region)

指定されたリージョンの最初に + を挿入します。

C-c C-d (sgml-make-document)

対話的に style name を +入力し、以下のタグを挿入します。

<!doctype dtd namesystem>

<style name>

<title>

<date>

</style name>

C-c d (sgml-descrip)

カーソル位置に <descrip> と +</descrip> を挿入し、カーソルをタグの間に移動します。

C-c C-e (sgml-make-environment)

対話的に environment +name を入力し、カーソル位置に <environment name> +と </environment name> を挿入し、カーソルをタグの間に移 +動します。

C-c e (sgml-enum)

カーソル位置に <enum> と +</enum> を挿入し、カーソルをタグの間に移動します。

C-c TAB (sgml-item)

カーソル位置に <item> タグを挿入し、 +カーソルをタグの後に移動します。

C-c i (sgml-itemize)

カーソル位置に <itemize> と +</itemize> を挿入し、カーソルをタグの間に移動します。

C-c l (sgml-label)

対話的に label id を入力し、カー +ソル位置に <label id="label id"> タグを挿入します。

C-c p (sgml-paragraph)

カーソル位置に タグを挿入します。

C-c q (sgml-quote)

カーソル位置に <quote> と +</quote> を挿入し、カーソルをタグの間に移動します。

C-c C-r q (sgml-quote-region)

指定されたリージョンの最初に +<quote> を、最後に </quote> を挿入します。

C-c r (sgml-ref)

対話的に ref id と name +を入力し、カーソル位置に <ref id="ref id" +name="name"> を挿入します。

C-c t (sgml-tscreen)

カーソル位置に <tscreen> と +</tscreen> を挿入し、カーソルをタグの間に移動します。

C-c C-r t (sgml-tscreen-region)

指定されたリージョンの最初に +<tscreen> を、最後に </tscreen> を挿入します。

C-c T (sgml-tag)

カーソル位置に <tag></tag> タグ +を挿入し、カーソルをタグの間に移動します。

C-c C-s (sgml-make-start)

対話的に tag name を入力 +し、カーソル位置に <tag name> タグを挿入します。

C-c s (sgml-sect)

カーソル位置に <sect> タグを挿入します。 +なお、``C-u''をいくつ入力するかによって、セクションレベルが変わります。 +

C-c s: <sect> タグの挿入
+
C-u C-c s: <sect1> タグの挿入
+
C-u C-u C-c s: <sect2> タグの挿入
+
C-u C-u C-u C-c s: <sect3> タグの挿入
+
C-u C-u C-u C-u C-c s: <sect4> タグの挿入
+

C-c v (sgml-verb)

カーソル位置に <verb> と +</verb> タグを挿入し、カーソルをタグの間に移動します。

C-c C-r v (sgml-verb-region)

指定されたリージョンの最初に +<verb> を、最後に </verb> を挿入します。

+ + +

5.4 フォント変更タグの挿入

+ +

ここでは、フォント変更タグの挿入に関する機能について、説明します。

C-c C-f b (sgml-font-bf): カーソル位置に <bf> と +</bf> を挿入し、カーソルをタグの間に移動します。
+
C-c C-f c (sgml-font-cparam): カーソル位置に <cparam> +と </cparam> を挿入し、カーソルをタグの間に移動します。
+
C-c C-f e (sgml-font-em): カーソル位置に と + を挿入し、カーソルをタグの間に移動します。
+
C-c C-f i (sgml-font-it): カーソル位置に <it> と +</it> を挿入し、カーソルをタグの間に移動します。
+
C-c C-f f (sgml-font-sf): カーソル位置に <sf> と +</sf> を挿入し、カーソルをタグの間に移動します。
+
C-c C-f s (sgml-font-sl): カーソル位置に <sl> と +</sl> を挿入し、カーソルをタグの間に移動します。
+
C-c C-f t (sgml-font-tt): カーソル位置に <tt> と +</tt> を挿入し、カーソルをタグの間に移動します。
+
C-c C-f C-r b (sgml-font-bf-region): 指定されたリージョンの最 +初に <bf> を、最後に </bf> を挿入します。
+
C-c C-fC-rc(sgml-font-cparam-region): 指定されたリージョンの +最初に <cparam> を、最後に </cparam> を挿入します。
+
C-c C-f C-r e (sgml-font-em-region): 指定されたリージョンの最 +初に を、最後に を挿入します。
+
C-c C-f C-r i (sgml-font-it-region): 指定されたリージョンの最 +初に <it> を、最後に </it> を挿入します。
+
C-c C-f C-r f (sgml-font-sf-region): 指定されたリージョンの最 +初に <sf> を、最後に </sf> を挿入します。
+
C-c C-f C-r s (sgml-font-sl-region): 指定されたリージョンの最 +初に <sl> を、最後に </sl> を挿入します。
+
C-c C-f C-r t (sgml-font-tt-region): 指定されたリージョンの最 +初に <tt> を、最後に </tt> を挿入します。
+

+ + + +

5.5 特殊キャラクタの挿入

+ +

ここでは、特殊キャラクタの挿入に関する機能について、説明します。

C-c & (sgml-amp): カーソル位置に & を挿入します。
+
C-c < (sgml-lt): カーソル位置に < を挿入します。
+
C-c > (sgml-gt): カーソル位置に > を挿入します。
+
C-c / (sgml-etago): カーソル位置に &etago; を挿入します。
+
C-c $ (sgml-dollor): カーソル位置に &dollor; を挿入します。
+
C-c # (sgml-num): カーソル位置に &num; を挿入します。
+
C-c % (sgml-percnt): カーソル位置に &percnt; を挿入します。
+
C-c \ (sgml-bsol): カーソル位置に \ を挿入します。
+
C-c [ (sgml-lsqb): カーソル位置に [ を挿入します。
+
C-c ] (sgml-rsqb): カーソル位置に ] を挿入します。
+
C-c " (sgml-dquot): カーソル位置に &dquot; を挿入します。
+

+ + +

5.6 その他の機能

+ +

ここでは、タグ挿入以外の機能について、説明します。

C-c C-v (sgml-validate): 編集ファイルの SGML 構文チェックを行 +います。
+
C-c C-t d (sgml-translate-dvi): 編集ファイルを dvi ファイルに +変換します。
+
C-c C-t p (sgml-translate-dvi): 編集ファイルを PS ファイルに +変換します。
+
C-c C-t h (sgml-translate-dvi): 編集ファイルを HTML ファイル +に変換します。
+
C-c C-t t (sgml-translate-dvi): 編集ファイルを text ファイル +に変換します。
+
>: > キーが入力されると、``>''を挿入し、対応する +``<''に一度カーソルが移動します。
+
/: / キーが入力されると、``/''を挿入し、対応する``/''に一度カー +ソルが移動します。
+

+ + + +

+前のページ +次のページ +目次 + + diff --git a/www/workshop/sgml-jguide/jguide-6.html b/www/workshop/sgml-jguide/jguide-6.html new file mode 100644 index 0000000..3da4f60 --- /dev/null +++ b/www/workshop/sgml-jguide/jguide-6.html @@ -0,0 +1,95 @@ + + +日本語版 Linuxdoc-SGML ガイド: 他の版との違い + + +前のページ +次のページ +目次 +

6. 他の版との違い

+ + +

6.1 原版 Linuxdoc-SGML v1.5 との違い

+ +

jLinuxdoc-SGML v1.5 では、原版とほぼ同じ操作でほぼ同じ出力が得られる +ようデザインされており、日本語対応の拡張をした原版のスーパーセットと +なっています。 +従ってコマンドの使い方や SGML のタグの書き方はほとんど同じです。コマンド +に関してはデフォルトで日本語対応となっており、"-a" オプ +ションを指定することで英語版と同じ動作をします。

英語版にない特徴として、 +

翻訳者や翻訳日に関するタグの追加
FAQ リストの作成機能とタグの追加
SGML の文書の作成をサポートする emacs lisp コードの利用

+ +という機能を付け加えています。

なお、GNU info, LyX, RTF 形式への変換の日本語化は行なわれていません。

+ + +

6.2 jLinuxdoc-SGML v1.1 との違い

+ +

原版の Linuxdoc-SGML v1.5 に合わせてコマンド体系が大きく変わり、多くの +バグを取り除かれ、出力のデザインが原版に近付きました。 +コマンドの変更は以下の通りです。 +

+    fmttext  → sgml2txt -e     プレーンテキストへの変換
+    fmthtml  → sgml2html       HTMLファイルへの変換
+    fmtdvi   → sgml2latex -d   DVIファイルへの変換
+    fmtps    → sgml2latex -p   PSファイルへの変換
+    fmtman   → sgml2txt -man   manページファイルへの変換
+    fmtcheck → sgmlcheck       SGMLの構文のチェック
+

+ +SGML のタグの変更はほとんどありませんが、 +HTML の高機能な URL に対応した機能強化がなされています。これに伴い +label タグの書き方が変更されています。 +相互参照の +節を参照してください。

v1.1 との最大の違いは、v1.5 では原版のスーパーセットとなっていること +です。原版を別途インストールすることなく、英語のファイルの変換も +問題なくこなすことができるのは大きなメリットです。 +v1.1 からは多くのバグがとれタグの変更もなされているので、v1.1 のユーザ +は v1.5 へ移行することを強くお奨めします。

+ + +

6.3 jLinuxdoc-SGML v1.4 との違い

+ +

v1.4 からの変更は原版の更新に合わせたもので、いくつかのコマンド名の +変更とオプションの変更やデザインの変更があります。 +コマンドの変更は以下の通りです。 +

+    sgml2txt -e  → sgml2txt -f    強調なしのプレーンテキストへの変換
+    sgml2ps -T   → sgml2latex     LaTeX ソースファイルへの変換
+    sgml2ps -d   → sgml2latex -d  DVI ファイルへの変換
+    sgml2ps      → sgml2latex -p  PS ファイルへの変換
+    sgml2* -c    → sgmlcheck      SGML の構文のチェック
+

+ +オプションの詳細については、それぞれのコマンドのヘルプ(-help を付けて +起動すると表示される)をご覧ください。

デザインの変更には以下のものがあります。 +

プレーンテキストでも目次が付くようになった。
原版に合わせ、プレーンテキストで1 行以上の余分な空白行があると消去す +るよう変更(v1.4 では 2 行だった)。-b オプションで制御可能。
LaTeX 用の出力のデザインが原版により近くなった。
原版に合わせ、HTML の各ページへのリンクの部分が変更された。

また、強調文字をなくしたプレーンテキストの出力ファイル名は v1.4 +では .euc という拡張子がつきましたが、v1.5 では原版にあわせて .txt +のままとしました。

機能的には、プレーンテキストで目次がつくようになった点以外には大きな +変更はありませんので、v1.4 のユーザが v1.5 に移行する必要性はあまり +ありません。

+ + +

+前のページ +次のページ +目次 + + diff --git a/www/workshop/sgml-jguide/jguide-7.html b/www/workshop/sgml-jguide/jguide-7.html new file mode 100644 index 0000000..f18d8ad --- /dev/null +++ b/www/workshop/sgml-jguide/jguide-7.html @@ -0,0 +1,37 @@ + + +日本語版 Linuxdoc-SGML ガイド: 謝辞 + + +前のページ +次のページ +目次 +

7. 謝辞

+ +

linuxdoc-sgml の日本語化にあたっては、以下の方々に大変お世話 +になりました。

+小島＠電中研さん <kojima@komae.denken.or.jp>
+土屋 哲さん <tsuchiya@sysrap.cs.fujitsu.co.jp>
+箕浦 逸史さん <JBE03235@niftyserve.or.jp>
+森本＠IMAGICAさん <morimoto@lab.imagica.co.jp>
+片山＠京大理さん <shackon@kaba.or.jp>
+山崎＠ＣＲＣ総研さん <c1962@crcsn23.tyk.crc.co.jp>
+真鍋＠豊技大さん <manabe@Roy.dsl.tutics.tut.ac.jp>
+阿部＠三菱電機さん <hironobu@ap.isl.melco.co.jp>
+おごちゃん <ogochan@jh4tjw.prug.or.jp>
+播口さん <hariguti@lsidiv.kawasaki-steel.co.jp>
+進藤秀郎さん <shu@pegasus.rim.or.jp>
+おざさ＠東北大認知心理情報さん <ozasa@rubin.cpsy.is.tohoku.ac.jp>
+

抜けている人がいれば、ごめんなさい。

+ +

+前のページ +次のページ +目次 + + diff --git a/www/workshop/sgml-jguide/jguide.html b/www/workshop/sgml-jguide/jguide.html new file mode 100644 index 0000000..6564438 --- /dev/null +++ b/www/workshop/sgml-jguide/jguide.html @@ -0,0 +1,95 @@ + + + + + +日本語版 Linuxdoc-SGML ガイド + + +前のページ +次のページ +目次 +

日本語版 Linuxdoc-SGML ガイド

+ +

さとけん＠ＦｏｒＵｓ,`ken@gamba.forus.or.jp`
+ 小野＠京大環境地球,`ono@jf.gee.kyoto-u.ac.jp` (v1.4から)

v1.5.1, 18 March 1996 +

この文書は、SGML 形式で書かれたソースファイルからプレーンテキストや +DVI、HTML など様々な形式の文書ファイルへの整形を行なう日本語版 +Linuxdoc-SGML 文書処理システムを利用するためのガイドです。原版の +Linuxdoc-SGML に付属するガイドをもとに、日本語版 Linuxdoc-SGML v1.5 +に対応するよう書き下ろしたものです。

日本語版 Linuxdoc-SGML に関するＱ＆Ａ

小野＠京大環境地球, ono@jf.gee.kyoto-u.ac.jp

ポストスクリプトファイルの作成

DVI ファイルの作成

プレーンテキストファイルの作成

HTML ファイルの作成

man ページの作成

GNU info ファイルへの変換

LyX 形式ファイルへの変換

RTF 形式ファイルへの変換

SGML 構文チェックを行うには

SGML ファイルの最初

使用する文字

特殊文字

コード環境

スクリーン環境

クオート環境

itemize リスト

enum リスト

descrip リスト

初期化ファイル

日本語版 Linuxdoc-SGML ガイド

さとけん＠ＦｏｒＵｓ,ken@gamba.forus.or.jp + 小野＠京大環境地球,ono@jf.gee.kyoto-u.ac.jp (v1.4から)

小野＠京大環境地球, `ono@jf.gee.kyoto-u.ac.jp`

さとけん＠ＦｏｒＵｓ,`ken@gamba.forus.or.jp`
+ 小野＠京大環境地球,`ono@jf.gee.kyoto-u.ac.jp` (v1.4から)