問題タブ [docbook]
For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.
docbook - DocBook 内の他のドキュメントのタイトルへのリンク
DocBook を使用していくつかのドキュメントをまとめています。それらのほとんどすべてが何らかの方法で相互に参照するため、参考文献のセクションをまとめました ( を使用<bibliography)。<olink>を使用して、他のドキュメントのタイトルを自動的に取り込む方法はありますか?
xml - ENTITY 宣言は、参照される XML ファイルでネストできますか?
私はかなり大きな DocBook XML ドキュメントに取り組んでいます。本書には章がありますが、エンティティを使用した参照によりすべてのサブセクションが含まれています。このようなもの:
main.book.xml:
セクション 3 はさらに 3 つの xml ファイルに分割されており、その内容は次のように参照によって含まれています。
section3.xml:
質問: セクション 3 でのみ使用される ENTITY 宣言 (つまり、section3_a、section3_b など) をsection3.xmlで宣言する代わりに移動する方法はありmain.book.xmlますか?
docbook - Docbook Dblatex - 章の最初のページのヘッダーを省略するには?
Docbook を使用してフォーマットされた本を PDF に変換するために dblatex を使用しています。もちろん、そのページを全体のページ数として「カウント」したいのですが、本のタイトルやページ番号を最初のページに表示したくありません。
何か案は?
ありがとうございました!ジェイソン
phpdoc - phpdoc を既存の docbook と組み合わせる
phpdoc で生成されたドキュメントを、既存の docbook ドキュメントに含めたいと考えています。
私のアイデアは、phpdoc に docbook 形式でドキュメントを生成させ、XInclude を使用してその一部 (パッケージとサブパッケージに基づく) をインポートさせることでした。ドキュメントに Docbook 5 を使用しています。これを達成する方法はありますか?
XML:DocBook/peardoc2:defaultこれまで試したことは、phpdoc パラメータとして使用して docbook を生成することです。
PHPDocumentor の docbook はいくつかのファイルに分割されています。
私が理解している限り、これらは外部エンティティですが、DTD で参照する必要があります。phpdoc によって生成された DTD がなく、すべてのクラスとメソッドにファイルを含めたくないため、私の努力には役に立ちません。手で。
xml - docbook、fo、pdf 出力で強調されたテキスト
PDF のフッターにレンダリングする静的テキストの文字を強調しようとしていますが、xsl のタグの適切な組み合わせがわかりません。どうすればこれを達成できますか?
例:
この例では、xsltproc でエラーが生成されます。ヘルプ!
docbook - 'e-novative DocBook Environment(eDE)'インストールファイルが必要
「e-novativeDocBookEnvironment」は、e-novativeGmbHという会社によってWin32プラットフォーム用に特別に構築された非常にシンプルなDocBookツールチェーンです。その会社は廃業したようだ。彼らのウェブサイト[ http://www.e-novative.de]は死んでいて、どうやら彼らのDocBook環境のインストールファイルはどういうわけかインターネットの表面から消えてしまったようです。
私は検索して検索しました[そしてさらに検索しました]そして私が出くわしたすべてのダウンロードリンクは最終的に会社の死んだウェブサイトを指し示しています。ソフトウェアのコピーが他にないなんて信じられません。
誰かが私にインストールファイルを提供するか、それらがある場所を私に指摘することができれば、私は永遠に感謝するでしょう。私が最初に生まれた子供を支払いで提供するほどです。さて、それは真実ではありませんが、私は非常に感謝しています!
よろしくお願いします!
python - カスタムプリティプリンターを実装する最良の方法
カスタマイズpprint.PrettyPrinter
pprintモジュールのドキュメントには、このメソッドPrettyPrinter.formatが書式設定のカスタマイズを可能にすることを目的としていることが記載されています。
サブクラスでこのメソッドをオーバーライドすることは可能だと思いますが、基本クラスのメソッドに行の折り返しとインデントを適用させる方法は提供されていないようです。
- ここで何か不足していますか?
- これを行うためのより良い方法はありますか (別のモジュールなど)?
代替案?
モジュールをチェックアウトしましたがpretty、これは興味深いようですが、それらのモジュールを変更せずに他のモジュールからクラスのフォーマットをカスタマイズする方法を提供していないようです。
私が探しているのは、ノードを処理するルーチンへの型を識別する型 (または関数) のマッピングを提供できるようにするものだと思います。ノードを処理するルーチンは、ノードを受け取り、その文字列表現を子ノードのリストとともに返します。等々。
私がプリティプリンティングを検討している理由
私の最終的な目標は、DocBook 形式の のカスタム形式のセクションをコンパクトに印刷することですxml.etree.ElementTree。
(DocBook の Python サポートがこれ以上見つからないことに驚きました。何か見落としていたのかもしれません。)
lxmlを使用するxmlearnというクライアントにいくつかの基本機能を組み込みました。たとえば、Docbook ファイルをダンプするには、次のようにします。
かなり中途半端ですが、探していた情報が得られました。
xmlearnには、グラフ イメージを作成したり、XML ドキュメント内のタグ間の関係を示すダンプを作成したりする機能など、他の機能もあります。これらは、この質問とはまったく関係ありません。
任意の深さまでダンプを実行したり、開始点のセットとして XPath を指定したりすることもできます。XPath のようなものは、docbook 固有のフォーマットを時代遅れにしたため、あまり開発されていません。
これはまだ質問に対する答えではありません。すぐにカスタマイズできるきれいなプリンターがどこかにあることを私はまだ望んでいます.
python - 相対パスを持つ他のスタイルシートを含むリモート スタイルシートを使用する
を使用して DocBook ドキュメントで XSL 変換を実行したいと考えていますlxml.etree.XSLT。
ドキュメントにetree.XSLT()は の最初のパラメーターを取ると記載されていますがxslt_input、このパラメーターの意味に関するドキュメントが見つからないようです。読み取り用に開いているファイルを渡すとうまくいくようです。ファイル名を文字列で渡すことはできません。
編集etree.XSLTサニティチェックの後、 parsed が必要であることに気付きましたetree._ElementTree。そう 。. . 相対パスのマッピングに使用するパスを与える方法で要素ツリーを解析する方法があるかもしれませんか? . . . 調査中。
渡された XML ファイルに他のファイルが含まれている場合、それらの include ステートメントの相対パスは、現在の作業ディレクトリから取得されます。
このクラスを使用して DocBook ドキュメントを変換したいと考えており、DocBook XSL にリモートでアクセスできるようにしたいと考えています。Docbook XSL は非常に複雑で、他にも多数のファイルが含まれています。etree.XSLTこれらのファイルをリモートの場所から取得する方法はありますか?
python - Docbook 要素ツリーのブランチの XSL 変換を行う
docbook XSL スタイルシートを使用して、ドキュメント全体を変換することなく、ドキュメントのさまざまな部分をレンダリングしたいと考えています。
複雑なのは、これらのパーツの一部に、属性が同じチャンク内にない<footnoteref>要素があることです。linkend言い換えれば、 s を含むが、それらが参照する要素を含ま<footnoteref>ないツリーのブランチを処理したいということです。<footnote>
lxmlPythonパッケージを使用してこれを実行しようとすると、次のエラー メッセージが表示されます。
これは、たとえば に応答して発生しetree.XSLT(etree.parse('docbook.xsl'))(some_element)ます。
通常のxhtmlスタイルシートを使用しています。ただし、使用しているスタイルシートが問題になるとは思いません。
これを行うためのサポートされている方法はありますか? または、たとえば、このレンダリングを行う前に、ドキュメントに XSLT 変換を適用して<footnoteref>要素を要素に変更する必要がありますか? しかし、同じ ID を持つ複数のタグ<footnote>が存在するため、それは機能しません。タグが結果のツリーに含まれていない場合<footnote>にのみ<footnoteref>、<footnote>変換する必要があります。<footnote>すでに起こっていると私が期待すること。しかし、うまくいけば、どこかでスイッチを逃しただけです。
編集
@Jukkaの回答のおかげで、rootidパラメータを渡して XSLT プロセッサにその ID をレンダリングするように指示できることがわかりました。ただし、これは非常に忠実に行われ、ドキュメントが単一の HTML ページとしてレンダリングされている場合に役立つ同じフラグメントで脚注を参照するだけの出力を生成します。例えば
脚注を同じページに表示させる別のパラメータがあり、できれば 1 から番号が付けられているのではないでしょうか? おそらくこのリストのどこかにあると思います。もう少し時間ができたら行ってみます。
documentation - さまざまな対象読者向けのDocbookパブリッシング
複数の対象読者向けのコンテンツを含む1つのdocbookxmlドキュメントが必要です。「上級」ユーザーにのみ必要なものを除外できるフィルターはありますか?
level属性は、私が考えていることを表現するために私が考案したものです。