問題タブ [docbook-5]

Maven docbkx プラグインを使用して PDF を生成しています。

図には、章、セクションなどを無視して、通常どおり 1 から順番に番号を付けてください。

sectionLabelIncludesComponentLabelの構成パラメーターを使用してセクションの階層番号付けをオンにしたため、これは機能しませんpom.xml。現在、第 2 章の最初のセクションは 1 (デフォルト) ではなく、2.1 です。

しかし副作用として、章 2.1 の最初の図も番号 2.1 を取得し、次の図は 2.2 を取得するため、章番号はセクションだけでなく図にも追加されます (これはまったく意味がありません)。

階層的なセクション番号を付けながら、同時に単純な連続した図の番号付けを行うにはどうすればよいですか?

[編集]

sectionLabelIncludesComponentLabel関係ないようです。オフにしても、図のタイトルには章番号が付きます。

Ant スクリプトから WebHelp を生成すると、part 要素の toc がボックスでブロックされます。このボックスは、左ペインの toc と接続されているように見えます。目次ペインのサイズを変更すると、メイン ウィンドウのボックスのサイズも変更されます。誰でもこれを経験し、修正方法を知っています。サンプルの build.xml とプロパティ ファイルを docbook webhelp フォルダーに使用し、特別なカスタマイズは行いません。

インライン要素の前景色と背景色の両方を変更しようとしています。ドキュメントブックのスニペットは次のとおりです。

私のカスタマイズ レイヤーの XSL 部分は次のとおりです。

これは、どちらのテンプレートが最後かによって、背景色または前景色のみを変更します。

ロール値が の場合、フォアグラウンドとバックグラウンドの両方を適用するにはどうすればよいf00 b01ですか? contains " f00 b01 "注: 選択できる色が 256 あり、すべての組み合わせを指定すると、テンプレートの数が爆発的に増えるため、3 番目のテストを行うオプションはありません。

注：実際のファイルの内容により厳密に一致するように編集されました

xterm カラーから RGB カラーへのマッピングは次のとおりです。color 16 からは、小さな perl スクリプトで計算できます (xterm ディストリビューションから抜粋したスニペット):

結果：

背景: HTML を生成するつもりで、DocBook 5 文書 (および既に作成されたテキストを含む) を作成しています。セマンティック マークアップを最初から正しくして、後でやり直す必要がないようにしたいのですが、標準的な方法では探しているものが生成されないようで、どうすればよいかわかりません。それから逸脱するかどうかは、XSL で何が可能かによって決まります。

現在の設定: 私の用語集には省略された項目しかありません。これは、フルスペルの s とゼロ以外の数のs および/またはsglossentryを含む sで構成されます。代わりにすべてがs になる可能性があると思います。私には関係ありません。たとえば、私がこれを持っているとします：glosstermacronymabbrevglossterm

理想

Firefox を参照したい場合は、どこにでもFFテキストを入力するとします。理想的には、追加のマークアップなしで、「FF」(大文字と小文字を区別) がparaグラフ内のプレーンな単語全体として表示される場合 (またはtitle、たとえば属性内の URL 内ではなく、codeまたはprogramlisting...)、DocBook ファイルで、 HTML ではテキスト "FF" として出力されますが、用語集エントリへのリンクとしてマークアップされますが、標準のリンク CSS ではなく、さらにtitle値を持つ属性が含まれます。Firefox. そうすれば、読者はホバリングして頭字語/略語を読み上げることができます。それが不十分な場合は、クリックしてより完全な定義に進むことができます。その間、私はそれを黒く下線を引いてスタイリングし、この機能があることを彼らに知らせますが、通常のリンクのように注意をそらすことはありません。特に、テキスト内で頻繁に発生します。

主な質問: プレーンテキストのマークアップのない用語のそのような置換は XSL でも可能ですか (スカンソープ問題のようなものを作成せずに)? もしそうなら、用語集にあるすべてのacronymまたはabbrev見つかったものに対して自動的にこれを行うことができますか?

これを直接行う方法はわかりませんでしたが、それが私の目標です。その間、私は他のことを試しました：

アプローチ1

キーボード マクロを設定して、ff入力中に変換できるようにし<xref linkend="ff"/>ます。

長所：

1. 用語集へのリンク
2. 略語を綴る

短所：

1. 略語を綴ります (入力するだけでなく、読むのに短くするのが良いでしょう)...回避策:acronymを aglosstermにして、最初に入れますglossentry(セマンティクスの損失ですが、おそらくそれで問題ありませんか?)
2. 用語集へのリンク (別のスタイルにしたい)...解決策: CSS fora.xref
3. FFFirefox上記の2つを回避しても、タイトルはただの代わりに出てFirefoxきます（そして、複数の同義語を持つ他のものでは、一緒にマッシュアップが続きます）...解決策xml:id：好みの頭字語/略語に代替を置き、次にその中のリンクがそのendterm属性のそのIDを参照するようにします（linkend最初のIDを参照するだけでなく）
4. 入力してシス​​テムに任せるのではなく、キーボード マクロを使用することを忘れないでください。インポートされたテキストは、用語集のエントリごとにテキスト置換を行う必要があります。

アプローチ 2

とキーボード マクロを使用<xsl:param name="glossterm.auto.link" select="1"/>して に変更FFし<glossterm>FF</glossterm>ます。

長所：

1. 用語集へのリンク

短所：

1. 略語を綴ります (入力するだけでなく、読むのに短くするのが良いでしょう)...回避策:acronymを aglosstermにして、最初に入れますglossentry(セマンティクスの損失ですが、おそらくそれで問題ありませんか?)
2. 用語集へのリンク (別のスタイルにしたい)...解決策: CSS for.glossterm
3. 上記の2つを回避しても、title属性は指定されません
4. 入力してシス​​テムに任せるのではなく、キーボード マクロを使用することを忘れないでください。インポートされたテキストは、用語集のエントリごとにテキスト置換を行う必要があります。

これまでのアプローチ 1 は、回避策の後の方が優れているように見えますが、私が概説した理想を達成する方法はありますか?

xsltproc←DocBook 5 エンティティ リストのいずれにも見られない単純な左矢印 ( 、つまり ←) を使用しようとすると、「エンティティ 'larr' が定義されていません'」というエラーが表示されます。動作させるには何を含める必要がありますか?

私の現在のXSLは次のとおりです。

...そして、docbook ファイルは単に以下で始まります:

...その後、titleandchapterタグに直行します。

"larr" エンティティを取得するには、何か他のものにリンクする必要がありますか? それとも単に DocBook 5 から切り出されたものですか?

(この質問の試行 1 の Con 3 の回避策を探しています。)

glossentry一部のタグに複数のタグが含まれている DocBook 5 ドキュメントがありglosstermます。

a のと等しい属性xrefを持つタグの HTML 出力は、 (リンク テキストが最初で、リンクは を正しく指しています) マウスオーバー テキスト ( HTML の属性内) がすべてのテキストを連結することを除いて、適切に見えます。linkendxml:idglossentryglosstermglossentrytitleglossterm

むしろ、最初のものだけを出力したいと思います（または、同義語であることを示すためにs をorまたは何かでglossterm区切ってください）。glossterm/a.k.a

どうすればそれについて行くでしょうか？DocBook と XSLT は初めてです。

私の DocBook 5 文書にはglossentry、タグを含むabbrevタグが含まれています。abbrevタグは、レンダリングされた HTML に何の貢献もしていないようです。DocBook と XSLT は初めてです。これを変更するには、どこから探す必要がありますか? 私はドキュメントを調べてきましたが、これが明らかにデフォルトの動作であることに驚いたことは別として、トラブルシューティングのために次にどこを見ればよいかわかりません.

セットアップ:私の DocBook ファイルは単純に<book xmlns:xl="http://www.w3.org/1999/xlink">. xsltproc私は、まさにこれを含む単一の XSL ファイルのみを指しています。

DocBook のドキュメントを読んでいますが、その方法がよくわかりません。

この Web サイトが表示されている場合は、必要なものだけが含まれています。ツリービューと検索インデックスです。このツールの同じドキュメント、DocBook の webdocs を使用しています。

http://docbook.sourceforge.net/release/xsl/current/webhelp/docs/ch01.html

次のようなjson文字列があります。

そして、私が提供したリンクに示されているのと同じ方法で、それを DocBook に変換する必要があります。ただし、チュートリアルとドキュメントのページを読むたびに、必要なもの、使用するプログラム、製品がすべて変更されます。だから私はかなり混乱しています。

どのプログラムを使用すればよいかsudo apt-get install、また、上記のデータからの本が DocBook の形式でどのように表示されるかについて、簡単な例を示してください (本の一例にすぎません)。

DocBook は html、multiple-html、および chm に変換できると聞いたことがあります。単一のhtmlが必要です。

私は DocBook V5.0 ドキュメントを持っていますが、以前は 1 つの.docbookファイルに本全体が含まれていました。その時点で、生成された TOC は正常に見えました。ここで、入力を 4 つの異なる.docbookファイルにチャンクし、チャンクされた出力も必要です。

この変更の後、突然 2 つの問題が発生しました。

1. TOCには、以前の完全な深さではなく、4 つのエントリ (.docbook ごとに 1 つ) しか含まれていません。
2. 奇妙なことに、TOC の章番号は1、2、および 4 で、次に番号のない用語集です。

後者については、第2章を外すと1、2、用語集になるので、第2章の内容が原因で番号がずれているわけではないと思います。

とにかく、私の質問は、チャンク化された入力と出力を保持しながら、通常の外観の TOC を復元するにはどうすればよいかということです。(チャンキングは単一ファイルの深さに制限することもできます。つまり、1 つのファイルを入れて 1 つのファイルを出すこともできますが、TOC の深さをもっと高くしたいのです。)

私がしたこと

メインファイルを次のようにしました。

私の XSL は以前と似ていますが、いくつかのチャンク制御オプションが追加されています (ただし、元の TOC オプションには変更はありません)。

私の.docbookファイルはすべて次のようになります。

あ...

次の場合を除きglossary.docます。

用語集

今、章の中に章があるのは少し奇妙かもしれないことに気づきました。これが原因である場合もあります。ただし、警告なしで検証されます。また、代わりに特定のファイルで最も外側のタグを作成すると、<section>ファイル全体が TOC から失われます。