Another PDF Fail - RH 2020

Oct 08, 2020

Copy link to clipboard

Copied

I thought my questions were at an end. LOL

 

I am having no problem generating Responsive HTML for my large project, but the PDF output has not yet been successful. I've poured over my project to try to figure out why it keeps failing, but I'm at a loss. Here is what I've checked so far.

 

  • Java SE Runtime 8u261 is installed to its default installation path 64-bit machine, 64-bit version.
  • Adobe Robohelp is installed to its default installation path
  • My RoboHelp project is built on my local D drive, but it is synched with a folder on Dropbox for backup and distribution to the company I am doing the docs for
  • There are no broken links (close to 800 topics total in two manuals)
  • One mystery file was listed in the RoboHelp log. I kept getting one message in the log that it failed to copy D:/Dropbox/ ....... (project path) ...../contents/assets/masterpages/_rhdefault.css. So I manually created a copy of that file and pasted it into that location.  The error went away. The big puzzle is what is calling for that file. I did a style sheets report and there is nothing using it. 
  • I set up my publishing profile. The build log shows it found Java. It then goes through updating all of the HTML topics. Then it goes through merging all the topics. All these done without any errors listed.
  • And then ... at the end of the log ... Error. Failed to generate Reference Manual.
  • I also tried making a copy of the project on another hard drive without the Dropbox connection to test if it might be a Dropbox lag or something. That copy also failed.

 

I did try to build a PDF of the About RoboHelp project sample, and that generated fine. I guess I will have to take a deeper look at that to see if I might be missing something, but so far things seem pretty straightforward.

 

I've checked and double-checked my project settings, css references, links, used and unused files. Given what I explain above, is there anything else I should look for?  

The problem was caused by an output topic having been imported into the source files. In Classic they were obvious as there would be red squares indicating the scripts within such topics.

 

Visually they are not obvious in the new UI. I have filed a ticket suggesting that the PDF generation process should check for such files and throw a warning if any are found.

 

If anyone thinks this is behind their PDF generation failure, the Find and Replace and search for CDATA. That will identify output files in your source.

 

Views

118

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more

Another PDF Fail - RH 2020

Oct 08, 2020

Copy link to clipboard

Copied

I thought my questions were at an end. LOL

 

I am having no problem generating Responsive HTML for my large project, but the PDF output has not yet been successful. I've poured over my project to try to figure out why it keeps failing, but I'm at a loss. Here is what I've checked so far.

 

  • Java SE Runtime 8u261 is installed to its default installation path 64-bit machine, 64-bit version.
  • Adobe Robohelp is installed to its default installation path
  • My RoboHelp project is built on my local D drive, but it is synched with a folder on Dropbox for backup and distribution to the company I am doing the docs for
  • There are no broken links (close to 800 topics total in two manuals)
  • One mystery file was listed in the RoboHelp log. I kept getting one message in the log that it failed to copy D:/Dropbox/ ....... (project path) ...../contents/assets/masterpages/_rhdefault.css. So I manually created a copy of that file and pasted it into that location.  The error went away. The big puzzle is what is calling for that file. I did a style sheets report and there is nothing using it. 
  • I set up my publishing profile. The build log shows it found Java. It then goes through updating all of the HTML topics. Then it goes through merging all the topics. All these done without any errors listed.
  • And then ... at the end of the log ... Error. Failed to generate Reference Manual.
  • I also tried making a copy of the project on another hard drive without the Dropbox connection to test if it might be a Dropbox lag or something. That copy also failed.

 

I did try to build a PDF of the About RoboHelp project sample, and that generated fine. I guess I will have to take a deeper look at that to see if I might be missing something, but so far things seem pretty straightforward.

 

I've checked and double-checked my project settings, css references, links, used and unused files. Given what I explain above, is there anything else I should look for?  

The problem was caused by an output topic having been imported into the source files. In Classic they were obvious as there would be red squares indicating the scripts within such topics.

 

Visually they are not obvious in the new UI. I have filed a ticket suggesting that the PDF generation process should check for such files and throw a warning if any are found.

 

If anyone thinks this is behind their PDF generation failure, the Find and Replace and search for CDATA. That will identify output files in your source.

 

Views

119

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Oct 08, 2020 0
Oct 08, 2020

Copy link to clipboard

Copied

given that the "failed to copy" message references the masterpages folder, have you checked the stylesheet attached to the master page used for the pdf output preset?

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Oct 08, 2020 0
Oct 08, 2020

Copy link to clipboard

Copied

That was actually a good suggestion, but no reference in that stylesheet to that mystery _rhdefault.css. It's a real puzzle where it's coming from. LOL

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Oct 08, 2020 0
Oct 08, 2020

Copy link to clipboard

Copied

Are you doing anything like importing Word files through the Link functionality? If so, perhaps the import settings are referencing it?

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Oct 08, 2020 0
Oct 08, 2020

Copy link to clipboard

Copied

It was initially imported from a Word file, but then broken apart into individual HTML topics. The only external references in the project are external URLs. 

 

There are a lot of topics, but other than that it's pretty straightforward HTML and CSS.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Oct 08, 2020 0
Oct 08, 2020

Copy link to clipboard

Copied

Use the Find and Replace to search for  _rhdefault.css. In Settings, select Find in Source View.

 

Please use the blue Reply button at the top to help me help you. The black Reply link nests replies and they sort out of order.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Oct 08, 2020 0