DITA and XMetaL Discussion
ramu December 9, 2013 at 8:46 am
customizing stylesheetDecember 9, 2013 at 8:46 amParticipants 9Replies 10Last Activity 8 years, 10 months ago
Hello every one.
I am doing some customization task. I have modified teamcenter style sheet and applied to my xml file and got output as per my requirement. But i have to perform some more task to get full output. That is i have to link the style sheet to the DTD file (xmetal). (i have to apply some logical operations for acquiring automated test. )
Ex. my page number column looks like this ———-TM-01-01-00-01
Here TM-manual name.(doesn't change through out the document)
01-chapter-1(depends on the manual. Generally we have multiple chapters)
01-sections( multiple sections in chapter)
01 -page number
the dtd file i am using is C:Program FilesCommon FilesXMetaL SharedDITA_OTdtdditabase.dtd
is this path is correct to make modifications.Derek Read December 9, 2013 at 7:14 pm
Reply to: customizing stylesheetDecember 9, 2013 at 7:14 pm
If all you are doing is making modifications to the CSS used for authoring then add any overrides into end of the CSS file in the folder for the specific topic type you wish to change the styling for. For example, if you are authoring to the DITA 1.2 spec, to modify the CSS for “task” do it here (assuming you are using the 8.0 release):
C:Program FilesXMetaL 8.0AuthorDITAXACs1.2tasktask.css
To make changes that affect all topic types add overrides to one of these files:
C:Program FilesXMetaL 8.0AuthorDITAXACs1.2ditabaseditabase-base-override.css
C:Program FilesXMetaL 8.0AuthorDITAXACs1.2ditabaseditabase-derived-override.css
Keep in mind that standard CSS cascading rules apply. In the case of my earlier example the main CSS file for task is C:Program FilesXMetaL 8.0AuthorDITAXACs1.2tasktask.css. If you open that file you will see which other files are imported and in which order. In all cases you want whichever selector you create to be loaded last and be at least as specific as the selector that it is overriding.
If you are working with XMetaL Author Enterprise and authoring DITA you should not be modifying the DITA DTDs directly. What you've stated suggests that might be what you are considering. That is not supported. You can “specialize” the DITA DTDs and that is fully supported. If you have a specialized DITA DTD then follow the instructions in the help (F1) under Working with DITA > DITA Specializations. That discusses how to configure XMetaL Author Enterprise to recognize your specialized DITA DTD.
All of the above applies to an installation where a CMS is not being used. If you are using a CMS then you should follow any instructions provided by the CMS vendor for their integration with XMetaL Author Enterprise. CMS integrations with XMetaL often have specific requirements. Some of them store XMetaL “customizations” in the CMS itself and deploy them to your local machine and in that case you will need to make modifications to the copies of any files stored in the CMS rather than the local copies.ramu December 10, 2013 at 11:42 am
Reply to: customizing stylesheetDecember 10, 2013 at 11:42 am
I am really confused with this css and dtd's. let me explain my need.
in my style sheet(teamcenter cms stylesheet) i have modified some sections. now there is need to write logic in style sheet that should call function within xmetal files. If am not clear, i can show you this through webex.Derek Read December 11, 2013 at 1:50 am
Reply to: customizing stylesheetDecember 11, 2013 at 1:50 am
After your further explanation (after submitting a case to XMetaL Support) we now understand that you are making changes to the DITA Open Toolkit's XSLT files in order to customize PDF output. The confusion here stems from the use of the term “stylesheets” to mean both CSS and XSLT.
My explanation assumed the former (CSS), which is used by XMetaL Author for displaying your XML files during authoring (only).
Making modifications to the XSLT that drives the DITA Open Toolkit is something you should consider hiring expert help for if you do not have someone in house with XSLT expertise. In addition to understanding XSLT, if your output is PDF then that person will also need to have some understanding of XSL-FO. The DITA Open Toolkit uses your DITA inputs (map and topics) together with XSLT to generate XSL-FO which in turn is passed to the PDF rendering engine (probably Apache FOP or RenderX XEP, though Antenna House is also supported) to produce a PDF.ramu December 18, 2013 at 6:11 am
Reply to: customizing stylesheetDecember 18, 2013 at 6:11 am
But where this xslt files are located????
I am doing modifications for composite type.Derek Read December 19, 2013 at 12:09 am
Reply to: customizing stylesheetDecember 19, 2013 at 12:09 am
When you generate output which “deliverable” do you select?
There are several different PDF deliverables and each uses different XSLT files (and different XSL-FO to PDF engines).ramu December 19, 2013 at 4:32 am
Reply to: customizing stylesheetDecember 19, 2013 at 4:32 am
Xmetal enhanced PDF via RenderXXEPDerek Read December 19, 2013 at 8:01 pm
Reply to: customizing stylesheetDecember 19, 2013 at 8:01 pm
XMetaL Author Enterprise 8.0 deploys and runs the DITA OT from here:
The XSLT files you will need to modify are probably all in this folder:
If you will be setting this up for multiple users please also read these topics:
http://forums.xmetal.com/index.php/topic,224.msg687.html#msg687ramu December 23, 2013 at 8:53 am
Reply to: customizing stylesheetDecember 23, 2013 at 8:53 am
I am followed the path what you specified. But In my dita OT folder, there is no file named Plugins…Derek Read December 23, 2013 at 10:34 pm
Reply to: customizing stylesheetDecember 23, 2013 at 10:34 pm
You must have an older version than 8.0. The DITA OT was reorganized with the release of DITA OT 1.7 and we included 1.7 with our 8.0 release of XMetaL Author Enterprise.
This is why it is useful to specify which version of the software that you are running (look here for information on obtaining version numbers: [url=http://forums.xmetal.com/index.php/topic,384.0.html]about the forum[/url]).
In your case look in this folder for the XSLT:
- You must be logged in to reply to this topic.