Hi, My company is using docbook for end user documentation and to some degree also for design documentation. Since docbook is nothing anyone seems to be fond of writing, I now started looking into quickbook. The features that attract me the most are the neat syntax and programmability. The docbook environment that I am supposed to use is based on a different docbook version, than the one referenced in boostbook. So at the moment I have an xml file containing the book and booinfo header containing our corporate design foobar and disclaimer stuff. Then each chapter is referenced. The chapters are written in quickbook as chapter documents. When running the toolchain, it complains that it could not find the boostbook dtd - probably because downloading of dtd is disable, or fails because of our proxy. Is there a way to surpress the DOCTYPE tag within the chapter xml output files? regards Andreas Pokorny
On 8 February 2012 18:54, Andreas Pokorny <andreas.pokorny@gmail.com> wrote:
Hi, My company is using docbook for end user documentation and to some degree also for design documentation. Since docbook is nothing anyone seems to be fond of writing, I now started looking into quickbook. The features that attract me the most are the neat syntax and programmability. The docbook environment that I am supposed to use is based on a different docbook version, than the one referenced in boostbook. So at the moment I have an xml file containing the book and booinfo header containing our corporate design foobar and disclaimer stuff. Then each chapter is referenced. The chapters are written in quickbook as chapter documents. When running the toolchain, it complains that it could not find the boostbook dtd - probably because downloading of dtd is disable, or fails because of our proxy. Is there a way to surpress the DOCTYPE tag within the chapter xml output files?
No, but it'd be easy to implement. Maybe a command line option: quickbook --doctype none quickbook --doctype docbook quickbook --doctype boostbook If you like that idea, can you submit a ticket to trac so that I don't forget? A future version might even warn if you use boostbook features in a docbook document.
On 2/8/2012 1:15 PM, Daniel James wrote:
On 8 February 2012 18:54, Andreas Pokorny<andreas.pokorny@gmail.com> wrote:
Hi, My company is using docbook for end user documentation and to some degree also for design documentation. Since docbook is nothing anyone seems to be fond of writing, I now started looking into quickbook. The features that attract me the most are the neat syntax and programmability. The docbook environment that I am supposed to use is based on a different docbook version, than the one referenced in boostbook. So at the moment I have an xml file containing the book and booinfo header containing our corporate design foobar and disclaimer stuff. Then each chapter is referenced. The chapters are written in quickbook as chapter documents. When running the toolchain, it complains that it could not find the boostbook dtd - probably because downloading of dtd is disable, or fails because of our proxy. Is there a way to surpress the DOCTYPE tag within the chapter xml output files?
No, but it'd be easy to implement. Maybe a command line option:
quickbook --doctype none quickbook --doctype docbook quickbook --doctype boostbook
If you like that idea, can you submit a ticket to trac so that I don't forget? A future version might even warn if you use boostbook features in a docbook document.
I have tried this.. But it's likely possible to tell xsltproc to repoint the boostbook dtd to some other dtd. Hence you could repoint it to a local version of the dtd, or to an empty local one. -- -- Grafik - Don't Assume Anything -- Redshift Software, Inc. - http://redshift-software.com -- rrivera/acm.org (msn) - grafik/redshift-software.com -- 102708583/icq - grafikrobot/aim,yahoo,skype,efnet,gmail
On Thu, Feb 9, 2012 at 3:22 AM, Rene Rivera <grafikrobot@gmail.com> wrote:
On 8 February 2012 18:54, Andreas Pokorny<andreas.pokorny@gmail.com>
complains that it could not find the boostbook dtd - probably because downloading of dtd is disable, or fails because of our proxy. Is there a way to surpress the DOCTYPE tag within the chapter xml output files?
I have tried this.. But it's likely possible to tell xsltproc to repoint the boostbook dtd to some other dtd. Hence you could repoint it to a local version of the dtd, or to an empty local one.
See http://www.sagehill.net/docbookxsl/UseCatalog.html, http://xmlsoft.org/catalog.html and/or http://www.sagehill.net/docbookxsl/UseCatalog.html . --DD
On Thu, Feb 9, 2012 at 9:37 AM, Dominique Devienne <ddevienne@gmail.com> wrote:
See http://en.wikipedia.org/wiki/XML_Catalog, http://xmlsoft.org/catalog.html and/or http://www.sagehill.net/docbookxsl/UseCatalog.html . --DD
Corrected above the first link, sorry. --DD
Andreas Pokorny wrote:
Hi, My company is using docbook for end user documentation and to some degree also for design documentation. Since docbook is nothing anyone seems to be fond of writing, I now started looking into quickbook. The features that attract me the most are the neat syntax and programmability. The docbook environment that I am supposed to use is based on a different docbook version, than the one referenced in boostbook. So at the moment I have an xml file containing the book and booinfo header containing our corporate design foobar and disclaimer stuff. Then each chapter is referenced. The chapters are written in quickbook as chapter documents. When running the toolchain, it complains that it could not find the boostbook dtd - probably because downloading of dtd is disable, or fails because of our proxy. Is there a way to surpress the DOCTYPE tag within the chapter xml output files?
Without quickbook, how did you edit the docbook schemas? Have you tried XMLMind or other such tools? Which version of docbook do you use? Robert Ramey
regards Andreas Pokorny
_______________________________________________ Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
Hi, Am 8. Februar 2012 22:29 schrieb Robert Ramey <ramey@rrsd.com>:
Andreas Pokorny wrote:
[..]. Is there a way to surpress the DOCTYPE tag within the chapter xml output files?
Without quickbook, how did you edit the docbook schemas? Have you tried XMLMind or other such tools? Which version of docbook do you use?
They use the docbook 4.4 dtd, and docbook-xsl 1.75.2. The toolchain is a "nice" combination of makefiles and shell scripts (and batch files for windows users). So far I have not used any of the boostbook features. But I believe this is just a matter of time. Especially the Doxygen integration is something I would like to use. At some time I will have to dig into that. Is the boostbook-xsl something that just needs to be exectued before the docbook-xsl 2 fo conversion? . regards Andreas Pokorny
On 02/09/2012 03:09 AM, Andreas Pokorny wrote:
Hi,
Am 8. Februar 2012 22:29 schrieb Robert Ramey <ramey@rrsd.com>:
Andreas Pokorny wrote:
[..]. Is there a way to surpress the DOCTYPE tag within the chapter xml output files?
Without quickbook, how did you edit the docbook schemas? Have you tried XMLMind or other such tools? Which version of docbook do you use?
They use the docbook 4.4 dtd, and docbook-xsl 1.75.2. The toolchain is a "nice" combination of makefiles and shell scripts (and batch files for windows users). So far I have not used any of the boostbook features. But I believe this is just a matter of time. Especially the Doxygen integration is something I would like to use. At some time I will have to dig into that. Is the boostbook-xsl something that just needs to be exectued before the docbook-xsl 2 fo conversion? .
Yes. The conversion is something like quickbook -> boostbook hpp -> doxygen XML -> boostbook boostbook -> docbook docbook -> html/fo/etc In Christ, Steven Watanabe
participants (6)
-
Andreas Pokorny -
Daniel James -
Dominique Devienne -
Rene Rivera -
Robert Ramey -
Steven Watanabe