question-mark
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.

Topics with processing-role="resource-only" generate XHTML

See original GitHub issue

Reported to me by a user (not sure which OT version), but I replicated with 2.1.1. If a map has nothing but key definitions (that is, nothing but references with processing-role="resource-only"), XHTML output still generates result files for each of the topics. Resource-only topics should be available to the transform for whatever reason, but should not be generating output.

To reproduce: in hierarchy.ditamap, add processing-role="resource-only" to every <topicref>. Build to XHTML; all topics are still generated. PDF output fails, I assume because no real content goes in the PDF. I tested this test both with the original <topicref> (add @processing-role manually) and with <keydef> (pick up default @processing-role and add @keys).

If I set the first topic in the map to @processing-role="normal", but leave the others as resource-only, XHTML still generates all topics. PDF correctly includes only the one normal topic.

Sample set: 2077.zip

Issue Analytics

  • State:closed
  • Created 8 years ago
  • Comments:20 (18 by maintainers)

github_iconTop GitHub Comments

3reactions
drmacrocommented, Dec 9, 2016

I definitely agree with that: a resource-only topicref to a topic should never result in a resulting HTML file (or any direct reflection in any result of any type).

2reactions
robandercommented, Dec 9, 2016

I sort of fear this has gotten off track because you didn’t like my use case. The original report above is pretty straightforward, and is still (I think) the most important thing we can fix.

If I have this in my map, as my only reference to just-a-resource.dita: <topicref href="just-a-resource.dita" processing-role="resource-only"/>

That topic reference, when built to X/HTML, results in a generated file. It should not, because the document is marked resource-only.

I don’t think that any other stipulations / caveats are necessary.

Read more comments on GitHub >

github_iconTop Results From Across the Web

Topics findable even when processing-role="resource-only"
My issue: According to the OxygenXML help, when processing roles is set to "resource-only", the material is not included in navigation or search ......
Read more >
%topicref-atts-no-toc; - OASIS Open
Describes the target of a cross-reference and may generate cross-reference text based on that description. Only the <xref> element can link to content...
Read more >
RDFa in XHTML: Syntax and Processing - W3C
vocabulary being used. This document is a detailed syntax specification for RDFa, aimed at: those looking to create an RDFa parser, and who...
Read more >
DITA-OT error messages
Message ID Severity Message text DOTA013F Fatal Cannot find the specified DITAVAL ' %1 '. DOTJ012F Fatal Failed to parse the input file ' %1...
Read more >
Appendix C. Limitations and implementation specificities - XMLmind
The generated HTML file which contains the topic is called userguide.html . ... <topicref href="commonContent.dita" processing-role="resource-only"/> ...
Read more >

github_iconTop Related Medium Post

No results found

github_iconTop Related StackOverflow Question

No results found

github_iconTroubleshoot Live Code

Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free

github_iconTop Related Reddit Thread

No results found

github_iconTop Related Hackernoon Post

No results found

github_iconTop Related Tweet

No results found

github_iconTop Related Dev.to Post

No results found

github_iconTop Related Hashnode Post

No results found