Frameset in DITA XHTML output

Here should go questions about transforming XML with XSLT and FOP.
asw66
Posts: 6
Joined: Tue May 06, 2008 8:30 am

Frameset in DITA XHTML output

Post by asw66 »

Hi there,

I'm using Oxygen 9.2, and the default XHTML output doesn't generate a frameset. How do I change this?

Thanks

Andrew W.
Radu
Posts: 9446
Joined: Fri Jul 09, 2004 5:18 pm

Re: Frameset in DITA XHTML output

Post by Radu »

Dear Andrew,

Oxygen uses the DITA Open Toolkit to publish DITA to various output formats.
The toolkit is located in the {$OXYGEN_INSTALL_DIR}/frameworks/dita/DITA-OT directory.
The ANT dita2xhtml target which builds XHTML output needs to be customized for publishing XHTML framesets.
You can see the link below for further details:
http://www.ditainfocenter.com/eclipsehe ... meset.html

If you encounter problems please write us at http://www.oxygenxml.com/techSupport.html and I will try to provide you with step by step instructions.

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
Radu
Posts: 9446
Joined: Fri Jul 09, 2004 5:18 pm

Re: Frameset in DITA XHTML output

Post by Radu »

Dear Andrew,

If you use the default DITA OT XHTML transformation it creates a directory "out" in the same folder where the map is located.
In that directory you must create a file called "index.html" with the following content:

Code: Select all


<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"></meta>
<title>DITA Open Toolkit User Guide</title>
<!-- The following two lines cause the default styling for the navigation frame
to be the same as the content frame. -->
<link href="CSS/commonltr.css" type="text/css" rel="stylesheet" />
<link href="CSS/DITAOTUG_CSS.css" type="text/css" rel="stylesheet" />
</head>
<!-- The left-hand navigation frame is 30% of the available space -->
<!-- The right-hand content frame takes up the rest of the available space -->
<frameset cols="30%,*">
<!-- tocwin is the navigation frame -->
<frame name="tocwin" src="toc.html"></frame>
<!-- contentwin is the content frame -->
<frame name="contentwin" src="toc.html"></frame>
</frameset>
</html>
Then edit the default DITA OT XHTML scenario that you are using in Oxygen and in the "Parameters" tab set the value of "args.xhtml.toc" to "toc" instead of "index".

The output main html file will thus be named "toc.html" and Oxygen will open it at the end of the transformation.
Open manually the "index.html" file in the browser. It contains the "toc.html" in the left frame and the clicked links will be opened in the right one.

Hope this helps,
Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
asw66
Posts: 6
Joined: Tue May 06, 2008 8:30 am

Re: Frameset in DITA XHTML output

Post by asw66 »

Thanks Radu, that's working well.

Cheers!
asw66
Posts: 6
Joined: Tue May 06, 2008 8:30 am

Re: Frameset in DITA XHTML output

Post by asw66 »

By the way, can I request a slicker implementation of the frameset output soon?

I'm happy to have this working, of course, but in the longer term it would be highly desirable to get frameset output by simply adjusting one or two parameters.

Thanks again,

Andrew W.
Radu
Posts: 9446
Joined: Fri Jul 09, 2004 5:18 pm

Re: Frameset in DITA XHTML output

Post by Radu »

Hi Andrew,

We will consider this for a future version.

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
Post Reply