[docbook] Re: Updated online edition of TDG 5.1
Thomas Schraitle tom_s...@web.de writes: I've found a small bug, it seems the screenco element is not correctly processed: http://www.docbook.org/tdg51/en/html/ch05.html#ch05-genstruct Also the callout images are not displayed. Thanks. I think that's fixed. Trying to get out another release today. Be seeing you, norm -- Norman Walsh n...@nwalsh.com | To achieve great things we must http://www.oasis-open.org/docbook/ | live as though we were never going Chair, DocBook Technical Committee | to die.-- Vauvenargues pgpO60L2ysoq1.pgp Description: PGP signature
[docbook] DocBook.org updated, new schemas
Hi folks, This morning, I published an update to DocBook.org. The update moves a bunch of stuff around, but hopefully loses nothing. I have added redirects where I thought it was practical. Please report any problems you find. The updates are: DocBook 5.1b6 DocBook Simplified 5.1b6-1 DocBook Website 5.1b6-1 DocBook Slides 5.1b6-1 DocBook HTML Forms 5.1b6-1 I've also published an update to DocBook TDG5.1 for DocBook 5.1b6. The big changes that I can think of off the top of my head are broader use of XLink and the new multimedia changes. I'll craft a better change long for V.next, I promise. Be seeing you, norm -- Norman Walsh n...@nwalsh.com | We cannot put off living until we http://www.oasis-open.org/docbook/ | are ready. The most salient Chair, DocBook Technical Committee | characteristic of life is its | coerciveness: it is always urgent, | 'here and now' without any | possible postponement. Life is | fired at us point blank.--José | Ortega Y Gasset pgpwCX7FY4zq7.pgp Description: PGP signature
RE: [docbook] No DocBook Meetup at XML Prague (10 Feb 2012)
David Cramer [mailto:da...@thingbag.net] wrote: On 01/16/2012 02:17 PM, Peter Flynn wrote: On 16/01/12 18:34, Norman Walsh wrote: ... I'm still interested in the idea of running a DocBook conference of some sort; please let me know if you have any suggestions. What about in conjunction with Balisage? ///Peter +1. I'm not able to make it to xmlprague, but do plan to go to Balisage and would enjoy a DocBook meeting. Same here. Another vote for Balisage. * Rob Cavicchio rob.cavicc...@emc.com Principal Technical Writer Information Architect Information Intelligence Group EMC Corporation The opinions expressed here are my personal opinions. Content published here is not read or approved in advance by EMC and does not necessarily reflect the views and opinions of EMC.
[docbook] Re: No DocBook Meetup at XML Prague (10 Feb 2012)
Peter Flynn pe...@silmaril.ie writes: I'm still interested in the idea of running a DocBook conference of some sort; please let me know if you have any suggestions. What about in conjunction with Balisage? Before, after, or during? I'd be happy to host an evening session during the conference, if that's of interest. Before and/or after is trickier. Be seeing you, norm -- Norman Walsh n...@nwalsh.com | We cannot put off living until we http://www.oasis-open.org/docbook/ | are ready. The most salient Chair, DocBook Technical Committee | characteristic of life is its | coerciveness: it is always urgent, | 'here and now' without any | possible postponement. Life is | fired at us point blank.--José | Ortega Y Gasset pgp1RVg65qh9I.pgp Description: PGP signature
Re: [docbook] Re: No DocBook Meetup at XML Prague (10 Feb 2012)
On 17/01/12 18:59, Norman Walsh wrote: Peter Flynnpe...@silmaril.ie writes: I'm still interested in the idea of running a DocBook conference of some sort; please let me know if you have any suggestions. What about in conjunction with Balisage? Before, after, or during? I'd be happy to host an evening session during the conference, if that's of interest. Before and/or after is trickier. Should have kept my big mouth shut...I can't make Balisage this year due to a family wedding. ///Peter - To unsubscribe, e-mail: docbook-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-h...@lists.oasis-open.org
[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