問題タブ [dita]

私は、DITA を使用して一般的なビジネス プロセス標準を作成しているテクニカル ライターです。私が DITA を選択したのは、トピックの組み立て、コンテンツ参照、および条件付きプロファイリングが優れているためです。これらはすべて、複雑で相互に関連するドキュメントを管理するのに役立ちます。

使用するトピック タイプを選択する必要があります。

3 つのオプションがあります。

1. 自分の正確なニーズを満たす独自のトピック タイプを専門化できる
2. トピックトピックを使用できます。
3. OASIS コンピュータ ドキュメントのトピック (概念/タスク/リファレンス) の 1 つまたはすべてを使用できます。

オプション 1 は、DITA 開発者にアクセスできないため現実的ではありません。さらに、疑似コードであっても特殊化を設計することは簡単ではありません。

これにより、オプション 2 と 3 が現実的になります。

オプション 2 では、トピック トピックを使用しています。これは、最も寛容なトピック タイプであるため、柔軟性があります。また、他の目的のために設計されたトピック タイプを使用していないため、最も「クリーン」です。ただし、トピックトピックは実際には専門化のベースであり、直接使用することは想定されていません。

オプション 3 では、コンピューター ドキュメントのトピックを使用します。多かれ少なかれ、コンテンツを彼らに適合させることができます。ただし、実際には、特定の種類の方法で記述された「トリパン ヘルプ」タイプのコンテンツを対象としています。たとえば、これらのトピック タイプは、ジョン キャロルのミニマリズムに従って執筆する場合によく使用されます。このミニマリズムは、ユーザーの実験を奨励し、ユーザーのタスクに焦点を当てています。私の種類のドキュメントは要件を義務付けており、執筆においてミニマリストの原則を奨励したくありません。

オプション 2 と 3 の両方に妥協が伴います。プロセス標準を作成する場合、どちらが優れていますか?

問題:すべてのネストされた順序付けられていないリストを黒丸ではなくダッシュに切り替えたいです。

これらのネストされたリスト項目を選択する XPath 式は次のようになると思います: //ul/li/ul//li

これは変更するのに適切なテンプレートだと思います:

「Unordered List Bullet」という名前の en.xml の変数を参照しています。

ネストされている場合、その変数呼び出しをラップして、別の変数「Unordered List Dash」を参照しようとしました。私はまだ少しハングアップしています。最も優雅なアプローチは何ですか？代わりに、これらのネストされたアイテム用に追加のテンプレートを設定する必要がありますか?

DITA-OT 1.5.4 を使用しています。

TOC エントリの登録マークが、コンテンツに表示されるよりも少し高い位置にシンボルを生成する状況 (PDF) に気付きました。

これがスクリーンキャプです。上がTOCで、下の例のチャプターのタイトルと内容よりも登録マークがかなり上にあるのがわかります。

これは、DITA-OT 1.7.3 デフォルトの PDF2 プラグインを使用しています。

私はtopic.foに目を通しましたが、どちらも次を使用しています: <fo:inline line-height="100%" font-family="Helvetica, Arial Unicode MS" baseline-shift="20%" font-size="smaller">®</fo:inline>

しかし、それらはそれぞれ異なるラッパーを使用しています。

TOC は以下を使用します。 <fo:inline end-indent="14pt" keep-together.within-line="auto" line-height-shift-adjustment="disregard-shifts" font-family="Helvetica, Arial Unicode MS">

コンテンツは以下を使用します： <fo:inline baseline-shift="20%" font-size="75%" line-height-shift-adjustment="disregard-shifts">

TOC スタイルを少し調べましたが、どこを調整すればよいかわかりません。toc のニーズを推測しています:baseline-shift="20%" font-size="75%"

これは小さな問題ですが、一貫性を保つためにどこで調整を行うべきかについての洞察はありますか?

DITA1.2 の subjectcheme マップを自分の仕事に実装した人がいるかどうか知りたいですか? はいの場合は、例を分割して表示してください。

• どうやってするの？
• いつ使用しないのですか？

その背後にある理論は知っていますが、まだ実装していないため、計画と実装の段階で留意しなければならないことがあるかどうかを知りたいと思いました。

DITAを使用してプロジェクトを文書化する必要があり、 python の docstring 規則をreStructuredText使用して DITA の XML を作成できるかどうか疑問に思っています。

ポインタはありますか？

DITA-OT: 1.7.3

問題: カスタム スタイルシートの空の章でエラーが発生します。

"fo:block-container" is missing child elements. Required content model: marker* (%block;)+

デフォルトの PDF2 スタイルは正常にレンダリングされます。

章にトピックを追加すると、トピックがなくなります。このエラーは、列が 0 の topic.fo の最後の行番号のみを表示します。

これがページ シーケンスです (インデントされています)。エラーが発生している行は id="d2e394" の直前から始まります。

これは、デフォルトの PDF2 スタイルを使用した同等のものです。

私のスタイルは根本的に異なるため、この問題のトラブルシューティングをどこから始めるべきかを特定するのに苦労しています。任意のガイダンスをいただければ幸いです。

DITA または XSL の初心者。API ドキュメントのドキュメントを作成するという課題に直面しています。現在、C# アセンブリと XML で Sandcastle を使用して、HTML と CHM のヘルプを作成できます。DITAで作成する必要があります。手がかりはありますか？

ありがとう