Help Customizing xsd Documentation
This should cover W3C XML Schema, Relax NG and DTD related problems.
Help Customizing xsd Documentation
Hello Everyone,
we are searching for a tool to create a custom .xsd documenation (in PDF form) and I started evaluating oxygen.
The generated xsd-documentation is really nice i have to say, but i need to customize the layout a bit, to fit our needs.
Currently im trying to customize my .xsd documentation.
My Goal is to have a custom frontpage(text and image) and a custom footer (text and image) on every other page.
Since i dont have any experience in this field, im have some difficulties. Im trying to follow these steps https://www.oxygenxml.com/doc/versions/ ... ation.html but without much success for now.
Sadly im already failing to understand step 1. I found the file and the needed location in it, but I have no idea what i'll need to enter here...
Can anyone explain the needed steps a bit more in depth?
Your help is very much appreciated!!
Best Regards
Christian
we are searching for a tool to create a custom .xsd documenation (in PDF form) and I started evaluating oxygen.
The generated xsd-documentation is really nice i have to say, but i need to customize the layout a bit, to fit our needs.
Currently im trying to customize my .xsd documentation.
My Goal is to have a custom frontpage(text and image) and a custom footer (text and image) on every other page.
Since i dont have any experience in this field, im have some difficulties. Im trying to follow these steps https://www.oxygenxml.com/doc/versions/ ... ation.html but without much success for now.
Sadly im already failing to understand step 1. I found the file and the needed location in it, but I have no idea what i'll need to enter here...
Can anyone explain the needed steps a bit more in depth?
Your help is very much appreciated!!
Best Regards
Christian
Re: Help Customizing xsd Documentation
Hi Christian,
As a pre-requisite you will need some knowledge of XSLT and XSL-FO.
Let's try this approach:
When you generate XML Schema documentation you can choose to generate it in a ""Docbook" format.
After this, open the generated Docbook file. Docbook is an XML vocabulary for which Oxygen has default editing and publishing support.
If you open a Docbook file in Oxygen, there is a "Configure Transformation Scenarios" dialog which allows you to publish it to various output formats.
The Docbook to PDF output takes Docbook, converts it using XSLT stylesheets to an XSL-FO file and then applies a PDF processor to obtain the final PDF.
The Docbook XSLs for generating the XSL-FO are located in:
OXYGEN_INSTALL_DIR\frameworks\docbook\xsl\fo
and there is free documentation available online about customizing the Docbook PDF:
http://www.sagehill.net/docbookxsl/PrintHeaders.html
Regards,
Radu
As a pre-requisite you will need some knowledge of XSLT and XSL-FO.
Let's try this approach:
When you generate XML Schema documentation you can choose to generate it in a ""Docbook" format.
After this, open the generated Docbook file. Docbook is an XML vocabulary for which Oxygen has default editing and publishing support.
If you open a Docbook file in Oxygen, there is a "Configure Transformation Scenarios" dialog which allows you to publish it to various output formats.
The Docbook to PDF output takes Docbook, converts it using XSLT stylesheets to an XSL-FO file and then applies a PDF processor to obtain the final PDF.
The Docbook XSLs for generating the XSL-FO are located in:
OXYGEN_INSTALL_DIR\frameworks\docbook\xsl\fo
and there is free documentation available online about customizing the Docbook PDF:
http://www.sagehill.net/docbookxsl/PrintHeaders.html
Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
<oXygen/> XML Editor
http://www.oxygenxml.com
Re: Help Customizing xsd Documentation
Hi Radu,
thanks for your quick reply!
Ok that seems like a route to go. But when i create a docbook from the xsd and use this docbook (without any customization) to transform it to a pdf (with the default docbook->pdf transformation) i get some malformed tables in my resulting pdf (See below)
Do I have to adjust some settings here, or what is going on?
Just to mention it, I do not have these malformed tables, when i directly generate a pdf from the xsd.
Best Regards
Christian
thanks for your quick reply!
Ok that seems like a route to go. But when i create a docbook from the xsd and use this docbook (without any customization) to transform it to a pdf (with the default docbook->pdf transformation) i get some malformed tables in my resulting pdf (See below)
Do I have to adjust some settings here, or what is going on?
Just to mention it, I do not have these malformed tables, when i directly generate a pdf from the xsd.
Best Regards
Christian
-
- Posts: 1008
- Joined: Wed Nov 16, 2005 11:11 am
Re: Help Customizing xsd Documentation
Post by alex_jitianu »
Hi Christian,
We are applying a customized version of the Docbook-FO stylesheet. You can find it at {oxygenInstallDir}/frameworks/docbook/oxygen/xsdDocDocbookCustomizationFO.xsl. To use it, duplicate the Docbook PDF scenario and change the XSL URL to point to previously mentioned path.
Best regards,
Alex
We are applying a customized version of the Docbook-FO stylesheet. You can find it at {oxygenInstallDir}/frameworks/docbook/oxygen/xsdDocDocbookCustomizationFO.xsl. To use it, duplicate the Docbook PDF scenario and change the XSL URL to point to previously mentioned path.
Best regards,
Alex
Jump to
- Oxygen XML Editor/Author/Developer
- ↳ Feature Request
- ↳ Common Problems
- ↳ DITA (Editing and Publishing DITA Content)
- ↳ SDK-API, Frameworks - Document Types
- ↳ DocBook
- ↳ TEI
- ↳ XHTML
- ↳ Other Issues
- Oxygen XML Web Author
- ↳ Feature Request
- ↳ Common Problems
- Oxygen Content Fusion
- ↳ Feature Request
- ↳ Common Problems
- Oxygen JSON Editor
- ↳ Feature Request
- ↳ Common Problems
- Oxygen PDF Chemistry
- ↳ Feature Request
- ↳ Common Problems
- Oxygen Feedback
- ↳ Feature Request
- ↳ Common Problems
- Oxygen XML WebHelp
- ↳ Feature Request
- ↳ Common Problems
- XML
- ↳ General XML Questions
- ↳ XSLT and FOP
- ↳ XML Schemas
- ↳ XQuery
- NVDL
- ↳ General NVDL Issues
- ↳ oNVDL Related Issues
- XML Services Market
- ↳ Offer a Service