WebHelp not recognizing "webhelp.fragment.before.topic.content"

[davenz]

Hi folks,

To surface metadata labels in WebHelp output, I'm doing the changes that Alin kindly documented in https://github.com/oxygenxml/oxygen-pub ... ta-in-body

A fragment placeholder parameter of "webhelp.fragment.before.topic.content" in my .opt file does not result in WebHelp adding the "audience-container" class to the output CSS.

If I use a placeholder parameter of "webhelp.fragment.before.body", the class is created and the audience label shows in an odd location (see the attached "before-body.png" image).

before-body.png (27.59 KiB) Viewed 1275 times

My fragment file and customization CSS is exactly as Alin has documented in https://github.com/oxygenxml/oxygen-pub ... ta-in-body. This is my .opt file for WebHelp:

Code: Select all

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<publishing-template>
    <name>webhelp-responsive-1</name>
    <description></description>
    <webhelp>
        <preview-image file="oxygen-tiles.png"/>
        <parameters>
            <parameter name="webhelp.show.main.page.tiles" value="yes"/>
            <parameter name="webhelp.show.main.page.toc" value="no"/>
            <parameter name="args.figurelink.style" value="TITLE"/>
            <parameter name="args.tablelink.style" value="TITLE"/>
            <parameter name="clean.output" value="yes"/>
            <parameter name="force-unique" value="true"/>
            <parameter name="webhelp.publication.toc.tooltip.position" value="right"/>
            <parameter name="webhelp.top.menu.depth" value="0"/>
			<parameter name="webhelp.show.child.links" value="yes"/>
			<parameter name="webhelp.logo.image" value="docs-home-logo-1.svg" type="filePath"/>
			<parameter name="webhelp.fragment.footer" value="webhelp-footer.xml" type="filePath"/>
			<parameter name="webhelp.logo.image.target.url" value="https://www.example.com
		</parameters>
        <resources>
            <css file="oxygen.css"/>
			<css file="customization/topic-metadata-multi-label-test.css"/>
			<fileset>
                <include name="resources/**/*"/>
                <exclude name="resources/**/*.svn"/>
                <exclude name="resources/**/*.git"/>
            </fileset>
        </resources>
		<html-fragments>
		    <fragment placeholder="webhelp.fragment.before.topic.content" file="customization/fragments/topic-meta-multi-label-test.xml"/>
			<fragment placeholder="webhelp.fragment.head" file="customization/fragments/google-analytics.xml"/>
        </html-fragments>
    </webhelp>
</publishing-template>

We are using WebHelp 21 and I've reverted our WebHelp CSS to the factory default for troubleshooting.

Any help would be great -- thanks.

before-body.png (27.59 KiB) Viewed 1275 times

[Costin]

Hi davenz,

The "webhelp.fragment.before.topic.content" was not available in the old version 21 so that is why it has no effect.
If you need to use this parameter you need to use at least the version 23.1.
According to the Upgrade eligibility period section from our Upgrade Policy, upgrades may be purchased only for versions that did not reach End-Of-Life by more than 12 months ago, but we can make a one-time-only exception for you, so you could still purchase an Upgrade to the latest version.

Regards,
Costin

[davenz]

Hi Costin,

Thanks for looking into -- that explains it! I'll be in touch about your one-time upgrade offer.

Thanks,
Dave

[davenz]

Hi Costin -- just a note to say thanks and everything is working as expected now with the correct WebHelp version!