Customize footer
Customize footer
I tried to add the path to an xhtml file with footer content in the parameter webhelp.fragment.footer in the transformation scenario, bit no success. I also tried adding it in a ccs file but no luck, the actual path text i shown in the footer. Then I read here in the forum that I need a certain plugin for the "customize footer" function to work. Is that correct? I suppose that all available plugins show up in Preferences > Plugins?
thanks, Mikael
thanks, Mikael
Re: Customize footer
Hello,
You can customize the footer for the WebHelp output in two ways, as described in our user manual.
The simplest way to achieve this is to insert the HTML fragment directly in the transformation scenario dialog. For this, you need to set the webhelp.fragment.footer parameter to a small well-formed XHTML fragment. Or you can save the fragment as a new file and set its path in the webhelp.fragment.footer parameter value.
If you are using a publishing template to customize your WebHelp output, you should add the fragment or the path to the XHTML file in the descriptor file of the publishing template.
When only the file path appears in the footer of WebHelp output, usually there is an issue either with an incorrect file path set to the
webhelp.fragment.footer parameter or with the file content (it is not well-formed).
Regards,
Marius
You can customize the footer for the WebHelp output in two ways, as described in our user manual.
The simplest way to achieve this is to insert the HTML fragment directly in the transformation scenario dialog. For this, you need to set the webhelp.fragment.footer parameter to a small well-formed XHTML fragment. Or you can save the fragment as a new file and set its path in the webhelp.fragment.footer parameter value.
If you are using a publishing template to customize your WebHelp output, you should add the fragment or the path to the XHTML file in the descriptor file of the publishing template.
When only the file path appears in the footer of WebHelp output, usually there is an issue either with an incorrect file path set to the
webhelp.fragment.footer parameter or with the file content (it is not well-formed).
Regards,
Marius
Marius Ciolacu
Syncro Soft / Oxygen XML
Syncro Soft / Oxygen XML
Re: Customize footer
Thanks Marius.
Ok so extra plugin needed for this?
To see if I'm on the right track, could you say if the attached example qualifies as a well-formed xhtml file?
/Mikael
Ok so extra plugin needed for this?
To see if I'm on the right track, could you say if the attached example qualifies as a well-formed xhtml file?
- xhtmlExample.png (42.93 KiB) Viewed 1543 times
- Attachments
-
- image.png (42.93 KiB) Viewed 1543 times
-
chrispitude
- Posts: 915
- Joined: Thu May 02, 2019 2:32 pm
Re: Customize footer
Hi MWdal,
"Well-formed" is actually a specific reference to having the opening and closing tags balance each other (among other things):
https://en.wikipedia.org/wiki/Well-form ... quirements
If you put your content in a file and open it with Oxygen, the Oxygen editor will validate the document for you to ensure it is well-formed. I think of XHTML as HTML that follows the XML well-formed rules.
The content you included is not well-formed XHTML because the <br> tag must close itself (<br/>) in XHTML, unlike in regular HTML.
You might want to attach your files as zipped text files, as we cannot open image files in an Oxygen editor to evaluate them.
"Well-formed" is actually a specific reference to having the opening and closing tags balance each other (among other things):
https://en.wikipedia.org/wiki/Well-form ... quirements
If you put your content in a file and open it with Oxygen, the Oxygen editor will validate the document for you to ensure it is well-formed. I think of XHTML as HTML that follows the XML well-formed rules.
The content you included is not well-formed XHTML because the <br> tag must close itself (<br/>) in XHTML, unlike in regular HTML.
You might want to attach your files as zipped text files, as we cannot open image files in an Oxygen editor to evaluate them.
-
chrispitude
- Posts: 915
- Joined: Thu May 02, 2019 2:32 pm
Re: Customize footer
Hi MWdal,
Actually, there is a better description of well-formed in Oxygen's WebHelp documentation here:
https://www.oxygenxml.com/doc/versions/ ... -html.html
including a description of how to use an enclosing <html> root element that is unwrapped when you need to insert a sequence of multiple elements.
Actually, there is a better description of well-formed in Oxygen's WebHelp documentation here:
https://www.oxygenxml.com/doc/versions/ ... -html.html
including a description of how to use an enclosing <html> root element that is unwrapped when you need to insert a sequence of multiple elements.
Re: Customize footer
Ok got it. I opened the xhtml file in Oxygen and fixed the errors it showed. I also moved it to the same folder as the css descriptor files and the templates. But still the footer only shows the text that is in the parameter value in the template file - the file name footer.xhtml in this case.
Unfortunately due to company restrictions I can't attach any files, but since oxygen validated the file it should be ok. Seems Im missing something..
Unfortunately due to company restrictions I can't attach any files, but since oxygen validated the file it should be ok. Seems Im missing something..
-
chrispitude
- Posts: 915
- Joined: Thu May 02, 2019 2:32 pm
Re: Customize footer
Hi MWdal,
I already had a small testcase I've been experimenting with, so I reduced it to just implementing a footer:
Just publish the deliverable in the "project.xml" file. (You can right-click it and choose Transform with from the context menu, or you can open it in the editor and use the transformation button in the toolbar.)
Note that the footer HTML contains two separate child elements, and the footer.css file applies some CSS flexbox properties to push them apart to the left and right sides.
If this testcase works for you, maybe you can successively modify it to yours (or yours to it) until you find the problematic setting.
I already had a small testcase I've been experimenting with, so I reduced it to just implementing a footer:
Just publish the deliverable in the "project.xml" file. (You can right-click it and choose Transform with from the context menu, or you can open it in the editor and use the transformation button in the toolbar.)
Note that the footer HTML contains two separate child elements, and the footer.css file applies some CSS flexbox properties to push them apart to the left and right sides.
If this testcase works for you, maybe you can successively modify it to yours (or yours to it) until you find the problematic setting.
Re: Customize footer
With some trial and error I think I got it working now.
Thanks for the example!
/Mikael
Thanks for the example!
/Mikael