Page 1 of 1
Table of contents & header
Posted: Thu Jun 12, 2008 11:37 am
by julie
Hi
When I transform the DITA documents to XHTML, a TOC page is automatically generating with links to the corresponding chapters. I want to give a heading to this page as 'Contents". Is it possible? Also, I want the header of each page displays the chapter name. is it possible to customize the header?
Regards
Julie
Re: Table of contents & header
Posted: Thu Jun 12, 2008 12:32 pm
by Radu
Hi Julie,
About displaying "Contents" in the TOC:
Open the XSL stylesheet
{OXYGEN_INSTALL_DIR}/frameworks/dita/DITA-OT/xsl/map2htmtoc.xsl in Oxygen and at line 80 you have the code which outputs the HTML <body> element.
You can add a new line after the <body> with:
About displaying the chapter name, where do you want the chapter name taken from? Is it fixed? Can you be more precise?
Also I would recommend you to join the DITA Users Mailing list as it is very active and has lots of interesting DITA questions posed and answered every day. See
http://tech.groups.yahoo.com/group/dita-users/
Regards,
Radu
Re: Table of contents
Posted: Thu Jun 12, 2008 1:11 pm
by julie
Hi Radu
Thanks a lot...it worked perfect!!!!!
Can you suggest a good online course that will help me to learn everything about documentation using the OxygenXML? I am the only technical writer in the company and I have to learn everything myself. My manager want to use OxygenXML in documentation and asked me to learn it as fast as I could. I highly appreciate your suggestion regarding this. Please help.
Regards
Julie
Re: Table of contents & header
Posted: Thu Jun 12, 2008 1:57 pm
by Radu
Dear Julie,
We have some video demonstrations about Oxygen and DITA here:
http://www.oxygenxml.com/documentation.html
Also there is Tagsmith
http://www.oxygenxml.com/forum/topic2891.html which offers specialized DITA support and also offers some basic ideas about the DITA architecture.
Also Bob Doyle is a DITA specialist and has some very interesting DITA tutorials.
See here:
http://dita.xml.org/5-minute-dita-tutorial
Regards,
Radu
Index
Posted: Mon Jun 16, 2008 11:47 am
by julie
Hi Radu
When we transform the xml documents, where is the index page displayed? Is it displayed as a link in the Content page or do I need to add it in the folder in OxygenXML?
Regards
Julie
Re: Table of contents & header
Posted: Mon Jun 16, 2008 4:09 pm
by Radu
Hi Julie,
Are you referring to using <indexterm>'s in topics and then expecting an extra "index" page in the output?
As far as I can see from the stylesheets DITA Open Toolkit does not generate an extra index page for HTML output if index terms are used in the topics.
I asked them about this on their user list and will get back to you with more details if answered.
Regards,
Radu
Re: Table of contents & header
Posted: Tue Jun 17, 2008 9:49 am
by Radu
Hi Julie,
I got an answer on the DITA users list and indeed, generating index term pages with XHTML output is not possible using the DITA Open Toolkit.
Regards,
Radu
Re: Table of contents & header
Posted: Tue Jun 17, 2008 11:22 am
by julie
Hi Radu
Thanks a lot for the information. I had seen your post yesterday and was waiting for the reply.
Thanks again
Regards
Julie