Re: [docbook-apps] Customizing and creating a stylesheet for docbook using the XML Mind or Oxygen XML Editor

[daniel.keyes@finaris.de]

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:	daniel.keyes@finaris.de
To:	docbook-apps@lists.oasis-open.org
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
=======================================================