Handbook Creator

This document describes Handbook Creator configuration file parameters.

PAGE

Create a new top level webpage

Parameter Description Required
Filename Name of the HTML file True

TARGET_PAGES

Create a new webpage for each of the defined TARGETS

The page will be generated for each target. A top level “Targets” drop down will be created with links to all the generated target pages.

Parameter Description Required
Filename Postfix The postfix will be applied to each generated target file. For example, a target named INST with a postfix of ‘_cmd_tlm.html’ will result in a file named ‘inst_cmd_tlm.html’. True

PAGE Modifiers

The following keywords must follow a PAGE keyword.

NO_PDF

Indicates this page should not be generated when building the PDF

Handbook Creator can create webpages and export them to PDFs. Use this keyword when you have an index webpage or another page for which you do not want a PDF created.

PDF_COVER

Defines an HTML ERB template which is used to create the PDF cover page

The template is simply HTML tags which can reference ‘title’ set by this keyword from ERB context

Parameter Description Required
Filename Name of the HTML ERB template file which is found in the config/tools/handbook_creator/templates directory. True
Title Text Title text which is accessable in the template True

PDF_TOC

Insert the PDF table of contents

The table of contents is generated from the XSL templated found in config/tools/handbook_creator/default_toc.xsl

PDF_HEADER

Defines an HTML ERB template which is used to create the header on each PDF page

The template is simply HTML tags which can reference ‘title’ set by this keyword from ERB context

Parameter Description Required
Filename Name of the HTML ERB template file which is found in the config/tools/handbook_creator/templates directory. True
Title Text Title text which is accessable in the template True

Defines an HTML ERB template which is used to create the footer on each PDF page

The template is simply HTML tags which can reference ‘title’ set by this keyword from ERB context

Parameter Description Required
Filename Name of the HTML ERB template file which is found in the config/tools/handbook_creator/templates directory. True
Title Text Title text which is accessable in the template True

PDF_TOP_MARGIN

The margin from the top of the PDF page before the header

Parameter Description Required
Margin The margin in pixels True

PDF_BOTTOM_MARGIN

The margin below the footer to the bottom of the PDF page

Parameter Description Required
Margin The margin in pixels True

PDF_SIDE_MARGIN

The margin on both sides on the PDF page

Parameter Description Required
Margin The margin in pixels True

TARGET

Specify a target which this page is generated for

Parameter Description Required
Target The target name

Valid Values: Any Target Name
True

SECTION

Define a page SECTION

Parameter Description Required
Filename Name of the HTML ERB template file which is found in the config/tools/handbook_creator/templates directory. True
Output What output formats should contain this section

Valid Values: ALl, HTML, PDF
True
Title Text Title text which is accessable in the template False

CMD_SECTION

Define a page SECTION which is generated for all command packets

Parameter Description Required
Filename Name of the HTML ERB template file which is found in the config/tools/handbook_creator/templates directory. True
Output What output formats should contain this section

Valid Values: ALl, HTML, PDF
True
Title Text Title text which is accessable in the template False

TLM_SECTION

Define a page SECTION which is generated for all telemetry packets

Parameter Description Required
Filename Name of the HTML ERB template file which is found in the config/tools/handbook_creator/templates directory. True
Output What output formats should contain this section

Valid Values: ALl, HTML, PDF
True
Title Text Title text which is accessable in the template False