9 Replies Latest reply on Apr 11, 2008 12:58 PM by Peter Grainge

    Topics become 'unlinked' from their template

      After generating webhelp, some topics (but not all of them) are no longer linked to their template.

      This is an intermittent problem.

      Using RH 5.0.2 to generate a 250+ topic Web Help file. On approximately 180 of these topics I have applied the same template (T1). The remaining topics use a different template (T2). At some point in time between ‘Generates’, some of the topics (approximately 15%) linked to T1 no longer display the template in the generated topic. For these affected topics, the properties sheet still shows the proper template is assigned but it’s not actually using it anymore. I may have accidentally ‘unlinked’ one or two topics from its template during the editing process, but not all of them. And definitely not on topics I haven’t touched since the original output was created in May 2006.

      To correct the problem I have to open the topic’s properties sheet (it shows T1 as the selected template), select None as a template, click Apply, then select the T1 template and Apply again.

      Any ideas?

      Additional details which may help:
      1 – This original project was created from scratch in RH5.
      2 - The template in question has a header (print this topic) and footer (copyright info and such). These are things that go missing. All other formatting details are fine.
      3 - There doesn't seem to be any pattern as to which topic is affected. Affected topics don't belong to the same folder, some are old, others new.
      4 - This is the second occurrence of this type on the same project. I have seen this problem on another one of our projects (WebHelp on RH5), but it was originally created on a version of RH going back to the eHelp days and it’s had so many authors, revisions and upgrades I don’t dare bring up any unique issues with it.

      Terry Belliveau
        • 1. Re: Topics become 'unlinked' from their template
          RoboColum(n) Level 5
          Hi Terry.
          I have come across this problem in RHX5 but not in my current role. My last role used to have occasional problems which meant me having to do exactly the same as you. I also never got to the bottom of when or why it was happening. I did report it to Adobe but I think it is one of those bugs that is almost impossible to solve. It is probably caused by a very specific set of circumstances. As I say it only ever happened with one set of help files I produced. It has nothing to do with Webhelp as I produced CHM files at the time.
          • 2. Re: Topics become 'unlinked' from their template
            HKabaker Level 2
            A possible explanation: When you batch-apply a template in RH 5 (and perhaps RH 6 and RH 7 as well) in a properties dialog for multiple topics, you should click "Apply" and close the dialog with the X box. Do not click OK. (RIck and I have exchanged views here. He understandably argues that OK should apply all changed settings and close the dialog. I agree that it should, but [sometimes] it does not.)

            Another angle: If you batch apply a template from the multi-topic Properties dialog, you should limit the number of topics selected. The number is not predictable. Unproven, but a strong hunch: If you tend to use short filenames, I think you'll be successful with more topics than if you tend to use long filenames.

            Here's a longshot:

            If you can fix this permanently as you described, fine. But it the problem persists in the same project, you might try removing the cpd file and regenerating it.

            • 3. Re: Topics become 'unlinked' from their template
              TtotheB Level 1
              Thank you Colum and Harvey for your replies.

              Specific to Harvey's reply, I can say that I had never batch-applied a template until yesterday - as a test. I selected all topics and applied the same 'troublesome' template. I'm quite confident I used Apply then OK but wouldn't swear to it in Court. It took a while to apply but the template did 'stick' to all topics.

              I have more edits to perform in the next few weeks. Now that I know I'm not imagining the problem, I'll be taking notes on the specific steps I use to edit my project. I now have a list of the previously affected topics so I'll be better able to watch for patterns.

              I'd like to leave this topic open for a while longer to see if any one else has any insights.

              • 4. Re: Topics become 'unlinked' from their template
                ^^&&^^ Level 1

                You are not alone. I've seen it too. I'd call it a bug.

                As far as I have been able to tell, it looks like the only work around is to go into the topic pod, select all and manually re-apply the template.

                PS: If you are (by any chance) using referenced Frame files, then you will have to do this each time you 'force update'.

                Hopefully someone 'official' can suggest a better approach to this issue.
                • 5. Re: Topics become 'unlinked' from their template
                  ElisaFnord Level 2
                  It's a bug, all right. But I thought it was related to RoboSource Control. I'm glad (in a sorry way) that other people have seen it, too.

                  We have had this problem in RHx5 and RH6, with RoboSource Control 2 and 3. As far as we can tell, there is no consistent cause - topics just lose their template connections. Yes, doing a batch Properties change with OK will do it, but sometimes it just happens.

                  It hasn't been a terrible burden, honestly. The hardest part is figuring out which topics have lost their templates. There's an option in the Topic Properties report to show the style sheet for each topic, and if there is no template, there is no style sheet - but with 2000+ topics in a project, that's not very workable.

                  And Harvey's right about the batch update in the Topics pod - click Apply, then click the red x to close the window. RH7 may be doing batch updates differently from RH6, but I say why take the risk?

                  • 6. Re: Topics become 'unlinked' from their template
                    lmarden Level 2
                    just as an additional thought to consider, when speaking of settings that don't hold - just today I was burned by a problem I have seen occasionally. Every once in a while, just infrequently enough to lull me into a sense of security, my conditional build expression poops out. I make no changes to it, and build after build after build is just fine, but then just when you don't pay attention, content that is supposed to be excluded from the build isn't. It doesn't happen often enough to be able to pin any reason down. But if you use tags, set up a quick test of your output to make sure they work!!!
                    • 7. Re: Topics become 'unlinked' from their template
                      TtotheB Level 1
                      Very interesting and WOW.

                      I wasn't very concerned if I lost my template headers and footer because they don't contain any mission critical details. But if the same is happening with Conditional Build Tags, that's a different matter. Can I trust my Index changes or any other topic property modifications?

                      Every piece of software has its flaws but at least you learn and work around them. I have no problem with that. But now my faith is shaken. Can I trust the output or do I have to review EVERY topic after I generate?

                      Would be nice if we heard from Adobe on this matter.

                      Thank you all for your input and comments,
                      • 8. Re: Topics become 'unlinked' from their template
                        lmarden Level 2
                        I wouldn't panic too much about the tags. It's good practice anyway to do some basic testing of a Help build before you release it. My bad for not doing so. From now on, I am going to rebuild the conditional expression each time I compile, then check one or two topics that contain the excluded tags on content to make sure that content is really hidden. It will take just a few extra minutes.
                        • 9. Re: Topics become 'unlinked' from their template
                          Peter Grainge Adobe Community Professional
                          I believe I may just have stumbled on the answer by applying a technique that was intended to fix a different issue.

                          Generate the CHM making sure its name EXACTLY matches the name of the project as in the XPJ file. So myproject.xpj, generate myproject.chm

                          Please report back successes / failures.