docbook-2-pdf - クラウドでオンライン

プログラム：

NAME

sgml2x —DSSSLスタイルシートを使用してSGML / XMLドキュメントを簡単にフォーマットします

SYNOPSIS

sgml2x [オプション] [sgmlファイル | xmlファイル ]

ドキュメントクラス-2-ターゲットフォーマット [オプション] [sgmlファイル | xmlファイル ]

説明

sgml2x DSSSLスタイルシートを使用してSGMLまたはXMLドキュメントを簡単にフォーマットできます。
次の機能を提供します。

・ドキュメントクラスごとに複数の可能なスタイルシート

・パラメータのサポートにより、エイリアスを使用したスタイルシートの簡単な指定
継承

・単純な新しい定義ファイルをに追加することにより、新しいスタイルシートを簡単に統合できます。
構成ディレクトリ

・呼び出し元は、PATHのような構成ディレクトリのリストを指定できます。デフォルトは次のとおりです。
システム全体、ユーザーごと、およびプロジェクトごとの構成ディレクトリ

・割り当てられたものに基づいて、使用されるデフォルトのスタイルシートの自動選択
優先順位

・任意のオプションをに渡す ヒスイ(1)

今のところ、スタイルシートの検索に使用されるドキュメントクラスと出力形式は次のとおりです。
プログラムが呼び出される名前からのみ派生しているため、これを呼び出す必要があります
次のようなシンボリックリンクを介してプログラムする docbook-2-pdf.

sgml2x はシェルラッパーとして実装されています ヒスイ(1) （または、できれば、 オープンジェイド(1),
総称を使用しますが ヒスイ このドキュメント全体）、 ジャデテックス(1) およびその他の
ツール。

ない場合 ジェイデテックス.cfg ドキュメントの近くのファイル、デフォルトのものがコピーされ、それが可能になります
PDFブックマークの作成。

オプション

-c|- カタログ カタログ
システムデフォルトの代わりに、指定されたSGMLカタログを使用します。

-C|--confdirs ディレクトリリスト
構成ディレクトリの（空白で区切られた）リストを使用します。 このオプションは
累積、つまり複数を使用できます -C オプションとリストは
連結。

リスト要素は、最も一般的な構成（システム全体など）から並べ替える必要があります
最も具体的なもの（プロジェクト全体など）。

このオプションでディレクトリが提供されている場合、デフォルトのディレクトリリストは次のようになります。
無視されます。

-D|--dssslproc dsssl-プロセッサ
　 dsssl-プロセッサ デフォルトのスタイルシートの代わりにスタイルシートを適用します。 この
プロセッサはサポートする必要があります ヒスイ-のようなオプション -V.

このオプションが存在しない場合、最初に dsslproc confdirsからのファイルは
取られた。 見る 「ファイル」 のガイドをご参照ください。

-h| - 助けて ヘルプメッセージを表示して終了します。

-j|-翡翠 dsssl-プロセッサ
の廃止された同義語 --dssslproc.

--jadetexfilter perl フィルター
perlフィルターを使用してjadetex出力を後処理します。

これは、スタイルシートを克服するために特定の場所でページブレークを強制するのに役立ちます
問題、またはTeXに十分なパターンがない場合にハイフネーションを強制する、または
あなたが考えるだろう他の巧妙な変換。

ジョブの設定方法については、 例/コマンドライン 可能な使用のためのファイル。

-n|-- ノーアクト
コマンドを実行する代わりに印刷します。 下位レベルについて学ぶのに役立ちます
ツール、およびコマンドラインのデバッグ用。

-o|--openjade
この オプション is 廃止された. オープンジェイド 利用可能な場合はデフォルトになりました。 つかいます
--dssslproc または dsslproc 特定のプロセッサを強制するための構成ファイル。

このオプションは以前使用されていました オープンジェイド(1) 代わりにDSSSLプロセッサとして ヒスイ(1).

-O|--jadeopts 翡翠-オプション
渡す追加のオプション ヒスイ(1)。 このオプションは累積的です。
それらのいくつかを指定すると、提供されたオプションが連結されます。

-q|- 静かな
冗長性をに設定します 静かな

-r|- 備考
ドキュメント内のドキュメントコメントの内容をレンダリングします（発言 の要素
DocBook 4、 コメント DocBookの要素3）、生成された出力を
内部でのみ使用 ドキュメント、表紙に太字の警告を印刷します。

これはdocclassおよびスタイルシート固有の機能であり、すべてのスタイルシートが使用するわけではありません


-s|- スタイル
（最終的にはドキュメントから派生した）デフォルトをオーバーライドする出力スタイルを選択します。

特定のドキュメントクラスおよび各出力形式で現在使用可能なスタイルは次のとおりです。
構成ディレクトリの内容に応じて、
- 助けて オプションを選択します。

ビルド手順でこのオプションを指定することをお勧めします。
利用可能なスタイルシートに関係なく、再現可能な結果。

-v|-詳細
冗長性を高めます。 このオプションは複数回指定できます。

-冗長性 N
冗長性をに設定します N。 冗長性のレベルは次のように定義されます。

静かな 印刷エラーのみ

デフォルト エラーと警告のみを印刷する

詳細 通知も印刷

トレース また、実行時に重要なコマンドを出力します（ -- ノーアクト します）。

debug また、デバッグメッセージを出力します

-V|- バージョン
プログラムのバージョンを印刷して終了します。

　

sgml2x 構成ファイルの代わりに構成ディレクトリツリーを使用するため、
他のパッケージを簡単にプラグインでき、既存の設定を壊すリスクが低くなります。

スタイル階層は、という名前のディレクトリにあります スタイル 各構成で
ディレクトリ。 このプログラムの古いバージョンは、これらの階層を直接
構成ディレクトリ。

構成ディレクトリには、既知のドキュメントクラスごとにXNUMXつのディレクトリが含まれ、
ドキュメントクラスのニックネーム（例： ドックブック）。 これらのdocclassディレクトリにはXNUMXつのサブが含まれています
出力形式の各クラスのディレクトリ（現在、のみ HTML & 印刷 サポートされています）。

現在、実装の問題により、ドキュメントクラスのニックネームが制限されています。
およびスタイルシート：英数字とアンダースコア文字のみを含めることができます。 この
制限は将来のリリースで削除される可能性がありますが、これより前には発生しません
スクリプトは別の言語で書き直されます。

これらの各ディレクトリには、使用可能なスタイルごとにXNUMXつのファイルが含まれています。 これらのファイルの名前
英数字のみを含めることができ、スタイルのニックネームとして使用されます。 この
ファイルには、 キー： 値 パターン、現在次のキーがあります
サポート：

Id スタイルシートの公開識別子

DESC ヘルプメッセージに表示されるスタイルの簡単な説明

pdfオーバーライド, psオーバーライド,
rtfオーバーライド, mifオーバーライド"10設定する印刷スタイルシートのdsssl記号
〜へ #t （または シンボル=値 ペア、への引数として適しています ヒスイ's -V オプション）、
指定された印刷形式に使用されます。

オーバーライド行ごとにXNUMXつのシンボルのみが許可されます。 複数のシンボルの値を定義するには、次を使用します
数行。

継承 不必要なことを避けるために、これが継承するスタイルシートのニックネーム
スタイル定義の重複。

現在、これはの継承のみを引き起こします *オーバーライド パラメーター。

優先 デフォルトのスタイルを選択できない場合に役立つ正の整数
ドキュメントから派生。 値が高いほど、次のように解釈される可能性が高くなります。
ディフォルト。 のハイパースペシャライズドスタイルに低い優先度を使用するように注意してください
エラーによって使用されないようにするための汎用ドキュメントタイプ。

たとえば、DocBookスタイルシートの現在の推奨ポリシーは、
Norman Walshの説明は次のとおりです（経験上不十分であることが判明した場合は変更される可能性があります）。

10基本スタイルシート。通常はカスタマイズする必要があります。

0非常に特殊な目的で作成されたスタイルシート（例：
マーケティング製品シート）。

1000組織によって作成されたすべてのドキュメントのデフォルトスタイル。 通常、
レイアウト設定を特徴とする軽いカスタマイズ、組織の
ロゴ、またはそのようなもの。

10-100基本スタイルシートのその他の一般的なカスタマイズ。

優先してスタイルシートの改良版を書くとき n、あなた
通常、より高い優先度を選択します。

/ etc / sgml / sgml2x /

〜/ .sgml2x /

./sgml2x/ 構成ファイルが含まれるデフォルトの構成ディレクトリ
検索。 のドキュメントを参照してください --confdirs のガイドをご参照ください。

カンファレンス/スタイル/
使用可能なスタイルを定義する階層。 見る "構成" 詳細については、
詳細。

カンファレンス/ dssslproc
検索するdssslプロセッサの順序付きリストを含むファイル。
改行および/または空白。 で始まる行 # 文字はとして扱われます
コメント。 一般的な値は次のとおりです オープンジェイド & ヒスイ.

ここで指定されたDSSSLプロセッサは、 -V & -D 翡翠互換
コマンドラインオプション。

構成ディレクトリは、最も具体的なものから始めて検索されます
XNUMXつは、デフォルトのconfdirを使用して、プロジェクト設定がユーザーをオーバーライドできるようにするためです。
設定。これにより、システム設定が上書きされる場合があります。

特別な価値 false 検索を停止し、調査を防ぐために使用できます
より一般的なディレクトリ。 たとえば、プロジェクトで使用する必要がある場合
openjade-1.4devel コマンドと他の何も、それは指定することができます openjade-1.4devel false
その中で dsslproc ファイルにソフトウェアを指定する必要があります。

注意事項

使用時 openjade-1.4devel DSSSLプロセッサとして、トップについての苦情が表示されます-
レベルフロー-によって生成されたオブジェクト doctype.dsl、およびドキュメントの自動決定-
タイプは失敗します。 それ以外の場合、このエラーは無害です。 これに対処する方法のアイデア、または
その確認 openjade-1.4devel 厳しすぎるので、よろしくお願いします:)

　 未来

今後のリリースで予定されている機能は次のとおりです。

・インデックスジェネレータの統合

・コード例のためのきれいな印刷エンジンの統合

・連鎖する変換の仕様

・スタイルの任意のdocclassで使用できるようにするサブセットdocclassの宣言-
スーパーセットのdocclassに適用されるシート。

・作業ディレクトリを汚染しないように、一時的な場所で作業します。
一時ファイル。 これは、ドキュメントを壊すため、思ったほど簡単ではありません
相対パスを使用して画像ファイルを参照します。 それは翡翠のバグと見なされるかもしれません、
しかし。

TODOの全リストを閲覧して、さらにアイデアを送ってください。

著作権

Copyright©2001-2003Alcove＆YannDirson。

sgml2x GNU General PublicLicenseバージョン2の下でライセンスされています。

このドキュメントは、GNU Free DocumentationLicenseバージョン1の下でライセンスされています。

お問い合わせ us

sgml2x の一部です。 アルコーブブック プロジェクト （リンク 〜へ URL http://www.alcove-
labs.org/en/software/alcovebook/） 。 使用してください アルコーブブック 郵送 lists （リンク 〜へ URL
https://savannah.gnu.org/mail/?group_id=533) 開発者やユーザーと連絡を取るため。

バグと機能リクエストのリストが利用可能です 　 a ウエブサイト インタフェース （リンク 〜へ URL
https://savannah.gnu.org/support/?group_id=533) 。 問題を提出するためにそれを使用してください
アイデア。

見る また

オープンジェイド(1), ヒスイ(1), ジャデテックス(1), collat​​eindex.pl(1).

sgml2x(1)

onworks.net サービスを使用してオンラインで docbook-2-pdf を使用する