Example of Ditamap including a Markdown map?

41 views
Skip to first unread message

Joaquim Baptista

unread,
Dec 6, 2023, 6:16:21 AM12/6/23
to DITA-OT Users
Greetings,

Using DITA OT 4.1.2, I tried converting a ditamap to Markdown. However, I have so far failed to refer (using mapref) the new Markdown ditamap from a regular XML ditamap.

Anyone has an example mapref they can share?

The obvious examples below fail, and I am running our of ideas:

    <mapref href="map.mditamap">
    <mapref href="map.mditamap" format="markdown">
    <mapref href="map.mditamap" format="mdita">
    <mapref href="map.mditamap" format="mditamap">

map.mditamap starts with the schema:

    ---
    $schema: urn:oasis:names:tc:dita:xsd:map.xsd
    ---
    # My title
      * [](mytopic.md)

--
Joaquim Baptista, Information Governance Principal

Radu Coravu

unread,
Dec 7, 2023, 9:38:07 AM12/7/23
to Joaquim Baptista, DITA-OT Users
Hi,

You are probably referring to this feature, right:
From what I tested I can publish a Markdown DITA Map to HTML for example but I also did not succeed in referencing to it from a DITA Map as:

   <topicref href="test.md" format="mditamap"/>

and then successfully publishing.
I added this issue:
maybe you can register to watch it and we can discuss there further.

Regards,
Radu

This email and any files transmitted with it are confidential and intended solely for the use of the individual or entity to whom they are addressed. If you have received this email in error please notify the system manager. This message contains confidential information and is intended only for the individual named. If you are not the named addressee you should not disseminate, distribute or copy this e-mail. Please notify the sender immediately by e-mail if you have received this e-mail by mistake and delete this e-mail from your system. If you are not the intended recipient you are notified that disclosing, copying, distributing or taking any action in reliance on the contents of this information is strictly prohibited.

--
You received this message because you are subscribed to the Google Groups "DITA-OT Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to dita-ot-user...@googlegroups.com.
To view this discussion on the web, visit https://groups.google.com/d/msgid/dita-ot-users/b0d057bf-12bb-413d-986c-5e3e6cb9c2ben%40googlegroups.com.

Joaquim Baptista

unread,
Dec 7, 2023, 1:17:38 PM12/7/23
to DITA-OT Users
Thanks for opening the issue.

I took the oportunity to argue for a more seamless Markdown authoring experience in the same issue.

n7...@earthlink.net

unread,
Dec 7, 2023, 11:42:30 PM12/7/23
to DITA-OT Users
FYI - I have added a comment related to MDITA maps to the bug that Radu mentions:

https://github.com/jelovirt/org.lwdita/issues/201

TL;DR: We might be changing the MDITA map from Markdown to YAML. And XML maps work fine.

Mark Giffin

Reply all
Reply to author
Forward
0 new messages