7 Replies Latest reply: Jul 23, 2012 9:29 AM by Peter Grainge RSS

    "Lng" and "stp" files missing from SSL folder

    Rocky_XYZZY Community Member

      One of our writers' SSL folder is showing differences from the other writers, even though we're presumably starting with the same project files. These differences are causing difficultes when this user attempts to publish.

       

      Among other things, the [projectname].lng and [projectname].stp files are missing from the troublesome environment's SSL folder.

       

      What would be wrong with the project settings or source that would cause these generated files to not appear?

        • 1. Re: "Lng" and "stp" files missing from SSL folder
          Peter Grainge ACP/MVPs

          This looks like a source control issue so I am venturing into the unknown for me as I do not use source control. However, as no one else has come in, any idea is better than none.

           

          In Snippets on my site there are details of files that should never be checked in or out and the files you mention are not listed. Could it be as simple as the required files are not being accessed?

           


          See www.grainge.org for RoboHelp and Authoring tips

           

           

          @petergrainge

          • 2. Re: "Lng" and "stp" files missing from SSL folder
            RoboColum(n) Community Member

            It is difficult to say what could be going on here without some more information. Try checking out the project to a brand new location. Do all the required files check out? If they do, you've managed to eliminate any source control issue.

             

            BTW is there a reason why your output folder is in source control at all? Could you not just publish to a shared drive?

            • 3. Re: "Lng" and "stp" files missing from SSL folder
              Captiv8r ACP/MVPs

              Hi Colum

               

              Just a heads up on the output folder thing. I used to wonder the same thing myself until I finally saw the reasoning.

               

              There are many tech writers that store only the output folder in source control. The reason is simple. When the application developers create the application, they check out of source control and perform the build. By having only the output files, they are only concerned with the help files that will support their application and need to be included in the build.

               

              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

              • 4. Re: "Lng" and "stp" files missing from SSL folder
                Rocky_XYZZY Community Member

                Thanks, Gang!

                 

                Here's some more information to help clarify the picture:

                 

                The setup:

                • We have two authors and a central source control system.
                • The generated files (e.g., SSL folder, etc.) are not in source control, as they're generated, as needed, in each writer's development environment whenever that writer manually generates and publishes the help.
                • We have a build server that communicates with the source control system and uses command line instructions to generate the help system nightly and publish to our help server (this nightly publish is in a development environment; we don't republish outward-facing help every single night).
                • We use PushOK plug-in for RoboHelp to allow RH to communcate with our SVN server and automatically check out the files that we need while working on topics. This seems to work acceptably well.

                 

                The symptoms:

                • The nightly build process works perfectly and publishes complete and valid help to the help server
                • Writer 1 can manually publish. Even after wiping the entire local project file and "getting latest all" from source control to entirely rebuild the local project directory. This seems to show that source control is providing Writer 1 all the necessary source files to then generate and publish a valid help project.
                • Writer 2, however, produces an incomplete project in the SSL folder when generating a help system from what should be the same source files from the source control system. When Writer 2 publishes at this point, the help sysem appears to publish and is browseable, but the server is in an unstable state and can no longer accept any content from anyone until that "area" on the server is deleted and re-created.
                • If Writer 1 gives Writer 2 the SSL folder from Writer 1's environment, then Writer 2's publish to the help server is successful, just as if Writer 1 generated and published (which isn't really a surprise, since it's the same SSL folder).
                • Running a compare between Writer 1's SSL folder and Writer 2's SSL folder results in the missing files (and others) that I posted about initially.
                • If Writer 1 reconfigures his help development environment using Writer 2's source control credentials and then checks out and publishes, the process fails identically to the failure that Writer 2 causes.

                 

                From all this we deduce that the source control system is somehow not delivering to Writer 2 the same content that it's delivering to Writer 1. While we can run a compare between Writer 1's project directory and Writer 2's project directory, we're seeing a large number of discrepancies between the two and we're seeking to narrow our focus by backtracking from the missing LNG and STP files that are absent in Writer 2's SSL folder. By understanding what source files are responsible for producing that particular output, it gives us a place to start in investigating the source control behavior.

                • 5. Re: "Lng" and "stp" files missing from SSL folder
                  Peter Grainge ACP/MVPs

                  I have moved this thread to the Source Control forum as that is where the issue lays.

                   


                  See www.grainge.org for RoboHelp and Authoring tips

                   

                   

                  @petergrainge

                  • 6. Re: "Lng" and "stp" files missing from SSL folder
                    Rocky_XYZZY Community Member

                    I appreciate everyone's feedback and assistance. I thought about putting the post in source control initially but decided that even though the issue is with getting different content from our source control, that's not really our pain point, as we have source control resources here in our organization.

                     

                    To best focus our source control diagnostic efforts, we are hoping to understand which RoboHelp source files are responsible for creating the missing SSL files we've been talking about. By undersatnding that, we can then better direct our efforts at diagnosing what's going on with source control.

                     

                    So, back to my original question: can anyone identify which specific RoboHelp source files are responsible for generating the LNG and the STP files that end up in the SSL folder?

                    • 7. Re: "Lng" and "stp" files missing from SSL folder
                      Peter Grainge ACP/MVPs

                      Try with a dummy new project but to the best of my knowledge, if they do not exist on opening a project, they are recreated with default content.