The great things about using a book to provide reusable topics are
- The book map itself provides key values for the reusable topics, and Oxygen defines key values for new topics automatically.
- There is no extra effort required to learn how to create warehouse topics; writers are already familiar with book creation.
- There is no extra effort required to micromanage warehouse topic filenames or directory structures; the DITA Maps Manager provides a logical view into the reusable content instead.
And here's a regular book that references a topic from the warehouse book:
However, I have not found a writer-friendly method to add warehouse topic refefences in my regular production books. The DITA itself is easy to write by hand:
Code: Select all
<map> <title>My Book</title> <mapref href="REUSE/warehouse_book.ditamap" format="ditamap" keyscope="warehouse_book" processing-role="resource-only"/> ... <topicref keyref="warehouse_book.cat_topic_1" keys="cat_topic_1"/> </map>
My enhancement request is, if topic references are copied/pasted in the DITA Maps Manager from book A to book B, and book A's keys are "reachable" from book B via mapref (scoped or not), then paste the topic references using keyref instead of href.
This is analogous to Oxygen's existing behavior for xrefs where it prefers keyrefs instead of hrefs when possible.
I'm attaching a small testcase.