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



Title: Header 2
Title: Footer 2
#page-header {
    background-color: #90D1F7;
    background-image: url(header_footer_files/top_gradient.png);
    background-repeat: repeat-x;
    background-position: top left;
    padding-top: 1ex;
    padding-left: 1ex;
    padding-right: 1ex;
    padding-bottom: 0.5ex;
    margin: 0;
}

#page-header-title {
    text-align: center;
    color: #484850;
    font-size: 200%;
    font-weight: bold;
}

#page-footer {
    color: gray;
    font-size: 85%;
    font-style: italic;
    padding: 0.5ex;
    margin: 0;
}
--
XMLmind XML Editor Support List
[email protected]
http://www.xmlmind.com/mailman/listinfo/xmleditor-support

Reply via email to