Table of contents & header

Questions about XML that are not covered by the other forums should go here.
julie
Posts: 61
Joined: Fri Jun 06, 2008 7:09 am

Table of contents & header

Post 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
Radu
Posts: 9439
Joined: Fri Jul 09, 2004 5:18 pm

Re: Table of contents & header

Post 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:

Code: Select all

<h1>Contents:</h1>
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
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
julie
Posts: 61
Joined: Fri Jun 06, 2008 7:09 am

Re: Table of contents

Post 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
Radu
Posts: 9439
Joined: Fri Jul 09, 2004 5:18 pm

Re: Table of contents & header

Post 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
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
julie
Posts: 61
Joined: Fri Jun 06, 2008 7:09 am

Index

Post 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
Radu
Posts: 9439
Joined: Fri Jul 09, 2004 5:18 pm

Re: Table of contents & header

Post 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
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
Radu
Posts: 9439
Joined: Fri Jul 09, 2004 5:18 pm

Re: Table of contents & header

Post 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
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
julie
Posts: 61
Joined: Fri Jun 06, 2008 7:09 am

Re: Table of contents & header

Post 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
Post Reply