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;
}
Cross-references not appearing
-
- Propeller Head
- Posts: 35
- Joined: Mon Jun 25, 2018 8:45 am
Cross-references not appearing
You do not have the required permissions to view the files attached to this post.
-
- Senior Propellus Maximus
- Posts: 3669
- Joined: Thu Feb 02, 2006 9:57 am
- Location: Pittsford, NY
Re: Cross-references not appearing
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
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
RETIRED, but still fond of all the Flare friends I've made. See you around now and then!
RETIRED, but still fond of all the Flare friends I've made. See you around now and then!
-
- Propeller Head
- Posts: 35
- Joined: Mon Jun 25, 2018 8:45 am
Re: Cross-references not appearing
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!
<?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!
-
- Senior Propellus Maximus
- Posts: 3669
- Joined: Thu Feb 02, 2006 9:57 am
- Location: Pittsford, NY
Re: Cross-references not appearing
Humor me a little.
How does the destination topic's first heading read?
How does the destination topic's first heading read?
Nita
RETIRED, but still fond of all the Flare friends I've made. See you around now and then!
RETIRED, but still fond of all the Flare friends I've made. See you around now and then!
-
- Propeller Head
- Posts: 35
- Joined: Mon Jun 25, 2018 8:45 am
Re: Cross-references not appearing
<?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>
<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>
-
- Senior Propellus Maximus
- Posts: 3669
- Joined: Thu Feb 02, 2006 9:57 am
- Location: Pittsford, NY
Re: Cross-references not appearing
(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?
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
RETIRED, but still fond of all the Flare friends I've made. See you around now and then!
RETIRED, but still fond of all the Flare friends I've made. See you around now and then!
-
- Propeller Head
- Posts: 35
- Joined: Mon Jun 25, 2018 8:45 am
Re: Cross-references not appearing
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!
-
- Senior Propellus Maximus
- Posts: 3669
- Joined: Thu Feb 02, 2006 9:57 am
- Location: Pittsford, NY
Re: Cross-references not appearing
If I were you, my next step would be to throw this to MadCap tech support. Clearly the program isn't working correctly.
Nita
RETIRED, but still fond of all the Flare friends I've made. See you around now and then!
RETIRED, but still fond of all the Flare friends I've made. See you around now and then!
-
- Propeller Head
- Posts: 35
- Joined: Mon Jun 25, 2018 8:45 am
Re: Cross-references not appearing
Okay. Thank you for all your help.