DITA Map WebHelp Responsive Transformation
DITA content can be transformed into several types of WebHelp Responsive systems (with or without a feedback section). The WebHelp Responsive layout and features are designed to adapt to any device and screen size to provide an optimal viewing and interaction experience. Oxygen XML Editor also provides numerous possibilities for customizing the WebHelp Responsive output.
WebHelp Responsive Transformation Scenario
- Select the Configure Transformation Scenario(s) action from the DITA Maps Manager toolbar.
- Select the DITA Map WebHelp Responsive scenario from the DITA Map section.
-
If you want to configure the transformation, click the Edit button.
Step Result: This opens an Edit scenario configuration dialog box that allows you to configure various options in the following tabs:- Templates Tab - This tab contains a set of built-in publishing templates that you can use for the layout of your WebHelp system output. You can also create your own publishing templates or edit existing ones.
- Parameters Tab - This tab includes numerous parameters that can be set to customize your WebHelp system output. See the Parameters section below for details about the most commonly used parameters for WebHelp Responsive transformations.
- Feedback Tab - This tab is for those who want to add the Oxygen Feedback comments component at the bottom of each WebHelp page so that you can interact with your readers.
- Filters Tab - This tab allows you to filter certain content elements from the generated output.
- Advanced Tab - This tab allows you to specify some advanced options for the transformation scenario.
- Output Tab - This tab allows you to configure options that are related to the location where the output is generated.
- Click Apply associated to process the transformation.
Result: When the DITA Map WebHelp Responsive transformation is complete, the output is automatically opened in your default browser.
General Parameters for Customizing WebHelp Responsive Output
- default.language
- This parameter is used if the language is not
detected in the DITA map. The default value is
en-us
. - clean.output
- Deletes all files from the output folder before the
transformation is performed (only
no
andyes
values are valid and the default value isno
). - editlink.remote.ditamap.url
- Use this parameter in conjunction with
editlink.web.author.url
to add an Edit link next to the topic title in the WebHelp output. When a user clicks the link, the topic is opened in Oxygen XML Web Author where they can make changes that can be saved to a file server. The value should be set as the custom URL of the main DITA map. For example, a GitHub custom URL might look like this: https://getFileContent/oxyengxml/userguide/master/UserGuide.ditamap. - editlink.web.author.url
- This parameter needs to be used in conjunction
with
editlink.remote.ditamap.url
to add an Edit link next to the topic title in the WebHelp output. When a user clicks the link, the topic is opened in Oxygen XML Web Author where they can make changes that can be saved to a file server. The value should be set as the URL of the Web Author installation. For example: https://www.oxygenxml.com/oxygen-xml-web-author/. - editlink.present.only.path.to.topic
- When this parameter is set to "true", the DITA topic path is displayed to the right of each topic title in the WebHelp Responsive output. Also, when this parameter is used, the editlink.ditamap.edit.url, editlink.remote.ditamap.url, and editlink.web.author.url parameters are ignored.
- fix.external.refs.com.oxygenxml (Only supported when the DITA-OT transformation process is started from Oxygen XML Editor)
- The DITA Open Toolkit usually has
problems processing references that point to locations outside of the directory of the
processed DITA map. This parameter is used to specify whether or not the
application should try to fix such references in a temporary files folder before the
DITA Open Toolkit is invoked on the fixed references. The fix has no impact on your
edited DITA content. Allowed values:
true
orfalse
(default). - force.unique
- When set to
true
(default value), the transformation will be forced to create unique output files for each instance of a resource when a map contains multiple references to a single topic. - use.stemming
- Controls whether or not you want to include stemming search
algorithms into the published output (default setting is
false
). - webhelp.csh.disable.topicID.fallback
- Specifies whether or not topic ID
fallbacks are enabled when computing the mapping of context sensitive
help and
resourceid
information is not available. Possible values are false (default) and true. - webhelp.custom.resources
- The file path to a directory that contains resources files. All files from this directory will be copied to the root of the WebHelp output.
- webhelp.favicon
- The file path that points to an image to be used as a favicon in the WebHelp output.
- webhelp.reload.stylesheet
- Set this parameter to
true
if you have out of memory problems when generating WebHelp. It will increase processing time but decrease the memory footprint. The default value isfalse
. - webhelp.search.custom.excludes.file
- The path of the file that contains name patterns for HTML files that should not be indexed by the WebHelp search engine. Each exclude pattern must be on a new line. The patterns are considered to be relative to the output directory, and they accept wildcards such as '*' (matches zero or more characters) or '?' (matches one character). For more information about the patterns, see https://ant.apache.org/manual/dirtasks.html#patterns.
- webhelp.search.japanese.dictionary
- The file path of the dictionary that will be used by the Kuromoji morphological engine for indexing Japanese content in the WebHelp pages. The encoding for the dictionary must be UTF8.
- webhelp.search.enable.pagination
- Specifies whether or not search results
will be displayed on multiple pages. Allowed values are
yes
orno
. - webhelp.search.index.elements.to.exclude
- Specifies a list of HTML
elements that will not be indexed by the search engine. The value of the
@class
attribute can be used to exclude specific HTML elements from indexing. For example, the div.not-indexed value will not index all<div>
elements that have a@class
attribute with the value of not-indexed. Use a comma separator to specify more than one element. - webhelp.search.page.numberOfItems
- Specifies the number of search results items displayed on each page. This parameter is only used when the webhelp.search.enable.pagination parameter is enabled.
- webhelp.search.ranking
- If this parameter is set to
false
then the 5-star rating mechanism is no longer included in the search results that are displayed on the Search tab (default setting istrue
). - webhelp.search.stop.words.include
- Specifies a list of words that will be ignored by the search engine. Use a comma separator to specify more than one word.
- webhelp.show.changes.and.comments
- When set to
yes
, user comments, replies to comments, and tracked changes are published in the WebHelp output. The default value isno
. - webhelp.sitemap.base.url
- Base URL for all the
<loc>
elements in the generated sitemap.xml file. If this parameter is specified, the loc element will contain the value of this parameter plus the relative path to the page. If this parameter is not specified, the loc element will only contain the relative path of the page (the relative file path from the@href
attribute of a<topicref>
element from the DITA map, appended to this base URL value). - webhelp.sitemap.change.frequency
- The value of the
<changefreq>
element in the generated sitemap.xml file. The<changefreq>
element is optional in sitemap.xml. If you leave this parameter set to its default empty value, then the<changefreq>
element is not added in sitemap.xml. Allowed values: <empty string> (default),always
,hourly
,daily
,weekly
,monthly
,yearly
,never
. - webhelp.sitemap.priority
- The value of the
<priority>
element in the generated sitemap.xml file. It can be set to any fractional number between 0.0 (least important priority) and 1.0 (most important priority). For example, 0.3, 0.5, or 0.8. The<priority>
element is optional in sitemap.xml. If you leave this parameter set to its default empty value, then the<priority>
element is not added in sitemap.xml.
Parameters Specific to Oxygen WebHelp Responsive
- webhelp.fragment.feedback
- You can integrate Oxygen Feedback with your WebHelp Responsive output to provide a comments area at the bottom of each page where readers can offer feedback. When you create an Oxygen Feedback site configuration, an HTML fragment is generated during the final step of the creation process and that fragment should be set as the value for this parameter.
- webhelp.default.collection.type.sequence
- Specifies if the sequence value
will be used by default when the
@collection-type
attribute is not specified. This option is helpful if you want to have Next and Previous navigational buttons generated for all HTML pages. Allowed values are no (default) and yes. - webhelp.enable.search.autocomplete
- Specifies if the Autocomplete
feature is enabled in the WebHelp search text field. The default value is
yes
. - webhelp.enable.html.fragments.cleanup
- Enables or disables the automatic conversion of HTML fragments to well-formed XML. If set to true (default), the transformation automatically converts non-well-formed HTML content to a well-formed XML equivalent. If set to false, the transformation will fail if at least one HTML fragment is not well-formed.
- webhelp.enable.scroll.to.search.term
- Specifies whether or not the page should scroll to the first search term when opening the search results page. Possible values are no (default) and true.
- webhelp.fragment.after.body
- This parameter can be used to display a given XHTML fragment after the body in all types of pages. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.after.body.main.page
- This parameter can be used to display a given XHTML fragment after the body in the main page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.after.body.topic.page
- This parameter can be used to display a given XHTML fragment after the body in the topic page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.after.body.search.page
- This parameter can be used to display a given XHTML fragment after the body in the search results page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.after.body.terms.page
- This parameter can be used to display a given XHTML fragment after the body in the index terms page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.after.logo_and_title
- This parameter can be used to display a given XHTML fragment after the logo and title in all types of pages. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.after.search.input
- This parameter can be used to display a given XHTML fragment after the search field in all types of pages. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.after.main.page.search (deprecated)
- This parameter is deprecated. Use
webhelp.fragment.after.search.input.main.page
instead. - webhelp.fragment.after.search.input.main.page
- This parameter can be used to display a given XHTML fragment after the search field in all the main page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.after.search.input.topic.page
- This parameter can be used to display a given XHTML fragment after the search field in all the topic page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.after.search.input.search.page
- This parameter can be used to display a given XHTML fragment after the search field in all the search results page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.after.search.input.terms.page
- This parameter can be used to display a given XHTML fragment after the search field in all the index terms page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.after.toc_or_tiles
- This parameter can be used to display a given XHTML fragment after the table of contents or tiles in the main page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.after.top_menu
- This parameter can be used to display a given XHTML fragment after the top menu in all types of pages. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.before.body
- This parameter can be used to display a given XHTML fragment before the page body in all types of pages. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.before.body.main.page
- This parameter can be used to display a given XHTML fragment before the page body in the main page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.before.body.topic.page
- This parameter can be used to display a given XHTML fragment before the page body in the topic page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.before.body.search.page
- This parameter can be used to display a given XHTML fragment before the page body in the search results page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.before.body.terms.page
- This parameter can be used to display a given XHTML fragment before the page body in the index terms page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.before.logo_and_title
- This parameter can be used to display a given XHTML fragment before the logo and title. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.before.search.input
- This parameter can be used to display a given XHTML fragment before the search field in all types of pages. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.before.main.page.search (deprecated)
- This parameter is deprecated.
Use
webhelp.fragment.before.search.input.main.page
instead. - webhelp.fragment.before.search.input.main.page
- This parameter can be used to display a given XHTML fragment before the search field in the main page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.before.search.input.topic.page
- This parameter can be used to display a given XHTML fragment before the search field in the topic page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.before.search.input.search.page
- This parameter can be used to display a given XHTML fragment before the search field in the search results page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.before.search.input.terms.page
- This parameter can be used to display a given XHTML fragment before the search field in the index terms page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.before.toc_or_tiles
- This parameter can be used to display a given XHTML fragment before the table of contents or tiles in the main page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.before.top_menu
- This parameter can be used to display a given XHTML fragment before the top menu in all types of pages. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.footer
- This parameter can be used to display a given
XHTML fragment as the page footer in all types of pages. The value of the parameter
can be either a well-formed XHTML fragment or a path to a file that contains a
well-formed XHTML fragment.Important: This parameter should only be used if you are using a valid, purchased license of Oxygen XML Editor (do not use it with a trial license).
- webhelp.fragment.head
- This parameter can be used to display a given XHTML fragment in the header section in all types of pages. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.head.main.page
- This parameter can be used to display a given XHTML fragment in the header section in the main page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.head.topic.page
- This parameter can be used to display a given XHTML fragment in the header section in the topic page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.head.search.page
- This parameter can be used to display a given XHTML fragment in the header section in the search results page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.head.terms.page
- This parameter can be used to display a given XHTML fragment in the header section in the index terms page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.welcome
- This parameter can be used to display a given XHTML fragment as a welcome message (or title). The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.after.header
- This parameter can be used to display a given XHTML fragment after the header section in all types of pages. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.after.header.main.page
- This parameter can be used to display a given XHTML fragment after the header section in the main page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.after.header.topic.page
- This parameter can be used to display a given XHTML fragment after the header section in the topic page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.after.header.search.page
- This parameter can be used to display a given XHTML fragment after the header section in the search results page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.after.header.terms.page
- This parameter can be used to display a given XHTML fragment after the header section in the index terms page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.before.search.input
- This parameter can be used to display a given XHTML fragment before the search field in all types of pages. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.after.search.input
- This parameter can be used to display a given XHTML fragment after the search field in all types of pages. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.before.main.content.area
- This parameter can be used to display a given XHTML fragment before the main content section in all types of pages. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.before.main.content.area.main.page
- This parameter can be used to display a given XHTML fragment before the main content section in the main page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.before.main.content.area.topic.page
- This parameter can be used to display a given XHTML fragment before the main content section in the topic page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.before.main.content.area.search.page
- This parameter can be used to display a given XHTML fragment before the main content section in the search results page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.before.main.content.area.terms.page
- This parameter can be used to display a given XHTML fragment before the main content section in the index terms page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.after.main.content.area
- This parameter can be used to display a given XHTML fragment after the main content section in all types of pages. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.after.main.content.area.main.page
- This parameter can be used to display a given XHTML fragment after the main content section in the main page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.after.main.content.area.topic.page
- This parameter can be used to display a given XHTML fragment after the main content section in the topic page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.before.topic.toolbar
- This parameter can be used to display a given XHTML fragment before the toolbar buttons above the topic content in the topic page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.after.topic.toolbar
- This parameter can be used to display a given XHTML fragment after the toolbar buttons above the topic content in the topic page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.before.topic.breadcrumb
- This parameter can be used to display a given XHTML fragment before the breadcrumb component in the topic page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.after.topic.breadcrumb
- This parameter can be used to display a given XHTML fragment after the breadcrumb component in the topic page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.before.publication.toc
- This parameter can be used to display a given XHTML fragment before the publication's table of contents component in the topic page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.after.publication.toc
- This parameter can be used to display a given XHTML fragment before the publication's table of contents component in the topic page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.before.topic.content
- This parameter can be used to display a given XHTML fragment before the topic's content in the topic page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.after.topic.content
- This parameter can be used to display a given XHTML fragment after the topic's content in the topic page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.before.feedback
- This parameter can be used to display a given XHTML fragment before the Oxygen Feedback commenting component in the topic page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.after.feedback
- This parameter can be used to display a given XHTML fragment after the Oxygen Feedback commenting component in the topic page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.before.topic.toc
- This parameter can be used to display a given XHTML fragment before the topic's table of contents component in the topic page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.after.topic.toc
- This parameter can be used to display a given XHTML fragment after the topic's table of contents component in the topic page. The value of the parameter can be either a well-formed XHTML fragment or a path to a file that contains a well-formed XHTML fragment.
- webhelp.fragment.custom.search.engine.results
- This parameter can be used to replace the search results area with custom XHTML content. The value of the parameter is the path to an XHTML file that contains your custom content.
- webhelp.fragment.custom.search.engine.script
- This parameter can be used to replace WebHelp's built-in search engine with your own custom search engine. The value of the parameter is the path to an XHTML file that contains the scripts required for your custom search engine to run.
- webhelp.labels.generation.mode
-
Controls whether or not labels are generated in the output. These labels are useful because users can easily search for topics with the same label by simply clicking on the label presented in the output. Possible values are:
- keywords-label - Generates labels for each defined
<keyword>
element that has the@outputclass
attribute value set to label. - keywords - Generates labels for each defined
<keyword>
element. If the topic contains<keyword>
elements with the@outputclass
attribute value set to label, then only these elements will have labels generated for them in the output. - disable - Disables the generation of labels in the Webhelp Responsive output.
- keywords-label - Generates labels for each defined
- webhelp.merge.nested.topics.related.links
- Specifies if the related links
from nested topics will be merged with the links in the parent topic. Thus the links
will be moved from the topic content to the related links component and all of the
links from the same group (for example, Related Tasks, Related
References, Related Information) are merged into a single group. The
default value is
yes
. - webhelp.publication.toc.hide.chunked.topics
- Specifies if the table of contents
will contain links for chunked topics. The default value is
yes
. - webhelp.publication.toc.links
- Specifies which links will be included in the
table of contents. The possible values are:
- chapter (default) - The TOC will include links for the current topic, its children, its siblings, and its direct ancestor (including the direct ancestor's siblings), and the parent chapter.
- topic - The TOC will only include links for the current topic and its direct children.
- all - The TOC will include all links.
- webhelp.publication.toc.tooltip.position
- By default, if a topic contains a
<shortdesc>
element, its content is displayed in a tooltip when the user hovers over its link in the table of contents. This parameter controls whether or not this tooltip is displayed and its position relative to the link. The possible values are:- left
- right (default)
- top
- bottom
- hidden - The tooltip will not be displayed.
- webhelp.search.default.operator
- Makes it possible to change the default
operator for the search engine. Possible values are
and
,or
(default). If set toand
while the search query is WORD1 WORD2, the search engine only returns results for topics that contain both WORD1 and WORD2. If set toor
and the search query is WORD1 WORD2, the search engine returns results for topics that contain either WORD1 or WORD2. - webhelp.search.stop.words.exclude
- Specifies a list of words that will be
excluded from the default list of stop words that are filtered out before the
search processing. Use comma separators to specify more than one word (for example:
if,for,is
). - webhelp.show.breadcrumb
- Specifies if the breadcrumb component will be
presented in the output. The default value is
yes
. - webhelp.show.child.links
- Specifies if child links will be generated in
the output for all topics that have subtopics. The default value is
no
. - webhelp.show.indexterms.link
- Specifies if an icon that links to the index
terms page will be displayed in the output. The default value is
yes
(meaning the index terms icon is displayed). If set tofalse
, the index terms icon is not displayed in the output and the index terms page is not generated. - webhelp.show.main.page.tiles
- Specifies if the tiles component will be
presented in the main page of the output. For a tree style layout, this
parameter should be set to
no
. - webhelp.show.main.page.toc
- Specifies if the table of contents will be
presented in the main page of the output. The default value is
yes
. - webhelp.show.navigation.links
- Specifies if navigation links will be
presented in the output. The default value is
yes
. - webhelp.show.print.link
- Specifies if a print link or icon will be
presented within each topic in the output. The default value is
yes
. - webhelp.show.related.links
- Specifies if the related links component will
be presented in the WebHelp Responsive output. The default value is
yes
. Thewebhelp.merge.nested.topics.related.links
parameter can be used in conjunction with this one to merge the related links from nested topics into the links in the parent topic. - webhelp.show.publication.toc
- Specifies if a table of contents will be presented
on the left side of each topic in the output. The default value is
yes
. - webhelp.show.topic.toc
- Specifies if a topic table of contents will be
presented on the right side of each topic in the output. This table of contents
contains links to each
<section>
within the current topic that contains an@id
attribute and the section corresponding to the current scroll position is highlighted. The default value isyes
. - webhelp.show.top.menu
- Specifies if a menu will be presented at the topic
of the main page in the output. The default value is
yes
. - webhelp.skip.main.page.generation
- If set to
true
, the default main page is not generated in the output. The default value isfalse
. - webhelp.top.menu.activated.on.click
- When this parameter is activated (set to
yes
), clicking an item in the top menu will expand the submenu (if available). You can then click on a submenu item to open the item (topic). You can click outside the menu or press ESC to hide the menu. When set tono
(default), hovering over a menu item displays the menu content. - webhelp.top.menu.depth
- Specifies the maximum depth level of the topics
that will be included in the top menu. The default value is
3
. A value of0
means that the menu has unlimited depth. - webhelp.topic.collapsible.elements.initial.state
- Specifies the initial
state of collapsible elements (tables with titles, nested topics with titles, sections
with titles, index term groups). The possible values are
collapsed
orexpanded
(default value).
Parameters for Adding a Link to PDF Documentation in WebHelp Responsive Output
The following transformation parameters can be used to generate a PDF link component in the WebHelp Responsive output (for example, it could link to the PDF equivalent of the documentation):
- webhelp.pdf.link.url
- Specifies the target URL for the PDF link component.
- webhelp.pdf.link.text
- Specifies the text for the PDF link component.
- webhelp.pdf.link.icon.path
- Specifies the path or URL of the image icon to be used for the PDF link component. If not specified, a default icon is used.
- webhelp.show.pdf.link
- Specifies whether or not the PDF link component is shown in the WebHelp Responsive output. Allowed values are: yes (default) and no.
- webhelp.pdf.link.anchor.enabled
- Specifies whether or not the current topic ID should be appended as the name destination at the end of the PDF link. Allowed values are: yes (default) and no.