Page 1 of 1

Missing chunked topic in webhelp

Posted: Thu Feb 27, 2025 11:03 pm
by kgajda
We have a topic that is only showing up as asterisks in the webhelp TOC. The missing topic is actually a parent concept topic with a chunked child task topic. The link in the TOC is correct, but the topic was not generated and does not appear in the output.
Through troubleshooting, we tested the child no longer being chunked and the parent topic does then render, but the child still does not and gets asterisks. We can't see anything wrong with the simple content in the child, nor in the simple content in the parent. Can anyone help?
DITA-OT errors thrown:
DOTX031E (file not available) as well as DOTX027W (unable to retrieve linktext) and DOTX023W (unable to retrieve navtitle), both for both topics
asterisks.png
The parent topic:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="prefill_c">
<title>Prefill</title>
<shortdesc>Use the <uicontrol>Prefill</uicontrol> satellite icon to designate a model part as
pre-filled adhiesive. </shortdesc>
<prolog>
<author></author>
<metadata>
<category>Model Setup</category>
<keywords translate="yes">
<indexterm>prefill</indexterm>
<keyword>nozzle system path setup set up prefill</keyword>
</keywords>
<prodinfo>
<prodname>
<keyword keyref="product_polyfoam"/>
</prodname>
</prodinfo>
</metadata>
</prolog>
<conbody>
<p>Location: <uicontrol>Dispensing</uicontrol> ribbon, <uicontrol>Nozzle</uicontrol> icon </p>
<image placement="break" href="../../../images/icons/polyfoam/icon_prefill_satellite.png"
id="image_j2j_fbj_j2c"/>
</conbody>
</concept>

The chunked child topic:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<task id="prefill_define_t">
<title>Designate Prefill Parts</title>
<shortdesc>Designate a model part as pre-dispensed adhesive. Define the part's material type and
initial temperature. </shortdesc>
<prolog>
<author></author>
<metadata>
<category>Model Setup</category>
<keywords translate="yes">
<indexterm>prefill</indexterm>
<keyword>define import prefill setup set up adhesive</keyword>
</keywords>
<prodinfo>
<prodname>
<keyword keyref="product_polyfoam"/>
</prodname>
</prodinfo>
</metadata>
</prolog>
<taskbody>
<context>
<p></p>
</context>
<steps>
<step>
<cmd>In the <uicontrol>Dispensing</uicontrol> ribbon, on the
<uicontrol>Prefill</uicontrol> icon, click the
<uicontrol>Prefill</uicontrol> satellite icon.<image placement="break"
href="../../../images/icons/polyfoam/icon_prefill_satellite_selected.png"
/></cmd>
</step>
</steps>
</taskbody>
</task>

The part of the submap that references these topics:
<topicref href="nozzle_system_c.dita">
<topicref href="nozzle_define_t.dita"/>
<topicref href="nozzle_import_t.dita"/>
<topicref href="prefill_c.dita" chunk="to-content">
<topicref href="prefill_define_t.dita" toc="no"/>
</topicref>
</topicref>

Re: Missing chunked topic in webhelp

Posted: Fri Feb 28, 2025 3:04 pm
by marius
Hello,

It appears that the issue you're encountering typically occurs when there are resources located outside the main DITA map folder. This is a known limitation of the DITA-OT. To address this, we recommend performing a "Validate and Check for Completeness" action. Please ensure the "Report references to resources outside of the DITA map folder" option is checked during this process.
If any errors or warnings are reported, it is necessary to address these accordingly.

Regards,
Marius