LDP Author Guide

Mark F. Komarinski

VA Linux Systems

markk@linuxdoc.org

Jorge Godoy

Conectiva S.A.
Publishing Department

godoy@conectiva.com

godoy@metalab.unc.edu

David C. Merrill

dcmerrill@mindspring.com

LDP 文書の作成者が快適に文書を作成するためのツールや手順、 およびヒントを、リストアップしました。


Table of Contents
1. この文書について
1.1. この文書の目的と射程
1.2. LDP について
1.3. フィードバック
1.4. 著作権と商標
1.5. 謝辞
1.6. この文書の表記法
2. LDP と SGML の紹介
2.1. LDP
2.2. SGML
2.3. なぜ HTML でなく、SGML なのか?
2.4. SGML は XML じゃない
2.5. 初めて寄稿する方へ
2.6. メーリングリスト
3. 文書作成ツール
3.1. DSSSL
3.2. DocBook DTD (version 4.1 か 3.1)
3.3. Jade
3.4. Jade wrappers
3.5. 編集ツール
3.6. CVS
3.7. その他のツールとリファレンス
4. DocBook タグの使い方
4.1. はじめに
4.2. 必要な設定
4.3. カタログの作成と修正
4.4. DocBook エレメントの使い方
4.5. 索引をつくる
4.6. 画像の挿入
4.7. 表組
4.8. プログラムコードとコメント
4.9. 翻訳者やコード変換者の氏名を表示する
4.10. ツールとヒント
4.11. 文書のサンプル
5. LDP スタイル・ガイド
5.1. 主題を決める
5.2. アウトラインを作成する
5.3. 文章を書く
5.4. テキストの推敲と校正
5.5. 作成した HOWTO の管理
5.6. リファレンス
6. スタイル関連事項の補足
6.1. 日付の書き方
6.2. 画像フォーマット
6.3. DocBook のバージョン
6.4. 利用禁止のタグ
6.5. タグの最小化
6.6. 文書内での表記法
7. DocBook のテクニックとコツ
7.1. 画像の挿入
7.2. HTML 出力ファイルのファイル名を指定する
7.3. ldp.dsl を使う
8. 文書の公開について
8.1. 文書公開のまえに
8.2. 著作権とライセンスの問題
8.3. LDP への寄稿
8.4. 作成した文書の管理
9. LDP についての FAQ
用語集
Index
List of Tables
4-1. 便利なコマンド
4-2. 表の例
List of Figures
3-1. sgedit のスクリーンショット
3-2. nedit のスクリーンショット
3-3. nedit へのシェルコマンドの追加
3-4. エラーがない場合の nsgml の出力
List of Examples
4-1. カタログの例
4-2. 索引生成のためのコード
4-3. 属性 zone の使い方
4-4. 属性 class で、値 startofrange endofrange を使う方法
4-5. 画像の挿入
4-6. <imageobject>の使い方
4-7. 表の挿入
4-8. compiles-sgml スクリプト
4-9. article で、自動的に要旨を挿入するための stylesheet の設定
4-10. 索引を付けるために外部エンティティを設定する
4-11. パラメータ・エンティティを使う