Chapter Nomenclature for Printed Documentation in RoboHelp 2017

New Here ,
Apr 22, 2020

Copy link to clipboard

Copied

I work with a company that creates corporate accounting software that includes both printed and online help documentation. We have multiple clients, some of which require conditional formatting. One of our clients has requested unique formatting for their chapter headings in their printed documentation. They would like to include two different font sizes in their chapter headings, for example, 

Chapter 1 Installing Interfaces. The only way I can think of to incorporate this request is through the use of a span tag in the HTML code and corresponding span style specifications in the css, but I cannot find the chapter nomenclature in an HTML view. 

 

Where does the "Chapter #" nomenclature for printed documentation live/come from?  I understand that the Chapter Name portion of the header is taken from the name of the TOC book, but where does the Chapter # portion come into play? Can this be revised in RoboHelp or is this automatically generated when the printed documentation output is selected/generated? For example, if I wanted to change "Chapter 1" to "Module 1", how would I accomplish this? Can I view this nomenclature in a HTML code view? Finally, is there a better way to achieve this formatting requests for the Chapter h1 headers? Thanks.

Views

537

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

Chapter Nomenclature for Printed Documentation in RoboHelp 2017

New Here ,
Apr 22, 2020

Copy link to clipboard

Copied

I work with a company that creates corporate accounting software that includes both printed and online help documentation. We have multiple clients, some of which require conditional formatting. One of our clients has requested unique formatting for their chapter headings in their printed documentation. They would like to include two different font sizes in their chapter headings, for example, 

Chapter 1 Installing Interfaces. The only way I can think of to incorporate this request is through the use of a span tag in the HTML code and corresponding span style specifications in the css, but I cannot find the chapter nomenclature in an HTML view. 

 

Where does the "Chapter #" nomenclature for printed documentation live/come from?  I understand that the Chapter Name portion of the header is taken from the name of the TOC book, but where does the Chapter # portion come into play? Can this be revised in RoboHelp or is this automatically generated when the printed documentation output is selected/generated? For example, if I wanted to change "Chapter 1" to "Module 1", how would I accomplish this? Can I view this nomenclature in a HTML code view? Finally, is there a better way to achieve this formatting requests for the Chapter h1 headers? Thanks.

Views

538

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
Apr 22, 2020 0
Adobe Community Professional ,
Apr 22, 2020

Copy link to clipboard

Copied

It's been a long time, but from memory isn't that in the word template specified in the last page of the print doco dialog box?

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...
Apr 22, 2020 0
Adobe Community Professional ,
Apr 23, 2020

Copy link to clipboard

Copied

Whilst you can apply a span tag to the heading HTML in topics, when you generate the printed documentation, you can map to a Word style in the template but that will apply Word's heading style and not recognise any inline formatting. If you generate using a CSS, it will use the style of the CSS.

 

Are you saying that the topics do not have Chapter # as part of the heading and in the print layout second page there is no reference to Chapter # but in the generated document there is? If so, do you run any macros in Word after generating? If not, I can't see how it is done. 

 

Can you share the project? If you can, then see the Contact page on my site and send the project as instructed there. Do make sure you include a link to this thread and please do not email the project direct.

 

How many chapters are you talking about?

 

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...
Apr 23, 2020 0
New Here ,
Apr 23, 2020

Copy link to clipboard

Copied

 

I do not believe I would be able to share the project as this is something my company creates, markets, and sells, but I would have to speak with someone.

There are quite a few chapters. Basically, we create different modules related to accounting, Receivables, Payables, Assests, etc. Each of these modules typically has a User's Guide, an Admin guide, and sometimes, an Import/Export Guide. So there can easily be 3 printed outputs with different TOCs generated for client delivery. The other point to make is that we have a major client that we use conditional tags for and separate formatting of which they have their own printed outputs.  

 

Yes, the Chapter number portion is NOT written anywhere in the RoboHelp project but is being generated in the printed output, not online documentation. For example, let's say we are looking at the Asset documentation, which has about 20 chapters. A TOC book name, example: Creating and Processing Batches, is being generated into the chapter heading when the print output type is selected. However, something is manually putting in the "Chapter #" nomenclature followed by the name, in this example Creating and Processing Batches. 

 

We do utilized an external stylesheet, css, and various macros to achieve certain formatting. I have not created these documents myself as I have only been working with this company for the last year or so.

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...
Apr 23, 2020 0
Adobe Community Professional ,
Apr 23, 2020

Copy link to clipboard

Copied

From what you say, the Chapter is getting added by those macros so that's what needs to be looked at. They must be run after the printed document is created so look at the document immediately after it has been produced by RoboHelp and before those processes are run.

 

Assuming Chapter does not appear at that stage, then someone needs to look at and modify those macros. How they would would select Chapter # and apply inline formatting to that will be fun.

 

Based on that, there's no point sharing the project as the issue is outside of RoboHelp.

 

It might just be quicker to select Chapter 1 in the Word document, apply a different font and then use the format painter to apply it to the others. Sometimes a kludge can be the quickest answer.

 

What neither RoboHelp or Word can do is automatically apply mixed font/size to the same heading.

 

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...
Apr 23, 2020 0
Adobe Community Professional ,
Apr 23, 2020

Copy link to clipboard

Copied

Can you confirm, in the last page of the Generate dialog box, if there is a Word template selected? If so, the chapter numbering may be being added by chapter numbering set on the Word heading styles. In which case, I think it's possible to format the chapter numbering differently from the heading. I don't have access to Word at the moment to check though and it's been a long time since I used chapter numbering myself (probably about 1998 🙂  .

 

If there isn't a Word template however, you'll need to get someone at your work to look at the external files and macros to figure out where it's coming from, as Peter said.

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...
Apr 23, 2020 0