Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Problems defining links inside the same markdown file #231

Open
raducoravu opened this issue Nov 13, 2024 · 3 comments
Open

Problems defining links inside the same markdown file #231

raducoravu opened this issue Nov 13, 2024 · 3 comments

Comments

@raducoravu
Copy link
Collaborator

Started from a discussion with one of our clients.

Let's say inside the Markdown file I have this link:

See <a href="#myFigure1">Flowchart</a>.

and a div section somewhere else:

<div id="myFigure1"></div>

The link will not work because the div id value is re-written to incorporate also the topic ID. But the href value is not re-written.

So how can we link between two elements in the same topic?
This also does not work:

 See [Flowchart](#myFigure1)

and this also does not work:

 See [Flowchart](#./myFigure1)
@raducoravu
Copy link
Collaborator Author

Probably ideally for the person writing the Markdown the link syntax should be the same when used both inside the DITA OT and outside of the DITA OT.

@raducoravu
Copy link
Collaborator Author

raducoravu commented Nov 13, 2024

The lwdita plugin bundled with DITA OT 4.2.3 started issuing these problems when processing the markdown file, I assume because the <a> element gets converted to an xref without setting also a class attribute on it:

   [DOTJ030I] No @class attribute was found for the <xref> element. Processing as an unknown or non-DITA element.

@raducoravu
Copy link
Collaborator Author

With the lwdita plugin bundled with DITA OT 4.2.3 this syntax seems to work though:

 See [Flowchart](#./myFigure1)

I had previously tested with an older DITA OT distribution.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant