X5 Baggage Bug

When you create a reference to a file other than a topic, for example a javascript file, RoboHelp should add it automatically to the baggage files. If you look under Baggage Files, you should see all the folders in your project and those that contain baggage files will have a + sign next to them. The bug may cause that process to fail.

The first thing to try is manually adding the file, noting that you must add it to the folder that contains the baggage file. For example, if the file demo.js is in a folder called demo_folder, you must right click on demo_folder and then select New Baggage File. If you select the root or any other folder you will be able to add the file but when RoboHelp comes to upload the file, it won't be there and the process will fail. That said, in most cases where RoboHelp has failed to automatically add the file, it won't let you add it in this way either! So roll up your sleeves and read on.

TIP: If you regularly encounter this problem when adding javascript references, add the javascript file to baggage manually before you create the reference. It's quicker, trust me.

Method 1

In X5, in addition to the usual way of adding baggage files, you can edit the rhbag.apj file. With the project closed, open the file in a text editor such as Notepad and copy / paste an existing section. Replace the name of the baggage file with the one you are trying to import. It will appear in the baggage when you reopen the project.

In my opinion this method which was posted by Jenny Chan is quicker and easier than Method 2.

Method 2

1. Change the name of the js file where it is referred to in the topic from say terminology.js to terminology1.js. This is temporary.
2. Close and reopen the project.
3. Add the file to the baggage in RH with the required name, terminology.js in this example.
4. Now amend the topic so that the reference to the file uses the correct file name, that is change it back from terminology1.js to terminology.js.