Page 1 of 1

File name changes in reusable components

Posted: Wed Nov 03, 2021 11:38 pm
by verostarry
Hello,

I'm facing a few issues updating links, especially for reusable components.

As an overall question for all types of files, when we rename files, is there a way to make the references to those files in ditamaps, other topics, etc. auto update? What we're currently doing is:

1. rename a file
2. go into any ditamap it's referenced in, remove the old reference, which now appears as a broken link with a red underline, and add the new reference by copy and pasting the file with its new name

We're encountering an additional issue when we try to do this with with reusable component files, which are also all referenced in a ditamap. When renaming these files, and cleaning up the ditamap references to go to the new names, our build breaks. Even for files that aren't used anywhere else other than the ditamap. This is the error it gives:

Failed to run pipeline: [DOTX008E][ERROR] File 'file:/Users/user/Desktop/workplace/TC/src/TestDocs/reusable-components/61-10-01-202.dita'

Please advise on best practices and potentially issues, if you see them.

Thank you,
Veronica

Re: File name changes in reusable components

Posted: Thu Nov 04, 2021 2:38 pm
by Radu
Hi Veronica,

We this feature in Oxygen named "Main Files" which allows you to tell Oxygen which are your main DITA Maps and when you move or rename resources in the Oxygen project view the references to those resources will be automatically updated:

https://www.oxygenxml.com/doc/versions/ ... files.html

Regards,
Radu

Re: File name changes in reusable components

Posted: Thu Dec 09, 2021 8:54 pm
by verostarry
Hi Radu,

Main files works perfectly for our use case - thanks very much!

Cheers,
Veronica