Skip to main content
Inspiring
May 30, 2014
Question

Dreamweaver-style tool to keep track of links and filename changes in DITA?

  • May 30, 2014
  • 1 reply
  • 205 views

One problem I have been having in adopting the DITA model and using structured Frame is that, every time I change a file name or location, all the links and cross-references and mappings in my DITA system get broken. They are then hell to track down and fix.

In the old days, I remember using Dreamweaver to create web sites. This had a brilliant feature which tracked and fixed all broken links. If I had to rename a file, for example, the new name would automatically be updated everywhere the file was referenced.

Does anyone know of a tool that can do the same for DITA, either within FrameMaker or externally?

Thanks to all and happy weekend,

Elisa Roselli

Cambridge Imaging Systems

This topic has been closed for replies.

1 reply

ScottPrentice
Inspiring
June 2, 2014

Hi Elisa...

The simple answer is .. don't rename your files. Come up with a file naming scheme that won't encourage you to do that. I'm assuming that you're renaming files because the file name is based on the topic title? If you really want to have files named based on the topic title, try to generalize rather than match the title exactly. It's likely that the basic concept of the topic hasn't changed even if you revise the title .. create the file name from the concept of the content rather than the exact title.

OR .. you might also consider naming files from the topic's ID (assuming it's unique). I know this can sound scary, but since there are so many more files now, it's really hard to locate anything by looking for the right file name. It's much better to open the associated map and them double-click the topicref to open the file. It's like opening a FM book (root map) and opening the chapter file (sub map) and locating the topic in the chapter.

DITA-FMx does have a Reference Report command that lets you locate unresolved references, as well as a great Search in Files command that can help to locate files based on elements and attributes (and their values). I'm sure there are other tools that let you locate broken references .. but those would run outside of FrameMaker.

Cheers,

…scott