問題タブ [docbook-xsl]

背景: 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 から切り出されたものですか?

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 でドキュメントを書いていて、ドキュメントに次のような写真がいくつかあります。

おかしなことは何もありませんが、ご覧のとおり、画像のタイトルには参照があります。そして私の問題は、参照のリストに現在の画像のタイトルだけでなく、次のように引用全体が含まれていることです。

<book lang='sk'>言語はご覧のとおりスロバキア語 ( ) です。赤い領域を表示したくありません-引用なしで画像のタイトルのみ。

事前に感謝します。

私は 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 から失われます。

This FAQ section describes how to set the "section depth"/"TOC level"/toclevel shown in the table of contents. However, I've no idea how to implement this in my simple:

command. Does anyone?

ドキュメント用にチャンクされた HTML と PDF に変換している asciidoc ソースがあります。ドキュメントには、次のような外部リンクが含まれています。

アスキードックソース:

Asciidoc は、次の XML 表現を正しく生成しています。

xsltproc は、次のようにこの XML を .fo に変換しています。

PDF では次のようにレンダリングされます。

Link Text [ https://some-url-here.tld ]

それよりも：

Link Text

これはhttps://some-url-here.tldへのリンクです

docbook 1.7.0 xsl スタイルシートで Asciidoc 8.6.9 を使用しています。