• State Suggested Answer
  • Replies 3 replies
  • Answers 1 answer
  • Subscribers 47 subscribers
  • Views 2302 views
  • Users 0 members are here
Options
Related

xref'ed content not added to resource folder in publication manager

Akheil Jain

I am looking for documentation or a solution to see if xref'ed topic get added to a publication if the source/containing topic is added? Thank you for any help in advance.
Rate translation
×
Suggest better translation
×
  • 0
    Hey Akheil

    When you add a topic to a map in Publication Manager and that topic contains an xref that cannot be resolved within the publication, an error message pops up to alert you. Also when you preview such topic, you will see a message stating that the link could not be resolved.

    If this goes by unnoticed, you will always get a warning during publishing indicating that the hyperlink could not be resolved. The error message contains the GUID of the link so it's easy to search for it and add it. In any case, you will never be able to release your publication or the publication output.

    If the hyperlink is not part of the TOC (map), you can indeed add it explicitly as a resource to the publication. That will ensure that the preview in Publication Manager can resolve the hyperlink text. And at publishing time, the warning about the broken link will also be gone. But if the topic is not part of the TOC and you publish to a PDF with a hyperlink, the landing point will obviously not exist in the PDF. In case of HTML, you will be able to get to it. Though for the user it may be confusing as they cannot reach that landing point through the TOC.

    If you consider the link to be ‘external’ to the publication, you could also set the scope attribute to “external”. In such case, KC will ignore the link and not try to resolve it. And you would have to enter the hyperlink text yourself as there is nothing that can be resolved.

    Not sure if the above helps or what the specific use case for your question is...

    Best regards,
    Kurt
  • 0 in reply to Kurt Van Deun
    Hi Kurt,
    Thank you for your response, our use case it a user creating a publication in publication manager which has xref's and trying to publish to Collaborative Review, it fails if the xrefed topics are not manually included in the Resource folder of the publication. We hadn't run into this issue with LiveContent, before we upgraded to Knowledge Center 2016 SP1. The previous version of Pub Manger used to automatically pull in the xref'ed topics into the publication. Is this a functionality/Configuration change? It is very tedious, to manually pull in all the xref'ed topics into a publication. The only way I can think of would be to search for them individually and add them.
  • 0 in reply to Akheil Jain
    Hey Akheil

    This may have been past behavior but that’s not the case anymore: I will check with engineering for the exact background when I get back to the office.

    But I can understand why it’s not the case: if this would be added automatically to the baseline and a version would be automatically selected, it would result in a ‘valid’ link. Even though there would be no landing point. In other words, one could publish to PDF, get a release candidate, but the hyperlink would not land anywhere.

    Best Regards,
    Kurt