Hi Daniel,
CSS has progressed to the point where it can format
printed output, and I know of at least one product that can use CSS to generate
PDF output (Antenna House XSL Formatter http://www.antennahouse.com/product.htm).
But most people use DocBook's XSL-FO output (fo/docbook.xsl) and an XSL-FO
processor such as FOP to generate PDFs from DocBook content.
I believe someone pointed you to my online book
DocBook XSL: The Complete Guide at http://www.sagehill.net/docbookxsl/index.html.
I believe it has the information you need to customize your PDF output.
This link will get you started with parameter setting:
http://www.sagehill.net/docbookxsl/PrintOutput.html
and this one with titlepage
customization:
http://www.sagehill.net/docbookxsl/HTMLTitlePage.html
and this one will help with further
customizations:
http://www.sagehill.net/docbookxsl/PrintCustomEx.html
Bob Stayton
Sagehill Enterprises
----- Original Message -----
From:
To:
Sent: Monday, January 23, 2012 4:38
AM
Subject: Re: [docbook-apps] Customizing
and creating a stylesheet for docbook using the XML Mind or Oxygen XML
Editor
Hello,
sorry that it took so long, but I was quite
busy.
Thanks for all the
response - it made things easier for us.
The customization process is getting along pretty well,
but we still have some questions regarding the PDF Output:
As said before, we customized
Docbook to match our requirements. We basically added a few elements to the
schema and blocked those we didn’t want. The font size etc. is determined by
an css style sheet.
One
problem is, that most of our new styles are not recognized if we output a
document as a PDF. We already found the param.xml and pagesetup.xsl file, but
were not sure if it is necessary to customize them as well. Did we go wrong
using css instead of xsl as a stylesheet? Oxygen handles both, but it seems
like only xls is supported for creating a PDF.
Another problem that we have is, that we can´t really
figure out how to influence the general page layout (header, footer, graphic
on the front page etc.). Is there any tutorial or something?
Finally, at least for now, we are
wondering how to insert text boxes in line with the text, since in our current
configuration text boxes are always inserted below the paragraph.
Thanks for the help and
sorry if some questions might seem unnecessary. I´m not one of the XML guys in
the company, but rather one of those who write and translate.
Greetings,
Daniel
From:
To:
Date:
17.01.2012 09:44
Subject:
[docbook-apps] Customizing and creating
a stylesheet for docbook using the XML Mind or Oxygen XML
Editor
Hello,
currently my company is thinking about transferring its user
documentation into XML and docbook.
Since we are an IT company, XML and programming in general is not a
problem. But: We cannot find and adjust the stylesheet needed to create our
custom documentation.
We are
currently setting up a prototype for our documentation, following the
instructions from Walsh´s "DocBook 5: The definitive Guide" and working with
the XML Mind Editor and a trial version of "OXYGEN Editor".
Basically, we are satisfied with the
results and trust in docbooks function (since having lots of trouble with
Word), but the lacking transparency makes it really hard to come up with a sample
documentation/ prototype .Each file we open has at least one reference to a
website we cannot open and dozens of files that don´t exist or are really hard
to find. We checked the regular docbook.zip from the docbook homepage, but
also all files of the respective editors. (Is there something as a
"default" Docbook editor that you would propose?)
Can anyone give me some advice, a link or even a
how-to for adjusting the docbook stylesheet? Personally, I would love to use
docbook for our user documentation, simply for the additional features it has
compared to other text processing program, but only if I can adjust the
appearance. Especially regarding corporate identity this is absolutely
necessary.
Thanks and with best regards,
D. Keyes
=======================================================
Disclaimer
The
information contained in this e - mail and any attachments
( together the
"message") is intended for the addressee only and may
contain confidential
and/or privileged information. If you have received
the message by mistake
please delete it and notify the sender and do
not copy or distribute it or
disclose its contents to anyone.
FINARIS Financial Software Partner
GmbH
Sömmerringstr. 23, 60322 Frankfurt/Main, Germany
Registered at
Frankfurt/Main, HRB 52873
Managing Directors:
Dipl. Inf. Hermann
Friebel, Dipl. Ing. Kai Bächle, Dipl. Inf. Werner
Märkl
=======================================================
