Update outgoing (but not incoming) references when Main Files content is copied

Are you missing a feature? Request its implementation here.
chrispitude
Posts: 369
Joined: Thu May 02, 2019 2:32 pm

Update outgoing (but not incoming) references when Main Files content is copied

Post by chrispitude »

In Oxygen, the Main Files feature allows references to be automatically updated when files are renamed or moved.

It would be great if Main Files support could handle file copying as well. When files are copied,
  • Outgoing references from the copied content should be updated
  • Incoming references to the original content being copied should remain unchanged
We have various templates (book, application note, release notes) stored in a templates/ directory. These templates reference content in a central warehouse directory. Unfortunately, when template content is copied to a new location, all the warehouse references become broken and thus require manual fixing.

In the following example, note that the copied version of release_notes.ditamap has broken links, even though the original (source) map is in the Main Files list:

main_files_copy.gif
main_files_copy.gif (95.57 KiB) Viewed 271 times

If the copy operation adjusted outgoing references within the copied content, the newly copied content would be ready for immediate use.

Testcase attachment:
oxygen_main_files_copy.zip
(5.31 KiB) Downloaded 14 times
Radu
Posts: 7779
Joined: Fri Jul 09, 2004 5:18 pm

Re: Update outgoing (but not incoming) references when Main Files content is copied

Post by Radu »

Hi Chris,

I understand and thanks for the samples, I added:

EXM-49471 Main Files - Update references when resources are copied

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
chrispitude
Posts: 369
Joined: Thu May 02, 2019 2:32 pm

Re: Update outgoing (but not incoming) references when Main Files content is copied

Post by chrispitude »

Thanks Radu!

This is super minor, but should the broken <ditavalref> above also have the red "broken link" indicator thingy?
Radu
Posts: 7779
Joined: Fri Jul 09, 2004 5:18 pm

Re: Update outgoing (but not incoming) references when Main Files content is copied

Post by Radu »

Hi Chris,

I'll add an issue as well to present a small warning icon also for the missing ditavalref. I see it's reported as a warning by Oxygen, maybe we should report this case as an error instead because the ditavalref has a local scope so I will also add another issue to present as errors paths to missing ditavalref files.

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
Radu
Posts: 7779
Joined: Fri Jul 09, 2004 5:18 pm

Re: Update outgoing (but not incoming) references when Main Files content is copied

Post by Radu »

Just to add the IDs of the two extra issues I added on my side:

EXM-49498 No decorator icon is shown in DITA Maps Manager for warnings
EXM-49499 Reference to missing ditaval file (ditavalref) should be presented as error not as warning

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
Post Reply