DeepBlueCLtd / LegacyMan

Legacy content for Field Service Manual
https://deepbluecltd.github.io/LegacyMan/index.html
Apache License 2.0
2 stars 0 forks source link

Formatting a local reference #452

Closed IanMayo closed 1 year ago

IanMayo commented 1 year ago

In HTML a link to an anchor in the current page looks like this: #number2.

But, in DITA, the url should include the top-level topic id. So, in a topic with ID of VanesandCranes it's like:#VanesandCranes/number2`

This pattern of error is (obviously) present in Vanes&Cranes.html

robintw commented 1 year ago

Ah, this was the issue that came up before in #426. According to the DITA standard, we should be using the #ID/reference link, but DITA-OT doesn't seem to process these correctly, and leaves them as they are in the final HTML, when we need them to actually be changed to the mangled HTML version which is #ID__reference - eg. #VanesandCranes__number2.

I suspect we may have a problem here as we're going against the DITA official standard, but it seems to be necessary to make the HTML export work.

IanMayo commented 1 year ago

Yes, I was just thinking the same thing. Let me double-check Oxygen XML.

robintw commented 1 year ago

Fixed in #450.