Commands

Command Syntax:

!COMMAND,Parameters

Where:

Command Element Description
! Command identifier
COMMAND The command name
Parameter(s) Parameter(s) will depend upon the command

Commands for use in script (commands in bold are required, all other are optional)

Command Variable Name Parameter(s) Description
BASE_URL
(Reserved)
baseURL <URL> Base URL of planned destination.
COPY N/A <Source>,<Destination> Source and Destination need to include the full path specification from the DynaDoc location.
CSS_PATH cssPath <pathname> CSS files path
DOC_TYPE docType <Document Type> Document Type - can be used with a variable in a template or regular page text.
EXCLUDED_PAGES excludedPages <string of characters or digits> List of pages to be excluded. If a page definition in the script contains one of these characters the page will be excluded. This can be useful to create boilerplate script with optional pages that can be excluded. See the Page Definitions section for usage.
HEADER_BREAK headerBreak <Header Break> Header Break - can be used with a variable in a template or regular page text. Allows the insertion of line breaks in a header such as Product and Doc Type. Defaults to " " (space).
HTML_PATH htmlPath <pathname> HTML files path
HTML_VERSION htmlVersion <pathname> Alternate HTML folder (for creating multiple document versions in the same project folder). The value of htmlVersion is appended to the HTML folder name.
JS_PATH jsPath <pathname> JavsScript files path
IMG_PATH imgPath <pathname> Image files path
INCLUDE N/A <filename>,<level> Include an external script, and the base level for menu hierarchy. Can include a path (relative to DynaDoc location) and be used recursively. Order of search locations: projDir, rootDir, relative to Dynadoc location. An included file can be referenced using a variable name for the filename. To use a variable for the filename the variable name should be preceded by "@@". The variable and actual filename must be defined as a text substitution in the main SUBLIST. The main SUBLIST is defined as a standard SUBLIST (see the SUBLIST command below), but must be named <scriptName>.sub and be located in the project folder with the script. DynaDoc will resolve the variable name to the file name using the text substitution and then include that file if it exists.
INCLUDED_PAGES includedPages <string of characters or digits> List of pages that are to be included, defaults to vpxq$@abcis. If a page definition in the script contains one of these characters the page will be included. Page definitions without any character are included by default. See the Page Definitions section for usage.
LOCAL_CSS localCSS <pathname> Project specific CSS file
MENU_WIDTH menuWidth <number> Menu width in pixels
OUT_DIR outDir <foldername> Output folder (include trailing /)
OUT_PATH outPath <pathname> Output path (include trailing /)
PAGE_BREAK_LEVEL pageBreakLevel <level number> Page breaks will be added to all pages at this level and all higher levels in the hierarchy. Defaults to 1, the highest level. If set to 3, all pages on levels 1, 2 and 3 will print on a new page. To suppress all page breaks, set PAGE_BREAK_LEVEL to 0. PAGE_BREAK_LEVEL can be overridden on a page by page basis using the @ symbol in the script before the * in the menu level. Example script line to force page break: @*,Copyright,,copyright.htm,,,
PRINT_NAME printName <filename> Name of print file. Can be used for printing instructor and student versions.
PRINT_VIEW_NAME printViewName <filename> Name of print file for print-view pages.
PRODUCT product <Document Name> Document Name - can be used with a variable in a template or regular page text.
SUB Inline Text Substitution Definition <Text substitution placeholder name, text to substitute> When an include is found in the content that specifies a text substitution placeholder, the placeholder will be replaced with the text to substitute. The SUB command can be used with SUBLIST.
SUB text substitutions are defined before page output generation and can be placed anywhere in the script, even at the end. All pages will use the same definition. See the VSUB command if you need to redefine a placeholder during script processing.
SUBLIST Text Substitution Definition File <Text substitution file name, placeholder prefix> If numerous text substitutions are to be used, they can be placed in a separate file. The SUBLIST command specifies the file to include, and a placeholder prefix that can be used to simplify input in the file. The substitution file format is text, with the first line blank. Each subsequent line should include the placeholder name followed by a comma and then the text to substitute. If the prefix is included in the SUBLIST command, it should not be included in the placeholders in substitution file, but must still be included in the placeholders in the content files. The SUBLIST command can be used with SUB.
SUBLIST text substitutions are defined before page output generation and can be placed anywhere in the script, even at the end. All pages will use the same definition. See the VSUBLIST command if you need to redefine a placeholder during script processing.
TEMPLATE_COVER templateCover <filename>,<filename>,<filename> Print Cover Page Template, print cover page content, and print cover page JavaScript (optional).
TEMPLATE_PRINT templatePrint <filename> Print Page Template
TEMPLATE_VIEW templateView <filename> View Page Template
TOCMENU_IMAGES TOCMenuImages <blank or 0> Add images to menu, default = yes, set to 0 to disable.
TOCPRINT_IMAGES TOCPrintImages <blank or 1> Add images to print TOC, default = no, set to 1 to enable.
TOCVIEW_IMAGES TOCViewImages <blank or 0> Add images to view TOC, default = yes, set to 0 to disable.
VALID_TEXT validText <string of numbers> Used to control which conditional text is included or excluded. VALID_TEXT numbers range from 0 - 9. If a number (#) is included in this list, the corresponding conditional text between <!--#--> and <!--/#--> will be displayed, and text between <!--x#--> and <!--/x#--> will NOT be displayed. See the corresponding tags in the section about Content Blocks.
VERSION version <Document Version> Document Version - can be used with a variable in a template or regular page text.
VID_PATH vidPath <pathname> Video files path
VSUB Inline Text Substitution Definition <Text substitution placeholder name, text to substitute> When an include is found in the content that specifies a text substitution placeholder, the placeholder will be replaced with the text to substitute. The SUB command can be used with SUBLIST.
VSUB text substitutions are defined during page output generation. They can be redefined at any time within the script and the same placeholder can have different values on different pages. This is valuable when a script is auto generated and a page is reused multiple times, but you want different values on each page, such as in a loop. The value is not available on pages in the script before the SUB definition is used. See the SUB command.
VSUBLIST Text Substitution Definition File <Text substitution file name, placeholder prefix> If numerous text substitutions are to be used, they can be placed in a separate file. The SUBLIST command specifies the file to include, and a placeholder prefix that can be used to simplify input in the file. The substitution file format is text, with the first line blank. Each subsequent line should include the placeholder name followed by a comma and then the text to substitute. If the prefix is included in the SUBLIST command, it should not be included in the placeholders in substitution file, but must still be included in the placeholders in the content files. The SUBLIST command can be used with SUB.
VSUBLIST text substitutions are defined during page output generation. They can be redefined at any time within the script and the same placeholder have different values on different pages. This is valuable when a script is auto generated and a page is reused multiple times, but you want different values on each page, such as in a loop. The value is not available on pages in the script before the SUB definition is used. See the SUBLIST command.

DynaDoc variables, or text substitutions can be used for command parameters. The variable name or text substitution placeholder should be preceded by a single "$".


VideoRay Documentation Only

[ Help us improve this document ]

DynaDoc Operator's Manual, Version: 1.00.00
Copyright © 2017, VideoRay LLC - The Global Leader in Micro-ROV Technology