Build options and footers in a template

Please post all questions and comments regarding Help & Manual 7 here.

Moderators: Alexander Halser, Tim Green

Build options and footers in a template

Unread postby jabramoff » Thu Mar 14, 2019 9:12 am

Hello.

Is it possible to apply build options to template content?

We place part numbers and document titles in footers and the I'd like for the build option to determine the part number and the product name in the document title.

Thank you.
jabramoff
 
Posts: 4
Joined: Sun Aug 05, 2018 12:55 pm

Re: Build options and footers in a template

Unread postby Tim Green » Thu Mar 14, 2019 12:21 pm

Hi Jabra,

Is it possible to apply build options to template content?

Absolutely. You need to get the original tag name of the condition and use that as follows:

Code: Select all
<IF_TAGNAME> content goes here </IF_TAGNAME>
<IFNOT_TAGNAME> content goes here </IFNOT_TAGNAME>

See this page in the help for details:

https://helpandmanual.com/help/index.ht ... itions.htm

Important: If you're using a skin you need to edit the templates in the skin, not in your project, since the skin templates replace the project ones. Also, there are certain restrictions if you are using V3 skins from the Premium Pack. Specifically, you can't use topic-based variables in the page template because the topic content is replaced dynamically, without replacing the entire page.
Regards,
Tim (EC Software Documentation & User Support)

Private support:
Please do not email or PM me with private support requests -- post to the forum directly.
User avatar
Tim Green
Site Admin
 
Posts: 20584
Joined: Mon Jun 24, 2002 9:11 am
Location: Bruehl, Germany

Re: Build options and footers in a template

Unread postby jabramoff » Thu Mar 14, 2019 12:45 pm

Awesome. Thanks, Tim.

I did try searching the H+M Help, but the relevant Help pages did not appear in the results.
jabramoff
 
Posts: 4
Joined: Sun Aug 05, 2018 12:55 pm

Re: Build options and footers in a template

Unread postby jabramoff » Thu Mar 14, 2019 1:02 pm

Hi again.

I just noticed that the Help topic is for HTML templates. I'm not using an HTML template. I use the template for PDF output.

I tried using the IF tagging in a text label, but that didn't work.

Any further information would be appreciated.

Jay
jabramoff
 
Posts: 4
Joined: Sun Aug 05, 2018 12:55 pm

Re: Build options and footers in a template

Unread postby Tim Green » Thu Mar 14, 2019 2:06 pm

Hi Jay,

jabramoff wrote:I just noticed that the Help topic is for HTML templates. I'm not using an HTML template. I use the template for PDF output.

Sorry, but conditional tags are not currently supported in PDF templates. I thought you were referring to HTML. What you can do is use the Snippet function in the Insert menu in Manual Designer. The snippet -- which can be an independent XML snippet file created by Help+Manual or a topic in your project -- can then contain conditional tags and they will work on it in the template.

If you use the option to reference a topic ID with the snippet tool in Manual Designer you can also have a topic file with the same ID but different content in each project, so you insert custom content in the template automatically for each project. You then create the snippet file in Project Files > Topic Files, so that it does not have a TOC entry, and set its build options to PDF only so that it doesn't get exported to HTML-based formats invisibly.

If you don't need custom versions for each project you can create an external snippet XML file and use the same one for all projects. You then need to include the folder where it is stored in Configuration > Common Properties > Project Search Path in every project so that HM can find it when publishing. See this topic for information on managing snippets:

https://helpandmanual.com/help/index.ht ... ippets.htm
Regards,
Tim (EC Software Documentation & User Support)

Private support:
Please do not email or PM me with private support requests -- post to the forum directly.
User avatar
Tim Green
Site Admin
 
Posts: 20584
Joined: Mon Jun 24, 2002 9:11 am
Location: Bruehl, Germany

Re: Build options and footers in a template

Unread postby jabramoff » Thu Mar 14, 2019 2:28 pm

Sounds good.

Thanks again, Tim.
jabramoff
 
Posts: 4
Joined: Sun Aug 05, 2018 12:55 pm


Return to Help & Manual 7 Forum

Who is online

Users browsing this forum: No registered users and 8 guests

cron