Integration of the MATHML specialization in SDL Knowledge Center 2016

Hello everyone,

I am currently using SDL Knowledge Center 2016 and would like to store a DITA XML topic that uses the MATHML specialization.
The problem is that the <DOCTYPE> in the header of the topic is not recognized and there is certainly a missing DTD file somewhere.
I suppose I should also integrate this specialization with DITA-OT to publish my PDF documents.

Has any of you ever integrated this specialization?
All help is welcome.

Best regards.
Sylvain

Parents
  • Hi Sylvian,

    Assuming you have the correct DTD files available for the MATHML specialization on your side, you will have to make them available in the system.
    1/ Make the DTD files available by copying them to the correct location in the doctypes folder (<drive-letter>:\Infoshare\Web<project-suffix>\Author\ASP\DocTypes).
    Out of the box this should be <drive-letter>:\Infoshare\Web<project-suffix>\Author\ASP\DocTypes\dita-oasis\1.2\

    Do keep in mind that this dita-oasis\1.2 folder has different subfolders for the different dtd and mod files of the DITA dtd available, so ensure that the references used by the MathML dtd are correctly pointing to the files in this structure.
    Check parent paths for correctness and/or referenced objects by PUBLIC identifier.

    2/ Include the new PUBLIC identifiers to the catalog file 'catalog-dita.xml' which is available in the <drive-letter>:\Infoshare\Web<project-suffix>\Author\ASP\DocTypes

    eg.
    <public publicId="-//YOUR PUBLIC IDENTIFIER FOR DTD//EN" uri="dita-oasis/1.2/YOUR PATH TO THE MATHML DTD/mathml.dtd"/>

    if Elements and entities are available in separate files

    <public publicId="-//YOUR PUBLIC IDENTIFIER FOR ELEMENTS//EN" uri="dita-oasis/1.2/YOUR PATH TO THE MATHML DTD/mathml.mod"/>
    <public publicId="-//YOUR PUBLIC IDENTIFIER FOR ENTITY//EN" uri="dita-oasis/1.2/YOUR PATH TO THE MATHML DTD/mathml.ent"/>

    If you use an editor which uses the text based catalog representation you need to update the 'catalog-dita-dtds' file as well, which is available in the same location as the catalog-dita.xml file.

    DO KEEP IN MIND THAT MAKING BACKUP COPIES OF THE ORIGINAL FILES BEFORE CHANGING THEM WILL ALLOW YOU TO ROLLBACK THE CHANGES IF REQUIRED.

    This should allow you to upload/edit and publish content including the MATHML specializations as the DITA-OT single sources the same catalog as the KC environment and the editors.

    Kind Regards,

    Raf
  • Hi Raf,

    Thank you very much for your answer.

    I followed your instructions and the principle works, but...
    I used the basic W3C MathML DTD and the problem is that it is not integrated with DITA.
    Oasis offers a MathML DTD, but it is integrated with the DITA 1.3 standard. This probably means that I should integrate all the files in version 1.3 for the dependencies to work.
    In addition, we are currently using DITA-OT 1.8.5 which does not support MathML. Antenna House seems to support MathML, but I have not tried it.
    I saw that it was possible to use an output of dita4publishers (html) but for now, I have no resources to test this plugin.

    I will wait for the DITA 1.3 standard to be included in SDL Tridion Docs (also for the 'Troubleshooting' topics) to study the possibility of using these specializations.

    Best regards.
    Sylvain
Reply
  • Hi Raf,

    Thank you very much for your answer.

    I followed your instructions and the principle works, but...
    I used the basic W3C MathML DTD and the problem is that it is not integrated with DITA.
    Oasis offers a MathML DTD, but it is integrated with the DITA 1.3 standard. This probably means that I should integrate all the files in version 1.3 for the dependencies to work.
    In addition, we are currently using DITA-OT 1.8.5 which does not support MathML. Antenna House seems to support MathML, but I have not tried it.
    I saw that it was possible to use an output of dita4publishers (html) but for now, I have no resources to test this plugin.

    I will wait for the DITA 1.3 standard to be included in SDL Tridion Docs (also for the 'Troubleshooting' topics) to study the possibility of using these specializations.

    Best regards.
    Sylvain
Children
No Data