37 Replies Latest reply on May 22, 2012 2:11 PM by Jeff_Coatsworth

    Compile Error (RoboHelp 8)

    robm44

      I am compiling webhelp uing RoboHelp 8 and although the result looks fine and works ok, i keep getting the following error in the output view.

       

      Applying WebHelp 5.50 Template...
      ........................Template Error: can not resolve macro: WH_LNG_FtsMaxResult
      ...........................................................................

       

      As i said there is nothing wrong with the compiled output (as far as i can see) but am just wary of what this error is as i only recently upgraded to version 8, form version 5, and have had a host of problems since doing it!

        • 1. Re: Compile Error (RoboHelp 8)
          RoboColum(n) Level 5

          See if this thread solves the problem.

           


          Read the RoboColum(n) for mutterings on RoboHelp, Technical Communication Suite and technical communication.

          • 2. Re: Compile Error (RoboHelp 8)
            robm44 Level 1

            Thanks for the advice. I created another project and generated the webehlp in this as suggested in the other post. There were no errors when i did this. Does this mean it is something wrong with the template i am using? If so how do i sort this issue out? I did try the solution that the other person used (downloading RoboScriptReg.exe, and then running it from the installation folder) but this didn't solve the problem. Am a bit stuck about what to do next as i don't exactly know how to generate a new template and use that instead.

            • 3. Re: Compile Error (RoboHelp 8)
              RoboHobo Level 1

              Hi - just chiming in to say you are not alone. We are upgrading projects from RH7 and seeing an identical error when generating WebHelp Pro on about 20% of our projects. I am only guessing that this is related to full text search ('fts' in macro name). I will come back to log it if we find a solution, but so far we have no idea.

              • 4. Re: Compile Error (RoboHelp 8)
                RoboColum(n) Level 5

                Just thinking out loud here...

                Where do these macros come from? Are the referenced anywhere inside you source files? Would the source be imported from a word document or converted from a WinHelp project? If so, what do these macros do?

                 


                Read the RoboColum(n) for mutterings on RoboHelp, Technical Communication Suite and technical communication.

                • 5. Re: Compile Error (RoboHelp 8)
                  robm44 Level 1

                  Unfortunately i have very little experience of macros in terms of what they even do and how to use them, let alone how they work with RoboHelp. So I'm sorry in advance if the answers i give are a little obvious...anyway here you go

                   

                  1.Where do these macros come from?

                  I honestly do not know, i have never had a problem like this before in RoboHelp as I noted in my first post.

                   

                  2.Are the referenced anywhere inside you source files?

                  I have done a full text search for the error, including using parts of the error name, in my source files and found no results

                   

                  3.Would the source be imported from a word document or converted from a WinHelp project?

                  All my project topics are created in RoboHelp using the HTML editor and I have never imported a word document while working on this project (around a year). And regarding Winhelp, the project has only ever been a Webhelp project that was upgraded from version X5 to Version 8.

                   

                  Sorry if none of this is useful but that's all i know at this stage.

                   

                  Any other ideas?

                  • 6. Re: Compile Error (RoboHelp 8)
                    Gravenstein Level 2

                    Is the file robohhre.lng present in your root-level project folder? If so, open your pss file in Notepad and check whether the path to robohhre.lng is correct.

                     

                    G

                    • 7. Re: Compile Error (RoboHelp 8)
                      robm44 Level 1

                      Yes the robohhre.lng file is present in the ropot folder. And the path in the .pss file is correct.

                       

                      One strange thing that i never saw in RoboHelp X5 when i used it is that the robohhre.lng file is also in my baggage files? Not sure if this may be casuing the problem. Also investigating further i can find the proprty FtsMaxResult in this file. Could i do something to this in the file to try and resolve the problem?

                      • 8. Re: Compile Error (RoboHelp 8)
                        mgriebel

                        I just upgraded from RH6 to RH8 and I have the exact same error: Applying WebHelp 5.50 Template...
                        ........................Template Error: can not resolve macro: WH_LNG_FtsMaxResult
                        ...........................................................................

                         

                        And I have been investigating this for a few days now and have found no thing. Do I need to recreate my template? My machine is running very slow and my templates don't seem to be working anymore. Help!

                        • 10. Re: Compile Error (RoboHelp 8)
                          mgriebel Level 1

                          Thanks Rick~

                           

                          I was able to fix it my issue by generating a new project and I saw the default.css and the RHStyleMapping.css that I had deleted weeks ago from my project. So I imported both the default.css and the RHStyleMapping.css back into my project. (I also have my own style sheet: Save HTC Style Sheet.CSS) I don't know if this had any bearing on the fix but I did it anyways. Then I took the new project Robohhre.lng file and overwritten my old Robohhre.Ing into my existing project and then generated the project.And no macro error:

                           

                          Finished processing Full-Text-Search data in 226 sec(s)

                          Applying WebHelp 5.50 Template...
                          .......................................................................................... .........
                          Finished applying Template in 23 sec(s)

                          Finished compiling WebHelp in 416 sec(s)

                          Compilation complete.

                           

                          Thank-you,

                          Michelle

                          • 11. Re: Compile Error (RoboHelp 8)
                            RoboHobo Level 1

                            Hi -

                             

                            We were able to make this issue go away by adding the following element definition to the "WebHelp" section of the RoboHHRE.lng file in the project's source directory.

                             

                            <element name="FtsMaxResult" value="Search results per page" />

                             

                            This edit 'fixed' all of our projects that displayed the "macro" error during compilation following upgrade from RH7 to RH8 (which is ongoing, I have to add).

                             

                            Interestingly (or maybe not), FtsMaxResult isn't defined in the RH7 version of the .lng file in any of our projects. It's apparently introduced in the conversion to XML during the upgrade to 8. The rest of our upgraded WebHelp Pro projects (and any new project) contained this definition, and there were no compile errors.

                             

                            I think the last poster may have fixed the problem indirectly by copying in the .lng file from a fresh project, and not by copying CSS files, though there was a clue there. Hopefully, this is a lasting repair and saves others some time.

                             

                            (Unfortunately, this may not fix the original poster's issue as you seemed to suggest in your last post that this definition exists in your .lng file.)

                             

                            RH

                            • 12. Re: Compile Error (RoboHelp 8)
                              Captiv8r Adobe Community Professional & MVP

                              Hi there and thanks for the info!

                               

                              As an aside, several versions back there was another issue surrounding the lng file. It seemed that up to a certain version, the lng file wasn't created as a matter of creating a project. Instead, it was created on the fly at the moment one elected to change one of the elements inside. Later versions created a lng when the project was created. So what we saw was that if a project was created in the earlier version and no lng had ever been created, then the project was upgraded, any attempts to change the lng would be discarded as there was no lng to edit. Oddly, no error messages ensued, the only clue was that your changes never survived editing.

                               

                              Cheers... Rick

                               

                               

                              Helpful and Handy Links

                              RoboHelp Wish Form/Bug Reporting Form

                              Begin learning RoboHelp HTML 7 or 8 within the day - $24.95!

                              Adobe Certified RoboHelp HTML Training

                              SorcerStone Blog

                              RoboHelp eBooks

                              • 13. Re: Compile Error (RoboHelp 8)
                                rwrich21 Level 1

                                I am having the same problem but I am not as familiar as most of you about updating the inner code.

                                 

                                Do I paste everything below in as is?

                                                    <element name="FtsMaxResult" value="Search results per page" />

                                 

                                What is "element name and does "element name" need to be replaced?

                                 

                                Does it matter where I paste this code in RoboHHRE.lng?

                                               <element name="FtsMaxResult" value="Search results per page" />

                                • 14. Re: Compile Error (RoboHelp 8)
                                  RoboHobo Level 1

                                  Hi - yes, copy the line exactly as is and paste it in the file. I inserted it about a third of the way down the file, no need to be too fussy.

                                   

                                  It's just an element definition containing a name/value pair.

                                   

                                  RH

                                  • 15. Re: Compile Error (RoboHelp 8)
                                    lakehur

                                    I upgraded this morning and I'm experiencing the same template error when generating files. When I go into the .lng file I can view the code, but can't figure out how to add the new code string you suggested. I've clicked Edit, but only have the option to edit an existing string. How do I add the new code string you suggested?

                                     

                                    Thanks.

                                    • 16. Re: Compile Error (RoboHelp 8)
                                      rwrich21 Level 1

                                      What did you open the .lng file up with?

                                      Since you can not copy the new code in, can you type it in?

                                      • 17. Re: Compile Error (RoboHelp 8)
                                        lakehur Level 1

                                        From my project files, I right clicked the file name, highlighted the first bit of code, and selected Edit. It allows me to edit existing code, but I can't figure out how to add the additional code string you suggested.

                                        • 18. Re: Compile Error (RoboHelp 8)
                                          lakehur Level 1

                                          I opened .lng in Notebook, pasted the code <element name="FtsMaxResult" value="Search results per page" />, and regenerated the WebHelp file, but continue to receive the error. Thoughts?

                                          • 19. Re: Compile Error (RoboHelp 8)
                                            mgriebel Level 1

                                            Try this: Save and close your existing project and generate a new project. Copy the new project Robohhre.lng file and overwrite the old Robohhre.Ing into your existing project then generate your existing project. No macro error?

                                            • 20. Re: Compile Error (RoboHelp 8)
                                              lakehur Level 1

                                              With or without the recommended code string I copied into the .lng file?

                                               

                                              Thanks.

                                              • 21. Re: Compile Error (RoboHelp 8)
                                                mgriebel Level 1

                                                The recommended code would already be in the newly generated version of the .lng file. Copy/paste into your existing project.

                                                • 22. Re: Compile Error (RoboHelp 8)
                                                  lakehur Level 1

                                                  Still receiving the error after:

                                                   

                                                  1. Copying my files.

                                                  2. Generating WebHelp from the new files.

                                                  3. Copying RoboHTTRE.lng from the new files after regenerating.

                                                  4. Pasting the new RoboHTTRE.lng into the old files.

                                                  5. Regenerating WebHelp.

                                                   

                                                  I've noticed another issue following two files are missing in my file structure:

                                                  bsscaht.1.js

                                                  bsscahtl2.js

                                                   

                                                  What are they? Could the fact they're missing be contributing to the problem?

                                                   

                                                  I appreciate you help, thanks.

                                                  • 23. Re: Compile Error (RoboHelp 8)
                                                    mgriebel Level 1

                                                    The only thing I didn't do was "1. Copying my files."  I just created a new project and generated it with nothing in it. And I copied the .lng file into my existing project and it fixed it. I don't know what bsscaht.1.js and bsscahtl2.js. Maybe some javascript files or something.

                                                    • 24. Re: Compile Error (RoboHelp 8)
                                                      Tim M Level 1

                                                      I had the exact error described above (Applying WebHelp 5.5 Template, Template Error: Can not resolve macro: WH_LNG_FtsMaxResult).  I tried the solution of pasting the exact element line listed in an earlier post into my robohhre.lng file and this solution did not fix the error (as others have noted).  I noticed that my robohhre.lng file was not in xml format as the element line was.  I added "FtsMaxResult=Search results per page" to the robohhre.lng file immediately below the "FtsBtnText=Go" line (and again, it probably doesn't matter where it goes in the file, but it seemed to make sense to me to put it in the [WebHelp] section under another full text search item).  This change resolved my problem.  I am now able to compile the project without error, and I did not have to do any of the other things listed above.

                                                      • 25. Re: Compile Error (RoboHelp 8)
                                                        EileenPalsson Level 1

                                                        I appreciated finding answers to this problem on the forum. Thanks, people!

                                                         

                                                        For me, Tim M's solution, with minor variations, solved the problem. This is what I did:

                                                         

                                                        1. Close the project. (It won't work if you try to make this change without closing and reopening the project.)
                                                        2. Using Notepad or other text editor, open RoboHHRE.lng.
                                                        3. In the [WebHelp] section, add this line (since my LNG file was in text format):
                                                             WH_LNG_FtsMaxResult=Search results per page
                                                        4. Save and close the LNG file.
                                                        5. Reopen the project and compile.
                                                        • 26. Re: Compile Error (RoboHelp 8)
                                                          kmaddox1 Level 1

                                                          Great to find all this information in one place. Editing the RoboHHRE.lng file didn't work for me, but this is what I discovered--maybe this will help someone else:

                                                           

                                                          Each of  my projects (which were all migrated from Robohelp 7 to 8) contained two RoboHHRE.lng files:

                                                           

                                                          one in the root folder

                                                          one in the !Language! >en_US folder

                                                           

                                                          In some cases (corresponding to the projects that returned the error), the two files were different. The file in the en_US folder was newer (date corresponded to when I converted to RH8) and written in XML (that is, the file started with: <?xml version="1.0" encoding="utf-8"?><configuration><section name="WebHelp"><element name="SyncTocTooltip" value="Sync TOC" />). In projects returning the macro error, the file in the root folder was older (date corresponded to when I created it in RH7) and in plain text (the file started with [GlossaryTab]TabCaption=&GlossaryTermCaption=&TermDefinitionCaption=&Definition For:).

                                                           

                                                          To resolve the WH_LNG macro error, I copied the newer XML file over the old (plain text) file, reopened the project, and recompiled it (tho it's probably better practice to rename the old  RoboHHRE.lng file instead of simply overwriting it...).

                                                          • 27. Re: Compile Error (RoboHelp 8)
                                                            JBlochowiak

                                                            Thank you all! Your suggestions helped me fix the same problem I was having. I've printed out this threaded conversation and put it in my RoboHelp folder for when this happens on my next converted project. You all saved me hours and hours of confusion.

                                                            ~Jennifer

                                                            • 28. Re: Compile Error (RoboHelp 8)
                                                              zappy0

                                                              Perhaps not appropriate to post thank you notes on a forum, but I am

                                                              so happy to have found a solution to this issue. RoboHobo, you are a genius for figuring out the missing line in the XML. I waited a year before upgrading to 8.0 with the hope that all these weird issues would have been solved, and so far I'm not disappointed. Thanks!!!

                                                              • 29. Re: Compile Error (RoboHelp 8)
                                                                peter braham

                                                                I fixed the problem by going to project settings and changing the language.

                                                                This generates a new .lng file

                                                                 

                                                                Peter

                                                                • 30. Re: Compile Error (RoboHelp 8)
                                                                  FirstScript

                                                                  I faced a similar issue today Our organization decided to migrate from RH7 to RH9, and for most of the projects I tested the WebHelp output compiled just fine. However, for some, post-conversion, every time I tried generating the WebHelp output I received a long list of messages all proclaiming "Template Error:Cannot resolve macro:<macro name> in <location of whtbar.js file in the output folder>, and a pretty long intimidating list of errors that was.

                                                                   

                                                                  None of the solutions provided on any of the related threads helped me solve the problem I was facing, but it did convince me that it was definitely a problem with the LNG file. The only thing that worked for me was to close the project, delete the !language! folder, reopen the project, and generate the WebHelp.

                                                                   

                                                                  Hope this helps anyone who faces the same issue as I did.

                                                                  • 31. Re: Compile Error (RoboHelp 8)
                                                                    SGRoeh Level 1

                                                                    I received a string of macro error messages all related to the Web Help files after I converted over from RH7 to RH9.

                                                                     

                                                                    A small section of the error msgs:

                                                                     

                                                                    Applying WebHelp 5.50 Template...

                                                                    Template Error: can not resolve macro: WH_LNG_LoadingData

                                                                    ....Template Error: can not resolve macro: WH_LNG_MergeError1

                                                                    Template Error: can not resolve macro: WH_LNG_MergeError2

                                                                    Template Error: can not resolve macro: WH_LNG_JS_alert_ProjectLoadingFail

                                                                    ..Template Error: can not resolve macro: WH_LNG_PreTooltip in C:\HG\PCDmisQA\Pcdlrn\Help\Planner\!SSL!\Webhelp\whtopic.js

                                                                    Template Error: can not resolve macro: WH_LNG_NextTooltip in C:\HG\PCDmisQA\Pcdlrn\Help\Planner\!SSL!\Webhelp\whtopic.js

                                                                    Template Error: can not resolve macro: WH_LNG_Show_Navigation_Component in C:\HG\PCDmisQA\Pcdlrn\Help\Planner\!SSL!\Webhelp\whtopic.js

                                                                     

                                                                    How I resolved it was to check the Republish All check box in the Publish tab (which I don't normally have checked).

                                                                     

                                                                    Once I did this and then republished my project I had no errors.

                                                                     

                                                                    I hope this is of some help.

                                                                    • 32. Re: Compile Error (RoboHelp 8)
                                                                      Captiv8r Adobe Community Professional & MVP

                                                                      Welcome to our community, Steve

                                                                       

                                                                      Sorry, but I'm going to remain skeptical on this and consider what you pointed out to be a red herring.

                                                                       

                                                                      Here's why:

                                                                       

                                                                      The Template Error messages you cite should be stemming from the Generation process. This is the process that occurs when RoboHelp is creating the output files. One by one each file is read into memory from the source location and script is added to the topics. After modification, copies of the topics are placed in the output location. RoboHelp is also configuring things like the skin and other settings during this process.

                                                                       

                                                                      The option you pointed out "Republish All" should have zero effect at this point. This is because that option is related to the Publishing process. Think of Generating as being like mixing a bowl full of cookie dough, dropping the dough balls onto the cookie sheet and baking the cookies. Think of Publishing as moving (copying) the cookies from the cookie sheet into the cookie jar.

                                                                       

                                                                      I'm thinking there has to be some other issue that perhaps resolved on its own or that resolved as a result of a change you made and didn't realize it.

                                                                       

                                                                      Cheers... Rick

                                                                       

                                                                      Helpful and Handy Links

                                                                      RoboHelp Wish Form/Bug Reporting Form

                                                                      Begin learning RoboHelp HTML 7, 8 or 9 within the day!

                                                                      Adobe Certified RoboHelp HTML Training

                                                                      SorcerStone Blog

                                                                      RoboHelp eBooks

                                                                      • 33. Re: Compile Error (RoboHelp 8)
                                                                        Peter Grainge Adobe Community Professional

                                                                        I think I saw something like that when testing RoboHelp 9 but that it only occurred on upgrade, maybe I had to delete the CPD after upgrade as well. Pretty sure it did just go away.

                                                                         


                                                                        See www.grainge.org for RoboHelp and Authoring tips

                                                                         

                                                                        @petergrainge

                                                                        • 34. Re: Compile Error (RoboHelp 8)
                                                                          mgriebel Level 1

                                                                          I was able to fix macro issues by generating a new project in RH8 and assigning my .css to a new topic then copying the new Robohhre.lng file into my existing Robohelp 8 project. Then I sent the new Robohhre.lng file to a user on RoboHelp 9 of 'our' 'help file project to copy/paste into the root folder of the our project. (Yes, we will be upgrading to RH 9 soon.) We just have one macro error left to resolve:

                                                                           

                                                                          Template Error: can not resolve macro: WH_LNG_ContentCategoryList

                                                                           

                                                                          Does the user on RH9 need to generate a new project on RH9 to fix this template error above?

                                                                          • 35. Re: Compile Error (RoboHelp 8)
                                                                            Jeff_Coatsworth Adobe Community Professional & MVP

                                                                            The RH 9 user should do the same thing you did in RH8 to create a customized .lng file

                                                                            • 36. Re: Compile Error (RoboHelp 8)
                                                                              Peter Grainge Adobe Community Professional

                                                                              If you delete the LNG files from a closed project using Windows Explorer, RoboHelp will create a new one when you reopen the project. No need to copy the file between projects.

                                                                               

                                                                              I haven't read back through the thread but that seems to be the solution based on the last couple of posts.

                                                                               


                                                                              See www.grainge.org for RoboHelp and Authoring tips

                                                                               

                                                                              @petergrainge

                                                                              • 37. Re: Compile Error (RoboHelp 8)
                                                                                Jeff_Coatsworth Adobe Community Professional & MVP

                                                                                I think they’re doing it to preserve some customized wording that they’ve modified in the .lng file. The danger is that those customized versions don’t get upgraded when versions of RH change – so you have to “reinvent the wheel” to get your wording back in there.