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.

xref in <shortdesc> won't allways work

See original GitHub issue

When using an xref in a shortdesc 1.8 complains when the map and associated concepts are in a subdirectory. Moving them into a single directory will work.

– documentation.ditamap –

<?xml version="1.0"?>
<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "../../map.dtd">
<map title="Bug" id="com.service2media.m2active.trunk">
  <topicref href="concepts_chapter.dita">
    <mapref href="refdoc/concepts.ditamap"/>
  </topicref>
</map>

– refdoc/concepts.ditamap –

<?xml version="1.0"?>
<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "../../map.dtd">
<map title="concepts">
  <topicref href="concept_a.dita"/>
  <topicref href="concept_b.dita"/>
</map>

– refdoc/concept_a.dita –

<?xml version="1.0"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "../../concept.dtd">
<concept id="concept_A" xml:lang="en-us">
  <title>A</title>
  <shortdesc>
    <ph><xref href="concept_b.dita">B</xref></ph>
  </shortdesc>
  <conbody>
    <section>
    <ph><xref href="concept_b.dita">B</xref></ph>
    </section>
  </conbody>
</concept>

– refdoc/concept_B.dita –

<?xml version="1.0"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "../../concept.dtd">
<concept id="concept_B" xml:lang="en-us">
  <title>B</title>
  <shortdesc> </shortdesc>
</concept>

Issue Analytics

State:
Created 10 years ago
Reactions:2
Comments:7 (6 by maintainers)

Top GitHub Comments

2reactions

raducoravucommented, May 23, 2016

👍 for us, we hit the same problem trying to resolve abbreviated forms in topic titles when building the TOC.

0reactions

jelovirtcommented, Jun 23, 2016

A customer got hit by this.

Top Results From Across the Web

Unable to bind an XREF in AutoCAD Products

It is not possible to bind an XREF within an AutoCAD drawing. The following error may appear at the AutoCAD command line:.

Xrefs are Missing or Not Loading When You Open Your Drawing

It is recommended you open and resave the Xref file to remove excess scales. Causes. Missing Xrefs can have several possible causes, including:....

Xref in AutoCAD: What Is It & How Do I Use One? - All3DP

With an xref, AutoCAD allows you to reference another drawing in your ... The xref feature works as a sort of overlay on...

Stop Guessing About What Changed In Your Xrefs ... - ATG USA

Younger generations won't understand that reference, or the struggle we went through before technology caught up. Thankfully in the latest installment of ...

Working with XREF: Controlling Appearance - CADnotes

Usually, we only clip the drawing and change the layer properties. However, if you are the reference file owner, you might need to...