問題タブ [dita]
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.
xml - XSLT を使用した DITA (CALS) テーブルの分割 - 恒等変換
Framemaker のバグに基づく大きな問題があり、回避策を構築しようとしました。ドキュメントには、列ごとに分割する必要があるテーブルがたくさんあります。テーブルには、それらを識別することができる要素の属性が含まれています。だからここに私が必要なものがあります:
入力:
出力:
私がこれまでに試したことはすべてうまくいかなかったので、私はあきらめようとしています:(
xml - Web出力では目次のnavtitleを指定するが、pdf出力では指定しない方法は?
Web 出力の目次領域がかなり狭いことを考えると、Web 用の小さなナビゲーション タイトルを想定したいと思いますが、PDF 出力では長いトピック タイトルを表示し続けます。
audience
次のマークアップは (属性の有無にかかわらず) まったく機能しないようです。
マップに追加locktitle="yes"
しても、違いはないようです。
以下は Web で機能しますが、残念ながら PDF の目次にも短いタイトルが表示されます。
以下を使用して Web と PDF を個別にターゲットにしようとしましたが、変換プロセス中に処理コンテキスト外のトピックを参照しようとしているというエラーが発生しました。これは Web では問題なく機能しますが、PDF 出力を調べると、PDF ファイル内の相互参照ではなく、「file:/」プロトコルを使用した「.dita」ファイルへのリンクがあります。
注: XML MindのDitacプロセッサを使用しています。
xslt - XSL-FOを使用して生成されたPDFブックマークからUnicodeソフトハイフンを削除する方法
DITA OpenToolkit1.7とRenderXXEPを使用してDITAマップをPDFに変換しています。DITAトピックでは、製品名はconrefsを使用して挿入されます。私の製品名の1つはかなり長いです。テーブル内で使用すると、レイアウトの問題が発生しました。したがって、conrefを介して再利用されるフレーズにソフトハイフンを挿入しました。
これは生成されたページではうまく機能しますが、ソフトハイフンの代わりに記号が表示されるブックマークで問題が発生します。
明らかに、これはエンコーディングの問題です。UTF-8文字はPDFコンテンツでは適切に処理されているようですが、以下のソースによると、一部のPDF-16文字を使用できるPDFブックマークでは処理されていません(ただし、どれを使用できるかわかりませんでした)。
- http://partners.adobe.com/public/developer/en/pdf/PDFReference.pdf
- http://www.setasign.de/support/tips-and-tricks/use-unicode-in-string-values/
DITA Open Toolkitは、次のコードフラグメントを使用してトピックタイトルからブックマークを作成しているようです。
XSLスタイルシートにはバージョン2.0があります。
問題のある文字を削除するオーバーライドを作成したいと思います。これどうやってするの?
- エンコーディングの問題を適切に解決することは可能ですか?(おそらく不可能です)。
- スペース、タブ、改行、およびキャリッジリターン以外の空白を削除するXSL関数または属性はありますか?
- または、ソフトハイフンの特別な処理が必要ですか?
dita - DITAでのprodnameメタデータの使用?
DITAメタデータのprodinfo要素内のメタデータ要素の使用目的は何ですか?
各prodinfo(複数の場合もあります)にはprodnameが1つだけあり、内部にはコンポーネント、ブランド、シリーズなどを含めることができます。
prodinfo自体は、特定の製品への適用可能性を示すことを目的としているようです。複数の製品に適用可能であることを示すために、複数の製品を使用できます。
しかし、prodinfoの中には、コンポーネント、ブランド、シリーズなどがあります。これは、私には一般的なメタデータのように見えます。つまり、トピックがより広い範囲のトピックに適用可能であることを示すメタデータです。ただし、特定のprodinfo要素内にある場合は意味がありません。たとえば、コンポーネントを解釈して、トピックが製品の特定のコンポーネント、たとえばエンジンに関係していることを示す場合、それを使用して、いくつかの異なる製品で再利用できるトピックを見つけることができます。これらはすべて、エンジンコンポーネントを同様に説明しています。
例:
この場合、コンポーネントのメタデータは特定の製品にアタッチされていない必要があると思います。では、これらのパーツはDITAメタデータでどのように使用されるのでしょうか。
dita - DITA OTでのトピックの番号付けが簡単ですか?
DITA OTのPDF出力にトピックのセクション番号を追加するにはどうすればよいですか?私はこのような番号付けを意味します:
編集:私の質問は少し不明確でした、私は理解しています。私はトピックの番号付けを言うつもりでした(DITA要素としてのセクションよりも一般的な意味での意味のあるセクション)。また、コードでこれを行う方法は知っていますが、DITA OTでの単純な構成(スイッチのオンまたはオフの引数など)によってこれを行う簡単な方法を見逃したのではないかと考えていました。これは非常に一般的な要求であるため、このようなスタイルシートを常に変更するよりも簡単です。
xml - DITAのキーワードとデータのメタデータ?
DITAには、データ要素とキーワード要素の2つの「汎用」タイプのメタデータタグがあります。もちろん、othermetaもありますが、これは間もなく廃止される予定であり、その名前はとにかくその種の最後の手段を示唆しています。
そのため、キーワードはWebアプリケーションのタグ、つまり「フォークソノミー」に一般的に使用されているタグによく似ているようです。しかし、データとキーワードの正確な違いは何ですか?いつどちらを使用する必要がありますか?
dita - DITAsubjectSchemesの使用方法は?
DITAのsubjectSchemeは、メタデータの分類法を作成するのに適した形式ですが、実際にどのように使用する必要がありますか?具体的には、私の質問は次のことに関するものです。
- メタデータ要素を表すために使用できますか、それともメタデータ属性のみを表すために使用できますか?私の知る限り、要素は通常、検索メタデータに使用されます。つまり、フィルタリングに使用されるメタデータではないため、属性に適用されるのを見ただけです。
- 要素に使用できる場合でも、値はsubjectdefの「keys」属性に含まれている必要がありますか?
- メタデータ値に定義/説明を追加したい場合、どこでそれを行いますか?
- subjectSchemesを公開できますか/公開する必要がありますか?リソースのみのデフォルト属性のため、公開を目的としていないことが示唆されているのを見てきました。しかし、それは制限ではありませんか?これを使用して分類法を作成する場合、ユーザーの利益のためにそれを公開する簡単な方法も必要ですか?
dita - DITA変換をどのようにデバッグできますか?
XSLTは一般的にデバッグできることは知っていますが、モジュラーXSLT構造と、スタイルシートがcatalog.xmlファイルによってポイントされているという事実を考慮すると、DITA変換のデバッグをどの程度正確に行うでしょうか。
実行時にコードをステップ実行できるようにし、ブレークポイントなどを設定できるようにしたい。
dita - Mac OS で DITA OT を実行しますか?
DITA OT のドキュメントには、Windows 環境で DITA OT を実行する方法についてかなりの情報が含まれていますが、Mac OS での実行についてはほとんど説明されていません。Mac OS (Mountain Lion) で実行する手順は? 特に環境変数を設定する必要がある場合 (これは Mac OS ではややこしいことです)
xsl-fo - 見出しが番号付けに近い場合の目次フォーマットの問題
TOCタイトルがTOC番号に近すぎると、番号が内側に引っ張られるというシナリオに遭遇しました。
ここでは、一度に1つの文字を追加/削除し始めたいくつかの例を見て、番号が誤って内側に引っ張られるのか、次の行に正しく折り返されるのかを確認します。
これがtopic.foからの2つのブロックです。1つは、目次番号を取得していないこと、もう1つは番号を取得していることです。
運がなくても強制的にラップできるかどうかを確認するために、さまざまなエンドインデントを調整してみました。私はDITA-OT1.5.4とFOP1.0を使用しています。