Editing a DocBook transformation scenario

Questions about XML that are not covered by the other forums should go here.
ManuelS
Posts: 6

Editing a DocBook transformation scenario

Thu Jun 01, 2017 12:39 pm

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
Costin
Posts: 255

Re: Editing a DocBook transformation scenario

Thu Jun 01, 2017 4:57 pm

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
Costin Sandoi
oXygen XML Editor and Author Support
ManuelS
Posts: 6

Re: Editing a DocBook transformation scenario

Fri Jun 02, 2017 10:26 am

Costin wrote: which transformation scenario are you trying to apply in oXygen?


DocBook PDF and DocBook HTML
Radu
Posts: 5095

Re: Editing a DocBook transformation scenario

Fri Jun 02, 2017 2:33 pm

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
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
ManuelS
Posts: 6

Re: Editing a DocBook transformation scenario

Sat Jun 03, 2017 6:23 pm

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!
Radu
Posts: 5095

Re: Editing a DocBook transformation scenario

Mon Jun 05, 2017 8:08 am

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
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
ManuelS
Posts: 6

Re: Editing a DocBook transformation scenario

Wed Jun 21, 2017 12:52 pm

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
Radu
Posts: 5095

Re: Editing a DocBook transformation scenario

Wed Jun 21, 2017 1:39 pm

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
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com

Return to “General XML Questions”

Who is online

Users browsing this forum: No registered users and 1 guest