Cross-references not appearing

This forum is for all Flare issues related to styles, stylesheets and XML.
Post Reply
joshua_cline
Propeller Head
Posts: 35
Joined: Mon Jun 25, 2018 8:45 am

Cross-references not appearing

Post by joshua_cline »

I am trying to figure out why the names of my cross-references are not appearing in the HTML5 output even though they are appearing in the topic editor - Layout (Web).

Here's what I have for the MadCap | xref style, which follows MadCap's online help.

MadCap|xref
{
color: #2D8DCC;
font-weight: bold;
mc-format: '{para}';
text-decoration: underline;
}
You do not have the required permissions to view the files attached to this post.
Nita Beck
Senior Propellus Maximus
Posts: 3667
Joined: Thu Feb 02, 2006 9:57 am
Location: Pittsford, NY

Re: Cross-references not appearing

Post by Nita Beck »

I don’t think this has anything to do with your stylesheet.

Check the first heading in the destination topic that that xrefs points to. I suspect it reads “Online Help”, not “Test”.

When Flare builds output, it automatically updates the human-readable text of all xrefs to match their destination topics’ first headings. But in source files, in the XML Editor, the human-readable text of an xref might be out of date, showing how the destination topic’s first heading read at the time the xref was first inserted. To update xrefs in a topic’s source file, open the topic in the XML Editor and then use the Tools > Update Cross-References command. That command works on a topic-by-topic basis, BTW, not project-wide.

HTH
Nita
Image
RETIRED, but still fond of all the Flare friends I've made. See you around now and then!
joshua_cline
Propeller Head
Posts: 35
Joined: Mon Jun 25, 2018 8:45 am

Re: Cross-references not appearing

Post by joshua_cline »

Thank you for your response. It is still referring to the wrong title even after updating the cross-references. Here's what I have in the text editor:

<?xml version="1.0" encoding="utf-8"?>
<html xmlns:MadCap="http://www.madcapsoftware.com/Schemas/MadCap.xsd">
<head>
</head>
<body>
<h1>Test Cross Reference</h1>
<p>
<MadCap:xref href="Test.htm">Test</MadCap:xref>
</p>
</body>
</html>

Thank you!
Nita Beck
Senior Propellus Maximus
Posts: 3667
Joined: Thu Feb 02, 2006 9:57 am
Location: Pittsford, NY

Re: Cross-references not appearing

Post by Nita Beck »

Humor me a little.

How does the destination topic's first heading read?
Nita
Image
RETIRED, but still fond of all the Flare friends I've made. See you around now and then!
joshua_cline
Propeller Head
Posts: 35
Joined: Mon Jun 25, 2018 8:45 am

Re: Cross-references not appearing

Post by joshua_cline »

<?xml version="1.0" encoding="utf-8"?>
<html xmlns:MadCap="http://www.madcapsoftware.com/Schemas/MadCap.xsd">
<head>
</head>
<body>
<h1>Test</h1>
<p>Delete this text and replace it with your own content.</p>
</body>
</html>
Nita Beck
Senior Propellus Maximus
Posts: 3667
Joined: Thu Feb 02, 2006 9:57 am
Location: Pittsford, NY

Re: Cross-references not appearing

Post by Nita Beck »

(Caveat: I'm not about to challenge your troubleshooting... I'm truly trying to help you, so I'm wracking my brain thinking of what might be the problem.)

Is the second example you posted from the Test.htm file?

Did you possibly make a COPY of the Test.htm file and put it in a different folder and edit that topic's h1, but not the original topic's h1? In other words, if you have two copies of the file, is the xref pointing to the right htm?
Nita
Image
RETIRED, but still fond of all the Flare friends I've made. See you around now and then!
joshua_cline
Propeller Head
Posts: 35
Joined: Mon Jun 25, 2018 8:45 am

Re: Cross-references not appearing

Post by joshua_cline »

Yea the second example is from the test.htm and the first is from Test Cross Reference.htm. I didn't make a copy and it is doing the same thing to other topics and cross-references in the project. Thanks for your help!
Nita Beck
Senior Propellus Maximus
Posts: 3667
Joined: Thu Feb 02, 2006 9:57 am
Location: Pittsford, NY

Re: Cross-references not appearing

Post by Nita Beck »

If I were you, my next step would be to throw this to MadCap tech support. Clearly the program isn't working correctly. :(
Nita
Image
RETIRED, but still fond of all the Flare friends I've made. See you around now and then!
joshua_cline
Propeller Head
Posts: 35
Joined: Mon Jun 25, 2018 8:45 am

Re: Cross-references not appearing

Post by joshua_cline »

Okay. Thank you for all your help.
Post Reply