3 Replies Latest reply on Sep 30, 2009 4:19 AM by Maya Sindhu

    Reuse topic content in several help files

    SSchwa Level 1

      Hi there,

       

      I'd like to build a sample help file that includes consistent content that would be used for each help file I build. For example, contact information, navigation information, etc. is the same for all the help files I build and needs to be included in each help file. Is there any easy way to build a help file with approximately 15 topics that I can use to start all my new help files, then add the unique topics that apply to the specific help file I'm building? I guess I'm just not sure how to cleanly do this. Would I build a help file with my consistent content, then when I create a new help file, import it into the new help file and rename it somehow, then started adding the unique topics? Hope this makes sense.

       

      I am working with RoboHelp HTML 8.

       

      Thanks! 

        • 1. Re: Reuse topic content in several help files
          Pete Lees Level 2

          Hi, SSchwa,

           

          If this is compiled HTML Help (.chm), the simplest solution would probably be to use run-time merging. That is, you store the common topics in a separate .chm file and place references to it in each of the other files. The result is that, when the user opens one of these files, the contents of the common .chm file appear automatically in its TOC, index, and search results. See:

           

          http://helpware.net/htmlhelp/how_to_merge.htm

          http://www.adobe.com/devnet/robohelp/articles/merged_help_06.html

           

          Pete

          • 2. Re: Reuse topic content in several help files
            SSchwa Level 1

            Thanks Pete. I had a look at the instructions in the link you provided, but it seems like there are a lot of steps needed to ensure all the links between the two help files are working. I found a suggestion to build the common chm file, then import these common topics into each new chm file I build. There's only about 10 common topics that I need to start each new help file with, so I'm going to try this suggestion and hopefully it works!

            • 3. Re: Reuse topic content in several help files
              Maya Sindhu

              Hi

               

              Try using the Snippet feature of Robohelp.

               

              From the Robohelp Help: You can use RoboHelp to add custom HTML code snippets to a project for insertion later into desired topics. When you modify a code snippet shared by different topics, the changes are reflected in all the associated topics.

              HTML code snippets are stored in a Snippet library as separate files with the .hts extension. The Snippet library provides thumbnail views of snippets in the Snippet pod. You can drag snippets to desired locations in a topic. You can also select one or multiple snippets and then copy, duplicate, or delete them.

               

               

               

              You can learn more about the Snippet feature through Robohelp help files.

               

              1 . Add a topic as a snippet

              1.     Select View > Pods > Project Manager.

              2.     Right-click a topic in the Project Files folder.

              3.     Select the Add to Snippet Library option.

              4.     Change the name and description of the snippet.

              5.     Click OK.

              2 . Import snippets

              HTML code snippets are stored as [filename].hts. Snippet files imported from other projects are copies of the originals, so modifications to the original files in the other project do not affect the imported files.

              1.     Do one of the following

              §                     Select File > Import > Snippet.

              §                     Select View > Pods > Snippet. The Snippet dialog box appears.

              Click Import Snippet. The Import Snippet dialog box appears.

              2.     Locate the desired project folder, and select a snippet file.

              3.   Click Open.

               

              HTH,

              Maya