Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

Append HTML content

See original GitHub issue

Description

I would like to append/embed the content of one HTML file to my PDF or HTML. Is this posible through DITA-OT?

I am using this link as a reference: https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/Artefact/Maps/c_Non-DITA_Topic_References.html

But I am unable to make it work.

I have tried with below ditamap, but even when scope=local, the content of the HTML is not appended.

...
    <appendix navtitle="Report">
      <topicref format="html" href="content.html" locktitle="yes" navtitle="Report" scope="peer"/>
    </appendix>
    <backmatter>
....

Environment: MacOs DITA-OT 3.3

Thank you!

Issue Analytics

State:
Created 4 years ago
Comments:6 (2 by maintainers)

Top GitHub Comments

1reaction

raducoravucommented, Jul 10, 2019

@cinthyargc thanks for documenting your experience with this. I added a documentation task so that maybe the docs could explain better the limitations of the conversion.

0reactions

cinthyargccommented, Jul 9, 2019

Hi Radu,

I just wanted to share, that I updated to latest version of DITA-OT, and I am now able to add html content into my HTML and PDF, I was missing the fix for #2947.

Important Note: I had to re-formart my HTML, to match HTML 5, and use article tags, otherwise, HTML body was not being added to PDF or HTML.

To anyone reaching this point, use HTML 5 tags and DITA-OT >= 3.3.2. Below a sample code:

<!DOCTYPE html>
<html>
  <head>
    <title>Report Viewer</title>
  </head>
  <body>
    <article>
      <h1>Placement Report</h1>
      <p>Report will be placed here</p>
    </article>
  </body>
</html>