Author mode customization
Posted: Tue Jun 27, 2023 2:45 pm
I'm not sure whether this topic is appropriate in this forum. I've the request from user to enable external references from DITA topic authoring. They do not need hard PDF to PDF links. But they need other publication's title of a topic using specialized DITA elements "extref".
The story is illustrated below.
1. Prepare the XML file such as following. The contents are filled topic's @id and title contents.
3. Authoring phase
We want to enable the following topic authoring.
I will be appreciated if someone give me the pointers to enable this challenge in Oxygen XML Author.
I've downloaded Oxygen SDK. It's active in my Eclipse. But not sure how should I begin.
Regards,
The story is illustrated below.
1. Prepare the XML file such as following. The contents are filled topic's @id and title contents.
Code: Select all
<?xml version="1.0"?>
<library>
<book id="id-book-01">
<chapter id="id-chapter-001">
<title>1. Location of important labels</title>
</chapter>
<chapter id="id-chapter-002">
<title>2. Safety information</title>
</chapter>
<chapter id="id-chapter-003">
<title>3. Description</title>
</chapter>
<chapter id="id-chapter-004">
<title>4. Special features</title>
</chapter>
<chapter id="id-chapter-005">
<title>5. Instrument and control functions</title>
</chapter>
<chapter id="id-chapter-006">
<title>6. For your safety – pre-operation checks</title>
</chapter>
<chapter id="id-chapter-007">
<title>7. Operation and important riding points</title>
</chapter>
<chapter id="id-chapter-008">
<title>8. Periodic maintenance and adjustment</title>
</chapter>
<chapter id="id-chapter-009">
<title>9. Specifications</title>
</chapter>
<chapter id="id-chapter-010">
<title>10. Consumer information</title>
</chapter>
</book>
<book id="id-book-02">
<chapter id="id-chapter-001">
<title>1. And so on</title>
</chapter>
</book>
</library>
We want to enable the following topic authoring.
Code: Select all
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="extref_sample">
<title>Extref sample</title>
<abstract>
<p>We will apply specializtion to DITA DTD and introduce "extref" element to see topic titles in other bookmap.</p>
<p>No PDF hard links are needed. Only the topic/title is needed at Oxygen authoring time.</p>
<p>If the author inputs "extref" element, Oxygen XML Author will display the hierarchy of "extref-target.xml" and fetch the @id of book and chapter. Also the title contsnts that the author selects.</p>
<p>"extref-target.xml" will be updated for each book build. </p>
</abstract>
<conbody>
<p>For details, see <extref id="id-chapter-001" delivable="id-book-01">1. Location of important labels</extref></p>
</conbody>
</concept>
I've downloaded Oxygen SDK. It's active in my Eclipse. But not sure how should I begin.
Regards,