Page 1 of 1

Editing a DocBook transformation scenario

Posted: Thu Jun 01, 2017 12:39 pm
by ManuelS
Hi,

I created an XML DocBook Document and published it with the Built-in Transformation Scenario of DocBook 5 - everything is fine so far. But now I'd like to edit this Transformation Scenario. For example I'd like to change the font and icon of the safety note.

I guess it's no big deal but this working environment is totally new to me.

I am using the latest version of oXygen.

Kind regards
Manuel

Re: Editing a DocBook transformation scenario

Posted: Thu Jun 01, 2017 4:57 pm
by Costin
Hello,

Specifically, which transformation scenario are you trying to apply in oXygen? What is the type of output you need to obtain?
If possible, in order to better understand what you need to achieve, please sens us a sample file containing the safety note you need to change. You could use our official support email (support AT oxygenxml DOT com) to send the sample file.

Best Regards,
Costin

Re: Editing a DocBook transformation scenario

Posted: Fri Jun 02, 2017 10:26 am
by ManuelS
Costin wrote: which transformation scenario are you trying to apply in oXygen?


DocBook PDF and DocBook HTML

Re: Editing a DocBook transformation scenario

Posted: Fri Jun 02, 2017 2:33 pm
by Radu
Hi,

Oxygen uses the open source Docbook Project:

http://docbook.sourceforge.net/

in order to publish Docbook content to various output sources.
If you duplicate and edit one of the predefined Docbook transformation scenarios (for PDF and HTML for example), there is a Parameters button which allows you to edit various Docbook-related parameters.
You can find documentation for all Docbook parameters (the ones for HTML and the ones for FO-PDF) here:

http://docbook.sourceforge.net/release/xsl/1.75.2/doc/param.html

there is also a Docbook Apps users list:

http://docbook.org/help

on which you can register and ask questions to the large Docbook community. We (the Oxygen team) do not use Docbook internally so we may not be able to help much with questions involving Docbook customizations.

About your question related to the "safety" note, all Docbook related images can be found here:

OXYGEN_INSTALL_DIR\frameworks\docbook\xsl\images

Regards,
Radu

Re: Editing a DocBook transformation scenario

Posted: Sat Jun 03, 2017 6:23 pm
by ManuelS
Thank you very much so far. Your tips were very helpful!

Now I need to know how to change the admonition titles because "note" or "caution" isn't really usefull in a german documentation. It isn't possible to change that in the parameters, right?


I also need to know how to create space to place some corporate identity logos (images) in my documents. Maybe in a head or footer.

Many thanks in advance!

Re: Editing a DocBook transformation scenario

Posted: Mon Jun 05, 2017 8:08 am
by Radu
Hi,

About your first question, in the folder OXYGEN_INSTALL_DIR\frameworks\docbook\xsl\common\ there are various language-dependent XML files like en.xml. If you look in one of them, it has mappings like:

[url]<l:gentext key="Important" text="Important"/>[/url]

There is a topic in the Docbook docs discussing internationalization:

http://www.sagehill.net/docbookxsl/Localizations.html

About modifying headers and footers, there also seems to be a topic about that:

http://www.sagehill.net/docbookxsl/PrintHeaders.html

but we do not use Docbook much internally so I have not tried it myself.

Regards,
Radu

Re: Editing a DocBook transformation scenario

Posted: Wed Jun 21, 2017 12:52 pm
by ManuelS
Hi,

I'd like to change the font of the html transformation scenario of Docbook 5. There is no parameter body.font.family like in the transformation scenario of pdf that i could change easily. Is there any alternative?

Kind regards
Manuel

Re: Editing a DocBook transformation scenario

Posted: Wed Jun 21, 2017 1:39 pm
by Radu
Hi Manuel,

Maybe this should be done with a custom CSS stylesheet. There is a Docbook parameter allowing you to set a custom CSS:

http://docbook.sourceforge.net/release/xsl/current/doc/html/custom.css.source.html

You can use the web browser's CSS Inspector Tools to look at how the resulting HTML is structured and see how a CSS selector changing the font size for the entire HTML would look like. Probably something like :root {font-family:"Times New Roman";} would work.

Regards,
Radu