Hi, Hussein:
This information is very helpful. Thank you. I do have a couple of
related questions.
1. I'm not sure where to place the files: header.html, footer.html
and header_footer.css. Do I put these into
'xxe-config:docbook/xsl/webhelp/' or
'xxe-config:docbook/xsl/webhelp/wh_resources/' or some other location?
2. Also, the XHTML file you mentioned below, does that file already
exist? Or do I need to create it--and if so, where does it go?
Thanks again,
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
[email protected] <mailto:[email protected]>
<http://www.xtuple.com/xtuple-conference-2014>
<http://www.xtuple.com/xtuple-conference-2014>xTupleCon is October
13-18, 2014 <http://www.xtuple.com/xtuple-conference-2014>
User Conference for World's #1 Open Source ERP
Manufacturing – Distribution – eCommerce
--
XMLmind XML Editor Support List
[email protected]
http://www.xmlmind.com/mailman/listinfo/xmleditor-support
