Skip to main content
mdawn0817
Inspiring
August 27, 2018
Answered

Another Baggage File Question

  • August 27, 2018
  • 2 replies
  • 1443 views

How do I include Baggage Files in the online help output? Does it have to be included in a topic?

Thanks,

MDawn

This topic has been closed for replies.
Correct answer Amebr

For Printed Doc (which this question is posted in, for completeness), I think the baggage files are just copied into the same directory, or possibly sub-directories based on your folder setup (?), that the printed doc is generated to. However it's been a long time since I did printed doc in in any meaningful way, so I could be mis-remembering or it could have changed.

For online, the baggage files are copied into the output as part of generation. But a few things to keep an eye on.

There's a setting in the SSL/Output settings to prevent unreferenced baggage files showing in search. (That is, not linked to from a topic or the toc or index.) You'll need to decide if you need to clear that setting in your situation.

There's another setting in the Search settings that prevents baggage files of certain types from showing in search. I don't think any are configured by default, but you might need to double-check your output settings.

You may want to ensure each baggage file is linked to from relevant topics, or include them in the table of contents. I seem to remember some file types don't play nice sometimes, but I can't remember the  details. Peter's site might include that information

2 replies

Peter Grainge
Community Expert
August 28, 2018

I'm completely confused by this thread. Baggage files are for online help only which is what the poster specified but then posted in the Printed Documentation forum where there is no concept of baggage files.

We need MDawn to explain the issue.


See www.grainge.org for free RoboHelp and Authoring information.

@petergrainge

Help others by clicking Correct Answer if the question is answered. Found the answer elsewhere? Share it here. "Upvote" is for useful posts.
Ioana_St
Inspiring
August 28, 2018

I guess that MDawn is generating Printed Documentation and wants to include that in a WebHelp/Responsive etc output. I honestly tested the "baggage file in printed doc" scenario because it never occurred to me to wonder what happens to the baggage files in this scenario.

Peter Grainge
Community Expert
August 28, 2018

Could be in which case it is just another baggage file. If that is the question, then if you don't add a link from somewhere then search would be the only way to find them. Amber's post covers what you need to watch for there.


See www.grainge.org for free RoboHelp and Authoring information.

@petergrainge

Help others by clicking Correct Answer if the question is answered. Found the answer elsewhere? Share it here. "Upvote" is for useful posts.
AmebrCorrect answer
Community Expert
August 28, 2018

For Printed Doc (which this question is posted in, for completeness), I think the baggage files are just copied into the same directory, or possibly sub-directories based on your folder setup (?), that the printed doc is generated to. However it's been a long time since I did printed doc in in any meaningful way, so I could be mis-remembering or it could have changed.

For online, the baggage files are copied into the output as part of generation. But a few things to keep an eye on.

There's a setting in the SSL/Output settings to prevent unreferenced baggage files showing in search. (That is, not linked to from a topic or the toc or index.) You'll need to decide if you need to clear that setting in your situation.

There's another setting in the Search settings that prevents baggage files of certain types from showing in search. I don't think any are configured by default, but you might need to double-check your output settings.

You may want to ensure each baggage file is linked to from relevant topics, or include them in the table of contents. I seem to remember some file types don't play nice sometimes, but I can't remember the  details. Peter's site might include that information

Ioana_St
Inspiring
August 28, 2018

I justed tested the Printed Doc scenario in RH 2017. The baggage file is not copied over anywhere, the link in the output references the location of the file in the source folder.

Details:

  • My source files are at (e.g.) C:\projects\myproject.
  • In one topic, I embedded a link to the baggage file bag1.pdf. The link looks something like this; <p><a href="bag1.pdf">Baggage File</a></p>.
  • I generated the Word output in C:\Users\ioana\Desktop\.
  • In the Word document, the link points to C:\projects\myproject\bag1.pdf.