Hi, Hussein:

I think I am getting close to solving this. But when I convert a book to web help, I hit the following error:

Invoking method
"com.xmlmind.xmleditext.whc.CompileWebHelp.compile"
with arguments
"docb.toWebHelp"
"wh_resources/footer.html", invalid value for parameter "user-footer"

I'm not sure why I'm hitting this because I created document conversion parameters (I think) exactly as shown in the example you provided earlier (screenshot attached). I also created a /wh_resources/ directory at the root level of my book files (see screenshot). That directory contains all the same files as the example source you shared with me. Thank you for that!

My guess is I may be missing the "XHTML file containing <div id="wh-header"> or <div id="wh-footer">" but I am not sure.

Any suggestions would be appreciated.

Thanks,
Pierce


On 7/19/2014 2:55 AM, Hussein Shafie wrote:
On 07/18/2014 09:23 PM, Pierce Tyler wrote:

I am using the pro version 5.9.0 to generate web help--and am trying to
insert a custom header just like the one in the XMLmind XML Editor -
Online Help example:

http://www.xmlmind.com/xmleditor/_distrib/doc/help/wh/index.html

I see from your example you were able to insert your header into the
body somehow. Do you have any tips on how to do this?

I tried to solve this by creating a customized .css which put an image and text "before" the body defined by __stock_webhelp.css. This looks
good at first, but on closer inspection we find that the last bit of
content in our longer sections cannot be viewed when scrolled down to. What's missing in the content is an area about equal to the size of the hacked in header we inserted. You can see an example of what I'm talking
about here:

http://www.xtuple.org/sites/default/files/refguide/current/dspSingleLevelBOM.html


Please remove your CSS customization as it may gets in the way.

This is done by passing the XSL stylesheets parameter wh-user-header and/or wh-user-footer.

These parameters must point to an XHTML file containing
<div id="wh-header"> or <div id="wh-footer">.

You'll find the documentation of these parameters here:

http://www.xmlmind.com/ditac/_distrib/doc/manual/xsltParams.html#xsltParams__wh-user-header

http://www.xmlmind.com/ditac/_distrib/doc/manual/xsltParams.html#xsltParams__wh-user-footer

http://www.xmlmind.com/ditac/_distrib/doc/manual/xsltParams.html#xsltParams__wh-user-css

Yes, we use the same WebHelp compiler for DocBook and for DITA. However we have documented this WebHelp compiler only in the case of DITA.

DocBook example:

---
xxetool convert -p toc.section.depth 4 \
    -p chunk.section.depth 2 \
    -p use.id.as.filename 1 \
    -p olink.doctitle yes \
    -p current.docid help \
    -pu target.database.document ../common/doc_html.sitemap \
    -p wh-collapse-toc yes \
    -p wh-user-header wh_resources/header.html \
    -p wh-user-footer wh_resources/footer.html \
    -p wh-user-css wh_resources/header_footer.css \
    -p wh-user-resources wh_resources/header_footer_files \
    docb.toWebHelp help.xml -u $(DOC_DIR)/wh
---

where header.html, footer.html and header_footer.css are attached to this email.

TIP: xxetool is XXE without a GUI. See http://www.xmlmind.com/xmleditor/_distrib/doc/xxetool/index.html. Works the same with XXE, except that you must specify absolute URLs for header.html, footer.html and header_footer.css




--
Pierce Tyler
VP Knowledge Management @xTuple

--
XMLmind XML Editor Support List
[email protected]
http://www.xmlmind.com/mailman/listinfo/xmleditor-support

Reply via email to