DITA and XMetaL Discussion

XMetaL Community Forum DITA and XMetaL Discussion Specialized topic types – DITA OT PDF output

  • deschnerc

    Specialized topic types – DITA OT PDF output

    Participants 5
    Replies 6
    Last Activity 13 years, 4 months ago

    Hello,

    I made some specilizations, there are some new topic types (from Generic Topic) and some new map types.

    In XMetaL the specializations are recognized as DITA specializations, but when I want to create a preview PDF the new topic types seem not to be processed. These topics are missing in the output.

    I tried to create xsl files similar to the “FAQ” example, but it does not work. I modified the catalog files (catalog-dita.xml, catalog-dita.txt and catalog-dita_template) similar to the “FAQ” example, but it does not work.

    Any ideas? Which files do I have to create and/or extend when defining new new topic types?

    Reply

    Derek Read

    Reply to: Specialized topic types – DITA OT PDF output

    If the DITA OT cannot find your DTDs that is one main reason for output to fail. The only thing that should be necessary in most cases is to tell the DITA OT how to find your specialized DTDs by placing entries in catalog-dita_template.xml.

    If you place a copy of your specialized DTDs near the DITA OT's DTDs (here: ..DITA_OTdtd) and reference files relative to that position then things should “just work” (and doing so makes it easier to keep track of the relative paths). In most cases I would recommend putting your specialized DTDs in a folder at the same level as the FAQ demo. This is because FAQ definitely works, so if your's doesn't you can then have a look at how they differ. With a default XMetaL Author Enterprise 5.1 installation on English XP this would be here:

    C:Program FilesCommon FilesXMetaL SharedDITA_OTdemo

    In some cases a specialization may also provide its own custom output format(s). The DITA OT has a standard method for creating those. But with a proper specialization (one that follows the OASIS specs) that should not be necessary unless you need to do special processing for your particular document type(s) to generate output in a way that differs from the standard output for the element that your specialized element is based on. A good example of this (I believe) would be the “DITA Learning and Training Content Specialization” which includes additional special output processing, if I remember correctly (it's been a while since I looked at it and it has probably changed significantly since then as well).

    Reply

    deschnerc

    Reply to: Specialized topic types – DITA OT PDF output

    Thanks for your response,

    I tried to modify the file “catalog-dita_template.xml”.

    My specialized DTD is located in

    “C:ProgrammeGemeinsame DateienXMetaL SharedDITA_OTt3”, the Public Id are “t3” and “t3_map”.

    The entries in “catalog-dita_template.xml” are

    The result is the same.

    I moved my DTD to the folder “C:/Programme/Gemeinsame Dateien/XMetaL Shared/DITA_OT/demo/t3” (I updated the references accordng to new location in my DTDs and in the catalog files). The result is the same, in the Editor it works, the map was processed correctly but the topics are missing.

    I am really confused…

    Reply

    Derek Read

    Reply to: Specialized topic types – DITA OT PDF output

    If you have not checked the DITA OT's output log file that would be a good place to start. From my experience when the DITA OT fails in these cases the log file error messages are fairly helpful.

    Reply

    deschnerc

    Reply to: Specialized topic types – DITA OT PDF output

    If you have not checked the DITA OT's output log file that would be a good place to start. From my experience when the DITA OT fails in these cases the log file error messages are fairly helpful.

    This would be right, but the problem is: When I click “Show Logfile”, the system tells me that there is no log file. Where can I find the logfile manually?

    Reply

    Derek Read

    Reply to: Specialized topic types – DITA OT PDF output

    The log file should be generated here:
    %USERPROFILE%Local SettingsTempXMetaLrenditionsloglog.txt

    On a default installation of English Windows XP that file will be here:
    C:Documents and SettingsLocal SettingsTempXMetaLrenditionsloglog.txt

    XMetaL Author Enterprise uses that file as the base for what it shows you (basically everything it contains is shown in the log file you open in XMetaL plus some additional information, plus it is reformatted as XML so that it can be displayed in XMetaL, along with the little bit of styling that attempts to highlight what are most likely to be areas of concern based on various keywords).

    Reply

    deschnerc

    Reply to: Specialized topic types – DITA OT PDF output

    Ok, I solved the problem. My DITA OT Installation was damaged.

    Thx a lot!

    Reply

  • You must be logged in to reply to this topic.

Lost Your Password?

Products
Downloads
Support