Skip to main content
October 28, 2010
Question

Robohelp 8 generates html folder within the html folder

  • October 28, 2010
  • 2 replies
  • 3233 views

Hello all,

I am having some issues generating the webhelp from Robohelp8. After I change something in the project (which is stored and checked out in clearcase) and re-generate the output, it automatically creates a new html folder within the original html folder and re-creates all the existing htm files, which make up the project. And then the start page searches and takes the files from the second html folder (within the first html folder). I tried adjusting the path, but it doesn't help. Any ideas why this happens?

Thank you!!

Regards,

Zita

This topic has been closed for replies.

2 replies

Community Expert
October 28, 2010

We had a problem recently with Visual studio source control and RH just recently

The project in source control was:

$/Documentation/Product1/main

In the xpj the path was one level up:

$/Documentation/Product1

So the guy thought he was working in the 'main' folder, but when he checked in/out, RH would add/get from the Product1 folder instead. So we had duplicated content in both places.

You could see if you have a mismatch there by opening the xpj in Notepad.

Amebr

Captiv8r
Legend
October 28, 2010

Hi there

Out of curiosity, you *ARE* generating WebHelp, right?

Can you please post a screen capture of your Windows Explorer showing the project folder structure as well as the first screen of the Single Source Layouts dialog for WebHelp?

Cheers... Rick

Helpful and Handy Links

RoboHelp Wish Form/Bug Reporting Form

Begin learning RoboHelp HTML 7 or 8 moments from now - $24.95!

Adobe Certified RoboHelp HTML Training

SorcererStone Blog

RoboHelp eBooks

October 29, 2010

Hi,

Thank you for the quick response. Yes, I am generating a webhelp.

I will attach the screenshots.

On some occasions, when i set the path, it prompts me, that there already is a html folder and i need to chose a new destination. But, within this htm folder are all the htm files which should be overwritten when i generate the new output.

Thank you!

Zita

RoboColum_n_
Legend
November 12, 2010

Hi folks

I certainly don't mean to be arbitrarily disagreeable, but here's another viewpoint to consider.

Personally, I'm not sure I'd ever say that output files should never be in a source control system. (And yes, I do believe I totally understand the difference between the two. )

Sometimes a workflow and environment is actually structured in a manner where that particular setup is actually beneficial and desired by the development team. For example, if you are creating a help system used by an application, the developers of the application may actually benefit tremendously by having the output file(s) in the source control system. This is because even though the files are output from your perspective, they are considered source files from the developers perspective. So having the output file(s) in source control would make total logical sense as the developers would use your output file(s) in the final or intermediate builds of the application installer.

As long as the RoboHelp author understands the difference between the source and output folders, there really shouldn't be any reason that the output folder can't exist as a sub folder of the source. After all, that's really the way that RoboHelp works until the help author elects to place the output files elsewhere. Unfortunately, that's exactly when we see help authors get themselves into trouble. When they start rearranging where the output files go without understanding the real differences between those and the source files. Because of this, I would recommend that anyone choosing to relocate the output folder tread very carefully. Unless you have good reasons for doing so (and I know some folks do), my vote is to leave them in the default location of !SSL!\Output Folder.

Cheers... Rick

Helpful and Handy Links

RoboHelp Wish Form/Bug Reporting Form

Begin learning RoboHelp HTML 7 or 8 moments from now - $24.95!

Adobe Certified RoboHelp HTML Training

SorcererStone Blog

RoboHelp eBooks


Thanks for the input Rick as I too can see the benefits for some of having output source controlled. Like you I see both sides of the arguement and fully accept that for some this is not the way to go. To add to your application scenario, adding (say) a CHM file to source control at a said location that can be picked up automatically by a build script can add real benefit to all.


  The RoboColum(n)   @robocolumn   Colum McAndrew