5 Replies Latest reply on Nov 11, 2009 10:35 AM by Peter Grainge

    Controlling window size and positioning in RH8 WebHelp

    James K. Patrick

      Evening all,

       

      I've seen a post before about controlling the size and/or positioning or RH WebHelp windows, but I haven't been able to find it again.

       

      I'm generating WebHelp in RH8 and at this point am using the default skin and whatever default tri-pane and CSH windows RH chooses to use.

       

      Question is: how do I control the size and position of these windows? Or can I?

       

      I suspect they're set in a .js, but don't know which one. I know I can create new windows, and if I recall correctly, I can make one for CSH and one for the classic tri-pane help display. Is this how folks typically control the windows used to display RH content? Or do they muck about in the original .js files?

       

      Or, and this is the more likely, am I just being too anal-retentive about this and I should just let RH do its default thing and not worry about it?

       

      Thanks - I'm just a bit confused here,

       

      Patrick

        • 1. Re: Controlling window size and positioning in RH8 WebHelp
          Captiv8r Adobe Community Professional & MVP

          Hi Patrick

           

          If you aren't working with a programmer to connect your WebHelp to an application, you really don't have much control over the placement and attributes that are used.

           

          Note that when you create a project in RoboHelp HTML, you have an ability to create a WebHelp window with the desired attributes. But really, all that does is configure the way a window will open if you are using something called the "WebHelp API" to open topics. As you stated earlier, JavaScript is actually used by the API to open the window.

           

          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

          • 2. Re: Controlling window size and positioning in RH8 WebHelp
            James K. Patrick Level 1

            Rick,

             

            Thanks for the quick reply.

             

            Yes, I'm working with a developer.We've implemented a field-level CSH help solution using the WebHelp API for the first go-round.

             

            Now we're working on integrating the existing CSH help with the classic tri-pane help UI. And it's one of  my jobs to write the specification for how/when/where/why the help displays.

             

            So perhaps I AM being too anal-retentive and should ask a more general question to start with:

            When you've got both CSH content (called by the API and displayed in a plain-jane, no controls window) as well as a full blown task-based help system displaying in the classic tri-pane UI, how do folks integrate these two?

             

            When the CSH is called, do they just let the user click the "Show" link to display the tri-pane UI?

            Or do they make a new window for CSH that mimics the tri-pane UI so the user has the same UI experience regardless of the method used to access help?

             

            Just trying to come up with some reasonable ideas here to base my wireframe on.

             

            Thanks,

             

            Patrick

            • 3. Re: Controlling window size and positioning in RH8 WebHelp
              Peter Grainge Adobe Community Professional (Moderator)

              We always open CSH in the tri-pane window so that the user gets the help they need but can see it in the context of the whole screen / product.

               

              Our oldest product has CSH for every field and screen. The help menu offer open the help at the default topic, the current screen or the current field. There is a topic for every field, that has a link to the screen help, that has a link to the module help and that has a link to the default topic.

               

              For later products, we don't write separate topics for each field. Instead the user is taken to screen level help but that has a table with information about each field. That way while they are reading about the field they enquired about, they get to see information about other fields and the whole screen. Feedback suggest it is better for users and it is certainly better for us. Win win.

               

              You refer to a window that "mimics" the tri-pane. We just open the help with the tri-pane so no mimicking involved.

               


              See www.grainge.org for RoboHelp and Authoring tips

              Follow me @petergrainge

              • 4. Re: Controlling window size and positioning in RH8 WebHelp
                James K. Patrick Level 1

                Peter,

                 

                Thanks for the details of how you folks do CSH - it's given me some good ideas for our version due out mid-2010.

                 

                In response to your statement:

                 

                "We always open CSH in the tri-pane window so that the user gets the help they need but can see it in the context of the whole screen / product."

                 

                Does that mean you use the Window Properties (WebHelp) dialog to create and name a new window that acts just like RH's default tri-pane window?

                 

                If so, that's what I'm doing, and I used "mimic" as I don't know what RH is doing behind-the-scenes. I'm mimicing RH's default tri-pane window with one of my own.

                 

                The end result I'm aiming for is to have help called in 2 ways from 2 different places but look basically the same from a UI perspective:

                 

                A general call to help that displays RH's default tri-pane UI and default topic:

                RH_ShowHelp(0,'c:/Projects/Generate/DashboardHelp/!SSL!/WebHelp/index.htm', HH_DISPLAY_TOC, 0)

                 

                And a CSH call that also displays in a tri-pane UI (in this case I've named it NewWindow1):

                RH_ShowHelp(0,'c:/Projects/Generate/DashboardHelp/!SSL!/WebHelp/index.htm>NewWindow1', HH_HELP_CONTEXT, 1000)

                 

                I'm guessing that the Window Properties (WebHelp) dialog is really just a user interface to control the default frameset RH uses to display topics in a call of the first type above.

                 

                Of course the boss wants me to modify objects that appear in the NewWindow1 but aren't exposed in the Window Properties (WebHelp) dialog, but that's for another post.

                 

                Thanks,

                 

                Patrick

                • 5. Re: Controlling window size and positioning in RH8 WebHelp
                  Peter Grainge Adobe Community Professional (Moderator)

                  No. We leave the window properties set to use the browser default settings. Calls are then handled by our developers.

                   

                  If you are an author rather than a developer, then this is all stuff that they control.

                   

                  If you are wanting to see how it would work, see Calling WebHelp Using URLs. That describes how in the browser you can call a specific topic using the # method. How that is done from your application is for your developers.

                   


                  See www.grainge.org for RoboHelp and Authoring tips

                  Follow me @petergrainge