Adding owner/contributor author metadata to DITA topic files
Posted: Wed Feb 03, 2021 2:59 am
Hi everyone,
We plan to start storing author (owner/contributor) metadata in our DITA topic files:
I created a refactoring operation to help set the metadata in existing content:
Here are the files if you want to use it:
The refactoring operation creates a <prolog> if it doesn't exist, and updates it in-place if it does.
The refactoring operation offers two roles (owner and contributor) but you can edit the value list in the .xml file to add as many role values as you want. If there are multiple authors and multiple roles, the <author> elements are sorted by role first (according to the order list in the .xsl file), then by username within the same role.
There are some limitations to this refactoring operation:
We plan to start storing author (owner/contributor) metadata in our DITA topic files:
Code: Select all
<topic id="xyz">
<title>My Topic</title>
<prolog>
<author type="owner">chrispy</author>
<author type="contributor">milada</author>
</prolog>
...
</topic>
Here are the files if you want to use it:
The refactoring operation creates a <prolog> if it doesn't exist, and updates it in-place if it does.
The refactoring operation offers two roles (owner and contributor) but you can edit the value list in the .xml file to add as many role values as you want. If there are multiple authors and multiple roles, the <author> elements are sorted by role first (according to the order list in the .xsl file), then by username within the same role.
There are some limitations to this refactoring operation:
- It only works on topics that have a <body> element.
- It does not work on glossary files.
- There is no removal operation.