How to Reuse Structured Content With DITA DITA で構造化されたコンテンツを再利用する方法

How to Reuse Structured Content With DITA
DITA で構造化されたコンテンツを再利用する方法

by Gosia Radymiak | Oct 24, 2017 | Reuse
ゴウシャ レイデイミアック著| ２０１７年１０月２４日、 | 再利用

Content reuse is one of the main reasons why organizations move away from unstructured writing and introduce the Darwin Information Typing Architecture (DITA) standard. It’s a promise of freeing authors from the mundane and error-prone task of copy-pasting or from mastering the find & replace mechanism. For many, reusing content in a structured and controlled way is a dream come true.
コンテンツ再利用は、組織がなぜ非構造的著作から遠ざかって、ダーウィン情報タイピングアーキテクチャ（DITA）標準を導入するかについての主な理由の１つです。 それはコピー ペイストする世俗的な、そしてエラーが起こりがちな仕事からあるいは発見＆入れ替えメカニズムをマスターすることから著者を解放する保証です。 多くにとって、構造化された、制御された方法でコンテンツを再利用することは夢の実現です。
Whether you’re considering DITA or you have already adopted it, we hope this summary is a helpful overview of the most common DITA reuse mechanisms:
あなたが DITA を考慮中か、あなたがすでにそれを採用しているかにかかわらず、我々はこの要約が最も共通の DITA 再利用メカニズムの役立つ概観となることを希望します：
I. Reusing topics and groups of topics
トピックのトピックとグループを再利用
II. Reusing parts of a topic
トピックの部分を再利用
III. Reusing variable phrases
可変句を再利用
IV. Filtering your content
あなたのコンテンツをフィルタリング
Rather watch than read? Here’s a recording of our webinar: How to Reuse Structured Content With DITA.
読むよりどちらかと言えば注意してみてください。 ここに我々のウェビナーの記録があります： DITA で構造化されたコンテンツを再利用する方法。

Reusing topics and groups of topics
トピックとトピックのグループを再利用

The most basic form of reuse is using one topic in multiple deliverables. This is possible:
再利用の最も多くの基本形は、複数の成果物で１つのトピックを使っています。 これは下記の時に可能です：
 When the content of a topic is identical for different audiences, products, deliverable types, and so on. In this case, you simply add the same topic in multiple maps. A good example of this type of reuse is a topic with copyright information that is identical for all deliverables your organization publishes.
トピックのコンテンツが異なった聴衆、製品、配達可能なタイプなどのために同一であるとき。 この場合、あなたは複数のマップで同じトピックを単に加えます。 このタイプの再利用の良い例はあなたの組織が発表するすべての成果物のために同一の著作権情報を持っているトピックです。
 When topic content is identical, with the exception of the product name, product-specific information, or even user interface elements. In this case, you can still reuse the topic and add variables, which we’ll discuss later in this post.
トピックのコンテンツが、製品名、製品に特定された情報、あるいはユーザインタフェース要素さえ例外として同一であるとき。 この場合、あなたはまだトピックを再利用して、そして変数を加えることができます。そしてそれを我々は後にこの投稿で論じるでしょう。
To add a topic to a deliverable, you attach it to a map. To reuse a topic in multiple deliverables, you simply attach it to multiple maps. Maps are how DITA bundles a set of topics together to work with them as a group.
成果物にトピックを加えるために、あなたはそれをマップに取り付けます。 複数の成果物でトピックを再利用するために、あなたはただそれを複数のマップに取り付けます。 マップは DITA がどのように一つのグループとしてそれらと共に働くためにトピックのセットをまとめるかです。

What is a DITA map? Here’s a post explaining the Basics of DITA Maps.
DITAのマップとは何ですか？ ここに DITA マップの基礎を説明している投稿があります。
Here is an example of reusing one topic in two maps. The group of Topics (blue) represents your Content Library and you can see that the Introduction, Maintenance, and Troubleshoot topics are reused in both maps.
ここに２つのマップで１つのトピックを再利用する例があります。 トピックのグループ（青）はあなたのコンテンツライブラリを表しています、そしてあなたはイントロダクション、保守と修理トピックが両方のマップで再利用されるのを見ることができます。

Apart from topics, you can also reuse entire maps. It’s a powerful method of reuse, for example, if you need to maintain a catalog of all product documentation and also be able to print a product deliverable independently.
トピックを別として、あなたは同じくマップ全体を再利用することができます。 もしあなたがすべての製品ドキュメンテーションのカタログを保守して、そして同じく独立して製品の成果物をプリントすることが可能である必要があるなら、それは例えば、再利用の強力な方法です。
How it’s done: You can reuse topics and maps directly by including a reference to a specific topic or map using a topic reference (topicref) or map reference (mapref). You can also reuse topics and maps indirectly by referring to a key value (keyref) that gets a specific definition elsewhere. It’s like saying ‘I’m going home’, instead of saying ‘I’m going to a specific address’. Your home is, of course, at a specific address. Someone else’s home is at a different address. At the end of the day, you can both say ‘I’m going home.’
そうする方法：あなたは、特定のトピックへのリファレンスを含むことによって、直接トピックとマップを再利用するか、あるいはトピックを使ってリファレンス（topicref）あるいはマップのリファレンス（mapref）をマップすることができます。 あなたは、ほかのところの特定の定義を得る重要な値（keyref）を参照することによって、間接的に同じくトピックとマップを再利用することができます。 それは、「私は特有な住所に行きます」と言う代わりに、「私は家に帰ります」と言うようなものです。 あなたの家は、もちろん、特有な住所にあります。 ほかの誰かの家は異なった住所にあります。 結局のところ、あなたは共に「私は家に帰ります。」と言うことができます。