RE: [docbook-apps] Customizing and creating a stylesheet for docbook using the XML Mind or Oxygen XML Editor
Hey, we finally managed to customize the PDF output. Some aspects still seem a bit mysterious, but we´ve got it. Thanks for the hint Bob! Nevertheless, we are not yet running out of questions: We are pretty much finished customizing our stylesheet, but still have a problem moving the list of figures and list of tables towards the appendix/ back of the document.. Our Documents are structured into: - Frontpage - Legal Notices -Table of content - Typographical conventions - Preface -Main body -Appendix ( shortcuts, glossary etc.) -List of figures - List of tables The problem is that we haven´t figured out yet how to shift the list of tables and list of figures from the front of the document ( between frontpage and legal notices ) to the back of the document ( after the appendix). The Appendix including the tables have a Heading TOC formatting ( A XYZ, B XYZ etc.) We have used xsl:param name=generate.toc appendix title,figure article title book toc,title chapter title part title preface title reference title sect1 title sect2 title sect3 title sect4 title sect5 title section title /xsl:param to specify the location of the tables, but it didn´t work out. Can anyone give us a clue? Per default, the tables are rendered into the front part of the document. Thanks! Daniel From: Jason Zech z...@loyolapress.com To: Bob Stayton b...@sagehill.net, docbook-apps@lists.oasis-open.org docbook-apps@lists.oasis-open.org, daniel.ke...@finaris.de daniel.ke...@finaris.de Date: 24.01.2012 17:43 Subject: RE: [docbook-apps] Customizing and creating a stylesheet for docbook using the XML Mind or Oxygen XML Editor I’m also a fan of PrinceXML, which generates PDF from any structured content using fairly robust CSS styles. I transform from DocBook to HTML (using the stylesheets) and from HTML to PDF with Prince (CSS for styles). I’m very impressed with the results. www.princexml.com From: Bob Stayton [mailto:b...@sagehill.net] Sent: Tuesday, January 24, 2012 10:40 AM To: docbook-apps@lists.oasis-open.org; daniel.ke...@finaris.de Subject: Re: [docbook-apps] Customizing and creating a stylesheet for docbook using the XML Mind or Oxygen XML Editor 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 b...@sagehill.net - Original Message - From: daniel.ke...@finaris.de To: docbook-apps@lists.oasis-open.org 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: daniel.ke...@finaris.de To:
Re: [docbook-apps] Customizing and creating a stylesheet for docbook using the XML Mind or Oxygen XML Editor
Hi Daniel, This change is not supported with a param, so it will require customizing a couple of templates. Start with the template with match=d:book in fo/division.xsl. It calls the template named make.book.tocs before the content is processed: xsl:call-template name=make.book.tocs/ xsl:apply-templates select=$content/ The make.book.tocs template generates both the TOC and the Lists of Everything, so you will also need to customize it. You can divide it into two named templates, and call one before the content and one after. Each one generates one or more page-sequences, so that should work. Bob Stayton Sagehill Enterprises b...@sagehill.net - Original Message - From: daniel.ke...@finaris.de To: Jason Zech ; Bob Stayton ; docbook-apps@lists.oasis-open.org Sent: Monday, January 30, 2012 4:46 AM Subject: RE: [docbook-apps] Customizing and creating a stylesheet for docbook using the XML Mind or Oxygen XML Editor Hey, we finally managed to customize the PDF output. Some aspects still seem a bit mysterious, but we´ve got it. Thanks for the hint Bob! Nevertheless, we are not yet running out of questions: We are pretty much finished customizing our stylesheet, but still have a problem moving the list of figures and list of tables towards the appendix/ back of the document.. Our Documents are structured into: - Frontpage - Legal Notices -Table of content - Typographical conventions - Preface -Main body -Appendix ( shortcuts, glossary etc.) -List of figures - List of tables The problem is that we haven´t figured out yet how to shift the list of tables and list of figures from the front of the document ( between frontpage and legal notices ) to the back of the document ( after the appendix). The Appendix including the tables have a Heading TOC formatting ( A XYZ, B XYZ etc.) We have used xsl:param name=generate.toc appendix title,figure article title book toc,title chapter title part title preface title reference title sect1 title sect2 title sect3 title sect4 title sect5 title section title /xsl:param to specify the location of the tables, but it didn´t work out. Can anyone give us a clue? Per default, the tables are rendered into the front part of the document. Thanks! Daniel From: Jason Zech z...@loyolapress.com To: Bob Stayton b...@sagehill.net, docbook-apps@lists.oasis-open.org docbook-apps@lists.oasis-open.org, daniel.ke...@finaris.de daniel.ke...@finaris.de Date: 24.01.2012 17:43 Subject: RE: [docbook-apps] Customizing and creating a stylesheet for docbook using the XML Mind or Oxygen XML Editor -- I’m also a fan of PrinceXML, which generates PDF from any structured content using fairly robust CSS styles. I transform from DocBook to HTML (using the stylesheets) and from HTML to PDF with Prince (CSS for styles). I’m very impressed with the results. www.princexml.com From: Bob Stayton [mailto:b...@sagehill.net] Sent: Tuesday, January 24, 2012 10:40 AM To: docbook-apps@lists.oasis-open.org; daniel.ke...@finaris.de Subject: Re: [docbook-apps] Customizing and creating a stylesheet for docbook using the XML Mind or Oxygen XML Editor 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 b...@sagehill.net - Original Message - From: daniel.ke...@finaris.de To: docbook-apps@lists.oasis-open.org 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
Re: [docbook-apps] Customizing and creating a stylesheet for docbook using the XML Mind or Oxygen XML Editor
Hi Daniel, Oxygen (and most probably also XML Mind) uses CSS stylesheets in order to display the XML in the Author editing mode in a visual pleasing manner. Those CSS styles which you use for visual editing do not influence the publishing in any way. Output for PDF (and for XHTML, etc) can indeed be customized by setting XSLT parameters to the publishing transformation scenario. Regards, Radu Radu Coravu oXygen/ XML Editor, Schema Editor and XSLT Editor/Debugger http://www.oxygenxml.com On 1/23/2012 2:38 PM, daniel.ke...@finaris.de wrote: 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.ke...@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 http://shop.oreilly.com/product/9780596805012.do?sortby=publicationDatemakes 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 === - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
Re: [docbook-apps] Customizing and creating a stylesheet for docbook using the XML Mind or Oxygen XML Editor
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 b...@sagehill.net - Original Message - From: daniel.ke...@finaris.de To: docbook-apps@lists.oasis-open.org 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: daniel.ke...@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.
RE: [docbook-apps] Customizing and creating a stylesheet for docbook using the XML Mind or Oxygen XML Editor
I’m also a fan of PrinceXML, which generates PDF from any structured content using fairly robust CSS styles. I transform from DocBook to HTML (using the stylesheets) and from HTML to PDF with Prince (CSS for styles). I’m very impressed with the results. www.princexml.comhttp://www.princexml.com From: Bob Stayton [mailto:b...@sagehill.net] Sent: Tuesday, January 24, 2012 10:40 AM To: docbook-apps@lists.oasis-open.org; daniel.ke...@finaris.de Subject: Re: [docbook-apps] Customizing and creating a stylesheet for docbook using the XML Mind or Oxygen XML Editor 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 b...@sagehill.netmailto:b...@sagehill.net - Original Message - From: daniel.ke...@finaris.demailto:daniel.ke...@finaris.de To: docbook-apps@lists.oasis-open.orgmailto:docbook-apps@lists.oasis-open.org 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: daniel.ke...@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
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: daniel.ke...@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 ===
Re: [docbook-apps] Customizing and creating a stylesheet for docbook using the XML Mind or Oxygen XML Editor
Hi, From your text it is a bit difficult to judge how much of the DocBook writing/transformation concepts you are familiar width. your questions seems to imply some mild confusion on how things fit together (but on the other had you mention programming experience with XML? - so I don't quite understand what level you are coming from). This makes it difficult to give good advise. it is also impossible to in a short mail like this give a complete tutorial on DocBook installation, process and example transformation. Unfortunately as with anything powerful as DocBook, and the process to work with it, the learning curve is rather steep in the beginning since there will be many unfamiliar concepts. If your company have little experience in DocBook, XML, XSLT, XSLT-FO, XPath, XML Schemas etc. it can be quite a challenge to get to grip with all parts. So doing a manual installation by downloading the XSLT stylesheets etc is definitely not going to be easy for you since you need several tools that interact and I would not recommend this. Since you seem to be a solid company the best way for you is most likely to get hold of some person with knowledge to help get you started. This will save you time in the long run. If you want to do it on your own read on. First you seem to be confused by all the URL with references to various XML documents. In a correctly installed system you will have something called an XML catalog. This is basically a map from URLs to a local copy of that specific document referenced to by the URL. The reason to use what looks like an external URL in documents is that in this way the files are portable and all system can just adjust this mapping file to match the local setup. Getting the external references is also possible but will of course take extra time. There are a number of tutorials on DocBook on the Web but most assume you already have a working DocBook system installed. I assume you are on a Windows system and in that case you are best of getting one of the authoring tools (say Oxygen or XML Mind) available. If you are Unix based then chances are high that you can install all tools necessary from your package manager. (From a personal view I find that Unix based system are easier since I usually build my document from build scripts - that does all my housekeeping) One of the authoring tools will get you setup right away and you can start writing DocBook documents and do a basic transformation into, say PDF or HTML right away. However the look and feel of the resulting document (with default styling) is most likely not what you want in your end products. The default styling, while it works, is basic and you will need to customize that to fit your company graphic profile. Doing this customization can be quite a challenging task. Customizing the printed output will require basic-to-medium knowledge of XSLT, XSL-FO as well as XPath and how to fit in a customization layer in your transformation process. To customize HTML output will in addition to XSLT knowledge also require knowledge of CSS. Your company should also decide on which elements from DocBook it will actually use. DocBook all in all probably have well over five hundred elements (I'm guessing - I haven't counted). I can hardly think of any single article or book that needs more than,say 1/10:th of that. So you will need to sit down and think of how your documents are structured with sections, footnotes, sidenotes, program-listsings etc. etc. This will also make the customization easier since you only have to customize those elements. The best start to gain knowledge on the transformation from DocBook to an output format is to read Bob Stayton's book on DocBook XSL-Stylesheet (and how to customize that). Once you start to have specific questions on how to do a specific customization (and you will!) there are FAQ on the net as well as archives of this mailing list which has covered a lot of questions - and most likely yours already. There are relly few customization questions which hasn't alreay been asked - and answered. If you can be more specific about things that confuse you I can try to give some more targeted answers. /Johan On 2012-01-17 09:43, daniel.ke...@finaris.de wrote: 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
Re: [docbook-apps] Customizing and creating a stylesheet for docbook using the XML Mind or Oxygen XML Editor
Le 17/01/2012 09:43, daniel.ke...@finaris.de
a crit:
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 Walshs "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 dont 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.
I am surprised to read the above message. I really thought that we
had enough documentation to achieve what you want. See for example,
XMLmind XML Editor - Configuration and Deployment
Chapter 5. Customizing an existing configuration
http://www.xmlmind.com/xmleditor/_distrib/doc/configure/customizing.html
("DocBook v5+" is one of the ``configuration'' supported by XMLmind
XML Editor.)
Moreover:
* You are welcome to send support requests to:
maito:xmleditor-supp...@xmlmind.com
More information:
http://www.xmlmind.com/xmleditor/support.html
* We even have an easy-to-purchase customization service which could
give you a quick start. (However because you are an IT company, you
probably don't need it.) See
http://www.xmlmind.com/xmleditor/customization_service.html
-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
Re: [docbook-apps] Customizing and creating a stylesheet for docbook using the XML Mind or Oxygen XML Editor
Hi Daniel, the reference book for DocBook XSL customization is "DocBook XSL: The Complete Guide" http://www.sagehill.net/docbookxsl/ You should find there all you need and more. HTH Camille Bgnis Grant cami...@neodoc.fr Tl: 09.54.96.99.55 - Fax: 09.59.96.99.55 http://www.neodoc.fr/ 5, rue de la Touloubre 13770 Venelles On 17/01/2012 09:43, daniel.ke...@finaris.de wrote: 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 Walshs "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 dont 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 Smmerringstr. 23, 60322 Frankfurt/Main, Germany Registered at Frankfurt/Main, HRB 52873 Managing Directors: Dipl. Inf. Hermann Friebel, Dipl. Ing. Kai Bchle, Dipl. Inf. Werner Mrkl ===
Re: [docbook-apps] Customizing and creating a stylesheet for docbook using the XML Mind or Oxygen XML Editor
Hi Daniel, You might want to look at the MySQL documentation system, described on this page: http://dev.mysql.com/doc/index-about.html The MySQL Guide to Documentation linked from that page provides an overview of how we set up and handle DocBook things. There are also links for downloading the tool set and the mysqldoc repository which you can use to look at and learn from how to set up your own books. The tool set requires a Unix-like system; in theory, it will run on Windows as well, but in practice all our writers use either Linux, Mac OS X, or a Linux virtual machine on Windows. Even if you end up using a different system (say, Ant-based) it's probably worth looking at the Guide to Documentation. We've been using DocBook for all MySQL documentation since 2004, and we have a lot of content to handle. Most of our writers use Oxygen XML Editor, some use vi or Emacs. Oxygen has validation and transformation built in, but it's not trivial to automate things, and this one of the reasons why we use our own set of tools. The tool set is based on a few select open source components (make, XML tools, Perl, FOP) which makes it easy to run the tools on any (non-Windows) computer. Cheers, Stefan On 17.01.2012 09:43, daniel.ke...@finaris.de wrote: 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 http://shop.oreilly.com/product/9780596805012.do?sortby=publicationDatemakes 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 === -- Cheers, Stefan Hinz stefan.h...@oracle.com, MySQL Documentation Manager Phone: +49-30-82702940, Fax: +49-30-82702941, http://dev.mysql.com/doc ORACLE Deutschland B.V. Co. KG Registered Office: Riesstr. 25, 80992 Muenchen, Germany Commercial Register: Local Court Of Munich, HRA 95603 Managing Director: Jürgen Kunz General Partner: ORACLE Deutschland Verwaltung B.V. Hertogswetering 163/167, 3543 AS Utrecht, Niederlande Register Of Chamber Of Commerce: Midden-Niederlande, No. 30143697 Managing Directors: Alexander van der Ven, Astrid Kepper, Val Maher - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
