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

Incorporate in Markdown docs also possibility to reuse #504

Open
raducoravu opened this issue Oct 24, 2023 · 2 comments
Open

Incorporate in Markdown docs also possibility to reuse #504

raducoravu opened this issue Oct 24, 2023 · 2 comments

Comments

@raducoravu
Copy link
Member

raducoravu commented Oct 24, 2023

Description

Maybe mention in the Markdown docs:
https://www.dita-ot.org/dev/reference/markdown/markdown-dita-syntax
that you can also conref content from a DITA topic like:

<p data-conref="t1.dita#t1/reused"/>
@infotexture
Copy link
Member

There's been some discussion of this in the past, and while it works, I recall there was some hesitation to recommending XML-in-Markdown for things like this.

When authoring HTML in Markdown, that's the official fallback:

For any markup that is not covered by Markdown’s syntax, you simply use HTML itself.

In LwDITA, things like this work in some cases, but I'm not sure the spec really intended for things to be done this way. The Markdown DITA format supports a few things LwDITA doesn't, but we'd need to be very clear on what works where.

Perhaps @jelovirt, @fwegmann, or others can provide additional details.

@kirkilj
Copy link

kirkilj commented Oct 24, 2023

When I looked at the LwDITA plugin's test content a while ago, I saw some aspects that didn't appear to be documented. Perhaps it was just the conref mentioned by @raducoravu, but I'd recommend a scan through the test content directories and the file contents themselves for a thorough sweep if we want a comprehensive list.

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

3 participants