Changing Primary Layout in the Blank Project Template in RoboHelp

Changing Primary Layout in the Blank Project Template in RoboHelp

When you create a new RoboHelp project based on the Blank Project template, the resulting project will have the Responsive HTML5 layout set as the Primary Layout. Although this works fine for most projects with a web audience, there can be times when you need to publish in one of the various other available formats. Changing the Primary Layout is a simple operation, but it can get tedious if you need to create a lot of new projects and change it for all of them.

Wouldn’t it be nice if there was a way to change the Primary Layout in the project template such that any new project will automatically have your desired Layout set as Primary?

RoboHelp Primary Target Before / After modification

In this post, we are going to be doing exactly that.


What is a Project Template?

A project template is simply a RoboHelp Project with certain settings pre-configured. They reside in the RoboHelp installation folder. When creating a new project, RoboHelp allows the user to select one of the templates to base the new project on. RobHelp then makes a copy of the template project into your specified directory and makes certain changes like setting new title, default topic, etc.

Since the template is nothing but a RoboHelp Project, it can be modified to change the default behavior of a new project.


A word of caution

Template modification is a powerful tool. As we will see in the following text, it is not limited to just changing the Primary Layout of a new project. It is really important NOT to try anything other than what is specified in this article. If you do, you may end up corrupting your Project Template or worse still, corrupting the RoboHelp installation.

Further, this has been tested to work with RoboHelp 11 and RoboHelp 2015 only. Try this out only if you are using any of these two versions.


Let’s Do It

There are two ways to accomplish what we want to do:

  1. Using RoboHelp to modify the Template Project (much safer)

  2. Directly modifying template database using Microsoft Access

Before going ahead with either of the approaches, carry out these tasks:

  1. Check if you have RoboHelp 11 or RoboHelp 2015 installed.

  2. Make a backup of <RoboHelpInstallFolder>\RoboHTML\Template\en_US\BlankProject folder.

1. Using RoboHelp to modify the Template Project

  1. Create a new Blank Project in RohoHelp. This is a temporary project which you can delete afterwards.

  2. From the Single Source Layouts pod, mark your desired layout as Primary.

  3. Close this project.

  4. Now browse to the folder on disk where this project resides and delete all FOLDERS you see inside the project folder. E.g. !ScreenLayout!, !Language! etc.

  5. Also delete the ProjectName.cpd file.

  6. Now open root.fpj file in any text editor and remove any <folders></folders> pairs including everything in between each pair. Save and close.

  7. Open and Close the project in RoboHelp once to recreate the ProjectName.cpd file.

  8. Rename <ProjectName>.cpd to Template.cpd.

  9. Replace <RoboHelpInstallFolder>\RoboHTML\Template\en_US\BlankProject\Template\Template.cpd with the CPD file you just created in previous step.

Voila. All new projects based on the Blank Project template will now have your desired layout set as primary.


2. Directly modifying template database using Microsoft Access

Prerequisite – This method requires use of Microsoft Access.

  1. Open <RoboHelpInstallFolder>\RoboHTML\Template\en_US\BlankProject\Template\Template.cpd file in Microsoft Access.

  2. You would see a list of DB tables. Open table “Project Properties” from this list.

    Editing RoboHelp PrimaryTarget in Template.cpd in Microsoft Access
  3. Change the value in column “PrimaryTarget” to one of the following:

    PrimaryTarget value

    Layout Name

    5

    Microsoft HTML Help

    6

    WebHelp

    11

    WebHelp Prop

    13

    Printed Documentation

    15

    FlashHelp

    16

    XML Output

    17

    FlashHelp Pro

    18

    Adobe AIR

    19

    Multiscreen HTML5

    20

    eBook

    21

    Responsive HTML5

    22

    Mobile Help (Only for RoboHelp 2015)

Save the CPD and close Microsoft Access.


All new blank projects will now have their default layout set to what you selected in the previous step.


Ankit Rajpoot

Ankit Rajpoot joined Adobe in late 2012. He is involved in the role of a developer in the Adobe TechComm team with experience in C++, MFC, STL & Web Technologies. He holds a master's degree in Computer Application from National Institute of Technology, Trichy. When he is not coding, he likes to dabble into photography and small-scale electronics projects. You can also follow Ankit on Twitter: @ankitr42

Leave a Reply

Your email address will not be published. Required fields are marked *