To install the add-on, follow these instructions:
- Go to Help > Install new add-ons... to open an add-on selection dialog box.
- Enter or paste https://raw.githubusercontent.com/oxygenxml/dita_1_3_to_2_x_convert/main/addon.xml in the Show add-ons from field.
- Select the Convert DITA 1.3 maps and topics to the DITA 2.x standard add-on and click Next.
- Read the end-user license agreement. Then select the I accept all terms of the end-user license agreement option and click Install.
- Restart the application.
Result: In the application main menu Tools->XML Refactoring dialog you will find a new refactoring action named "Convert DITA 1.3 maps and topics to the DITA 2.x standard" which can be applied on your DITA resources.
The refactoring action performs the following changes:
- Changes DOCTYPE declarations and XML Schema/Relax NG schema references.
- DITA Map changes:
- Removes the
@lockmeta
attribute. - Removes the
<topicset>
and<topicsetref>
elements. - Migrates the
@navtitle
attribute as a<navtitle>
element. - Migrates the
@title
attribute as a<title>
element. - Converts the
@copy-to
attribute to a<resourceid>
element. - Replaces the
@print
attribute with an@deliveryTarget
attribute. - Convert topicmeta
<linktext>
to<linktitle>
- Removes the
- DITA task changes:
- Converts the
<substep>
element to a<step>
element. - Converts the
<substeps>
element to a<steps>
element.
- Converts the
- DITA topic changes:
- Removes the
@type
attribute with the valuefastpath
. - Converts the
@alt
attribute to an<alt>
element. - Replaces the
<index-sort-as>
element with a<sort-as>
element. - Removes the
<itemgroup>
element. - Moves the contents of the
<titlealts>
element inside the<prolog>
. - Removes the
@domains
element. - Renames
<sectiondiv>
to<div>
. - Remove
@query
attribute from<link>
element.
- Removes the