DITA and XMetaL Discussion
deschnerc February 19, 2009 at 10:33 am
Specialized topic types – DITA OT PDF outputFebruary 19, 2009 at 10:33 amParticipants 5Replies 6Last Activity 13 years, 4 months ago
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?Derek Read February 20, 2009 at 12:19 am
Reply to: Specialized topic types – DITA OT PDF outputFebruary 20, 2009 at 12:19 am
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).deschnerc February 20, 2009 at 2:25 pm
Reply to: Specialized topic types – DITA OT PDF outputFebruary 20, 2009 at 2:25 pm
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…Derek Read February 20, 2009 at 7:18 pm
Reply to: Specialized topic types – DITA OT PDF outputFebruary 20, 2009 at 7:18 pm
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.deschnerc February 21, 2009 at 12:46 pm
Reply to: Specialized topic types – DITA OT PDF outputFebruary 21, 2009 at 12:46 pm
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?Derek Read February 23, 2009 at 10:26 pm
Reply to: Specialized topic types – DITA OT PDF outputFebruary 23, 2009 at 10:26 pm
The log file should be generated here:
On a default installation of English Windows XP that file will be here:
C:Documents and Settings
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).
- You must be logged in to reply to this topic.