Oxygen XML Forum

Posted: **Thu Aug 10, 2023 3:14 am**

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

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

Posted: **Thu Aug 10, 2023 10:52 am**

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

Posted: **Sun Aug 13, 2023 11:11 pm**

Hi Costin,

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

Thanks,
Dave

Posted: **Fri Sep 08, 2023 3:39 am**

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

Oxygen XML Forum

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

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

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

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

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