- Project information
- IF_GAACCOUNT: True means the configuration includes a Google Analytics account.
Publishing information - Build IDs: True means the ID has been selected in the current publishing task. IDs may be author-defined or predefined (IF_EBOOK, etc).
- Output settings: IF_INDEX_PAGE, IF_SEARCH_PAGE, IF_XHTML, IF_FRAMES.
TOC-relative information - Tests existence of topics before or after the current topic, e.g. IF_NEXT_PAGE.
- Whether <%TOPIC_BREADCRUMBS%> is empty.
Topic information - Tests whether the current topic has a header, toggles, featured image.
I propose you expose two extra types of information for use in Webhelp template expressions. To avoid potential problems overlapping with existing names, you could add a prefix or suffix, e.g. "_TOPIC" as below.
(A) Topic text variables
Test the value of a text variable in the context of the current topic, where True means the variable contains a value, and False means it is empty. For example, if I have a variable <%UNLOCKED%> whose default value is empty, then IF_UNLOCKED_TOPIC is False by default, but True for each topic where the default value has been overridden.
(B) TOC entry build ID
Test whether this topic's entry in the current TOC has been assigned a particular build ID, where True means this topic's TOC entry has the given ID. This is not the same as testing whether the current publishing task includes the build ID. For example, if I have a build ID called "Premium", the existing IF_/IFNOT_PREMIUM expressions test whether the Premium checkbox is selected on the publishing task. I'm suggesting an extra pair of expressions (e.g.) IF/IFNOT_PREMIUM_TOPIC to test whether this topic has this build ID in the TOC. H&M predefined build IDs should be evaluated the same way, e.g. IF_HTML_TOPIC would test whether the current topic has either the HTML or the 'ALL' build ID set.
To be useful, these extra features must be compatible with existing conditional syntax, so compound expressions like <IF_PREMIUM|UNLOCKED_TOPIC>...</IF_PREMIUM|UNLOCKED_TOPIC> and <IFNOT_PREMIUM><IF_PREMIUM_TOPIC>...</IF_PREMIUM_TOPIC></IFNOT_PREMIUM> are valid.
A typical use case and benefits can be seen at Public vs privileged webhelp build.
Thanks for considering this.