How to generate different headers in same transformation DITA to HTML5 output
Post here questions and problems related to editing and publishing DITA content.
-
- Posts: 3
- Joined: Tue May 14, 2024 11:13 pm
How to generate different headers in same transformation DITA to HTML5 output
Post by tech_writer800 »
Hello,
We have the following deliverables that we output from DITA to HTML5 using Oxygen XML Editor 23.1 (soon to upgrade to 26.1):
I can add an anchor to the OM and SM to pull the RM into the HTML5 output, but each manual requires a different header. Is there any way to specify a header for the first manual (OM or SM) and a second header for the RM that's anchored into those maps? I'm not hopeful on this one, but I do have a manual workaround that will hold me for now. This is an in-house created help viewer, so ideally, a developer would fix it, but they haven't gotten to it yet and I'm not sure when they will.
Oxygen XML Editor 23, soon to upgrade to Oxygen XML Editor 26.1
Thanks.
We have the following deliverables that we output from DITA to HTML5 using Oxygen XML Editor 23.1 (soon to upgrade to 26.1):
- Operator's Manual
- Service Manual
- Regulatory Manual
I can add an anchor to the OM and SM to pull the RM into the HTML5 output, but each manual requires a different header. Is there any way to specify a header for the first manual (OM or SM) and a second header for the RM that's anchored into those maps? I'm not hopeful on this one, but I do have a manual workaround that will hold me for now. This is an in-house created help viewer, so ideally, a developer would fix it, but they haven't gotten to it yet and I'm not sure when they will.
Oxygen XML Editor 23, soon to upgrade to Oxygen XML Editor 26.1
Thanks.
Re: How to generate different headers in same transformation DITA to HTML5 output
Hi,
Just to make this clear, you are publishing DITA to plain HTML5 output. So you are not publishing DITA to WebHelp Responsive output using our special Oxygen publishing plugins.
Please see some answers below:
Or just publish each of these 3 publications individually and add some external links between them?
Regards,
Radu
Just to make this clear, you are publishing DITA to plain HTML5 output. So you are not publishing DITA to WebHelp Responsive output using our special Oxygen publishing plugins.
Please see some answers below:
What do you mean by "anchor", do you plan to maybe refer directly from the OM DITA Map with a mapref to the RM dita map? So that when you publish the OM publication it contains inside the topics from the RM publication?can add an anchor to the OM and SM to pull the RM into the HTML5 output, but each manual requires a different header.
Or just publish each of these 3 publications individually and add some external links between them?
How do you add these headers in the published HTML output?Is there any way to specify a header for the first manual (OM or SM) and a second header for the RM that's anchored into those maps? I'm not hopeful on this one, but I do have a manual workaround that will hold me for now. This is an in-house created help viewer, so ideally, a developer would fix it, but they haven't gotten to it yet and I'm not sure when they will.
Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
<oXygen/> XML Editor
http://www.oxygenxml.com
-
- Posts: 3
- Joined: Tue May 14, 2024 11:13 pm
Re: How to generate different headers in same transformation DITA to HTML5 output
Post by tech_writer800 »
Hi, thanks for getting back to me. I don't think I mentioned, we are using the DITA-OT 3.x.
Here are some answers:
Here are some answers:
- Yes, we publish DITA to plain HTML5 because we have our own help viewer. I should mention that the software I'm documenting is used in a medical setting and Javascript is not enabled on the computers where our software is used.
- Yes, I'm saying that I can add a mapref or an anchorref element to the Operator and Service maps to pull the RM navigation into the output TOC. The problem is that the headers for the topics in the RM manual will say, "Operator's Manual" or "Service Manual" when they need to say, "Regulatory and Safety Manual."
- The headers are added through the transformation property args.hdr. Unless there's a way to associate one header file with the main ditamap and another with the RM ditamap in a single transformation, I'll have to run the RM separately and replace the files generated from the OM and SM ditamaps. So, I'm hoping there's a more elegant solution.
Re: How to generate different headers in same transformation DITA to HTML5 output
Hi,
Some remarks below:
https://www.oxygenxml.com/dita/1.3/spec ... orref.html
So I assume you are actually using mapref, meaning you are actually creating a single large publication containing also the entire set of HTML resources from the Regulatory and Safety Manual." DITA Map.
Regards,
Radu
Some remarks below:
Ok, this question does not seem related to the Oxygen application and its publishing capabilities itself. Maybe in such cases you can also start a public discussion on the DITA OT discussions list, see what the community has to say: https://github.com/orgs/dita-ot/discussionsYes, we publish DITA to plain HTML5 because we have our own help viewer. I should mention that the software I'm documenting is used in a medical setting and Javascript is not enabled on the computers where our software is used.
Mapref and anchorref are totally different in behavior. From what I remember anchorref is not implemented by default in the plain XHTML output, do you have publishing customizations which handle anchorref in any way?Yes, I'm saying that I can add a mapref or an anchorref element to the Operator and Service maps to pull the RM navigation into the output TOC. The problem is that the headers for the topics in the RM manual will say, "Operator's Manual" or "Service Manual" when they need to say, "Regulatory and Safety Manual."
https://www.oxygenxml.com/dita/1.3/spec ... orref.html
So I assume you are actually using mapref, meaning you are actually creating a single large publication containing also the entire set of HTML resources from the Regulatory and Safety Manual." DITA Map.
Right now I do not have a good idea about how in a single published DITA Map output folder you could have one set of HTML resources with a certain header, and one set of HTML resources with another. Possibly some sort of custom DITA OT publishing plugin could be implemented to inject distinct header content in the generated HTML topics depending on their subfolder placement...The headers are added through the transformation property args.hdr. Unless there's a way to associate one header file with the main ditamap and another with the RM ditamap in a single transformation, I'll have to run the RM separately and replace the files generated from the OM and SM ditamaps. So, I'm hoping there's a more elegant solution.
Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
<oXygen/> XML Editor
http://www.oxygenxml.com
-
- Posts: 3
- Joined: Tue May 14, 2024 11:13 pm
Re: How to generate different headers in same transformation DITA to HTML5 output
Post by tech_writer800 »
Thanks for looking into this for us, Radhu. It is what I expected. I have found a workaround.
Return to “DITA (Editing and Publishing DITA Content)”
Jump to
- Oxygen XML Editor/Author/Developer
- ↳ Feature Request
- ↳ Common Problems
- ↳ DITA (Editing and Publishing DITA Content)
- ↳ SDK-API, Frameworks - Document Types
- ↳ DocBook
- ↳ TEI
- ↳ XHTML
- ↳ Other Issues
- Oxygen XML Web Author
- ↳ Feature Request
- ↳ Common Problems
- Oxygen Content Fusion
- ↳ Feature Request
- ↳ Common Problems
- Oxygen JSON Editor
- ↳ Feature Request
- ↳ Common Problems
- Oxygen PDF Chemistry
- ↳ Feature Request
- ↳ Common Problems
- Oxygen Feedback
- ↳ Feature Request
- ↳ Common Problems
- Oxygen XML WebHelp
- ↳ Feature Request
- ↳ Common Problems
- XML
- ↳ General XML Questions
- ↳ XSLT and FOP
- ↳ XML Schemas
- ↳ XQuery
- NVDL
- ↳ General NVDL Issues
- ↳ oNVDL Related Issues
- XML Services Market
- ↳ Offer a Service