1

私は最近DITAに出くわし、それが社内のドキュメントのニーズに適用できるかどうかを評価するためにDITAをいじくり回しています。ドキュメントを適切に構成する方法を理解(および学習)しようとしています。私の初期設定は次のようなものです。

MainMap.ditamap:

<map>
  <mapref href="submap-1.ditamap"/>
</map>

SubMap-1.ditamap:

<map>
  <topichead navtitle="Topic Title 1">
    <topicref href="topic1.dita"/>
    <topicref href="topic2.dita"/>
  </topichead>
</map>

これをHTMLに変換すると、次のhtmlのリストが表示されます。

  • toc.html
  • mainmap.html
  • topic1.html
  • topic2.html

toc.htmlは次のようになります。

目次

  • トピックタイトル1
    • トピック1
    • トピック2

ですから、ここで私が理解していないことの1つは、「トピックタイトル1」もリンクであり、タイトルだけが含まれているmainmap.htmlにリンクされているため、まったく役に立たないということです。「トピックタイトル1」はリンクではないか、リンクされている場合は、サブマップの目次が記載されたページにリンクすることを期待します(または必要です:))。

  • サブマップの目次は可能ですか?
  • トピックのタイトルがより役立つように、サブマップを別の方法で構成する必要がありますか?topicheadを使用する代わりに、要約コンテンツと目次のようなリストを含むtopictitle.ditaへのtopicrefを使用しますか?
    • そのリストを維持するのは少し面倒です。これを自動的に行う方法はありますか?
  • メインマップをマルチHTMLページとして変換しますが、サブマップをシングルHTMLページとして変換しますか?それは可能ですか?

ところで、私は評価版XMLMind XMLEditor-ProfessionalEditionを試しています。より良い機能性/使いやすさ/手頃な価格の観点からのエディターでの提案も歓迎します。:)

助けてくれてありがとう!

4

2 に答える 2

1

サブマップの TOC を生成できますが、それはプロセッサ次第です。XMLMind XML エディターは、XMLmind DITA コンバーターを使用して DITA を処理します。

意味的には、要素はタイトルで新しい階層レベルを生成するだけです。XMLMind DITA Converter は、これをタイトルのみのトピックであるかのように処理するようです。たとえば、DITA Open Toolkit (DITA-OT) は、自動生成された「概要」トピックではなく、TOC のタイトルのみを生成します。

繰り返しになりますが、DITA-OT の場合、代わりに概要トピックを使用すると、ネストされたトピックへの子リンクが自動的に生成されるため、手動で維持する必要はありません。これが XMLMind DITA Converter にも当てはまるかどうかを確認してください。

に関して。DITA のエディター、私の個人的な好みはoXygen XML Editorです。開発者だけでなく、テクニカル ライターも使用できます。活発に開発が行われており、非常に手頃な価格です。

于 2011-06-24T07:31:37.553 に答える
0

submap-1のコンテンツをHTMLファイルとして表示するには、それをditamapからトピックに変換します。

于 2012-08-26T07:05:18.990 に答える