Re: DOCBOOK: A couple of questions... DocBook's basics anddocumentation
Andrew Check out http://www.xml.com for tutorials on starting out with XML. Once you have a handle on that, there's a tutorial called Writing Documentation Using DocBook by David Rugge, Mark Galassi Eric Bischoff on the 'net somewhere - a search on Google should track it down if it's not at http://www.caldera.de/~eric/crash_course/HTML/index.htm. As an XML/DocBook application programmer myself, I found the free download of Docbook: The Definitive Guide published by O'Reilly (http://www.oreilly.com/catalog/docbook/) very useful - http://docbook.org/tdg/en/. Hope that helps. On a personal note, what platform will you be developing for (Win/Linux)? What development tools will you be using? Mart Martin Gautier Technology Consultant Myrnham Associates Ph: 0709 2234 228 Fax: 0702 0967 322 email: [EMAIL PROTECTED] Web: http://www.myrnham.co.uk/ The DeerBear [EMAIL PROTECTED] 16/09/01 16:39 To:Mailing List DocBook [EMAIL PROTECTED] cc: Subject:DOCBOOK: A couple of questions... DocBook's basics and documentation Hello everybody, With the occasion of this first message I introduce myself. My name is Andrew and I am a programmer. I've been asked to write a docbook visual editor( that may become open-source ) but I never dealt with XML before so... would you please point me to a *good* basic documentation that will allow me to get acquainted with these things quickly? Hoping in your ( possibly in english please ) answers, I greet you people warmly. Best Regards, Andrew To subscribe or unsubscribe from this elist use the subscription manager: http://lists.oasis-open.org/ob/adm.pl
DOCBOOK: Forcing seperate documents
Hi All I am using ver4.1 of DocBookx.dtd with the xsl stylesheets and Xalan. In my book I am declaring a number of documents as entities. Can you tell me how I can force these into seperate documents rather than have them all included in one htm file. Is it also possible to not have a ToC in each chapter? Regards Ken -- Ken Walton Digital Design Development www.ddd.co.za Tel: +27 011 8862299 Fax: +27 011 7813498 Mobile: 082 5787937 To subscribe or unsubscribe from this elist use the subscription manager: http://lists.oasis-open.org/ob/adm.pl
Re: DOCBOOK: Forcing seperate documents
At 11:20 17/09/2001 +0200, Ken Walton wrote: Hi All I am using ver4.1 of DocBookx.dtd with the xsl stylesheets and Xalan. In my book I am declaring a number of documents as entities. Can you tell me how I can force these into seperate documents rather than have them all included in one htm file. Is it also possible to not have a ToC in each chapter? yes, yes. 1. Assuming you want html output rather than fo's. Call up chunk.xsl rather than docbook.xsl 2. Set the overall toc param (either in param.xsl or in your driver file) to 1 then set each of the various wrappers to 1 or 0 as needed. I know since I've just been there. I'm (almost) totally gobsmacked at the professionalism/flexibility of these stylesheets. The more I use them the more I'm impressed. There is even the infinitesimally remote chance I may start to stretch them in the next decade or so. I haven't been so pleased with any software since I came across Autocad. One of those tools that can do it, just that you haven't found out how... yet! Once more, thanks Norm (and team). Regards DaveP To subscribe or unsubscribe from this elist use the subscription manager: http://lists.oasis-open.org/ob/adm.pl
Re: SV: DOCBOOK: Unbreakable paragraph
[ Follow-ups to docbook-apps, please ] / Fredrik Eriksson [EMAIL PROTECTED] was heard to say: | I'm using DSSSL and what I want is this | | --- block starts here | The example text | Inserted picture | --- block ends here | | And I want this text + picture to be together so that when I generate a pdf | from the source I will nor risk having an pagebreak put inside the block. | Hope this explains more what I am looking for.. What you want to do is make sure the block has the right keep: property setting. You'll probably have to tweak the stylesheets to do this. Perhaps by adding a role to the paragraph that contains the picture. Be seeing you, norm -- Norman Walsh [EMAIL PROTECTED] | I'm not tense, I'm just terribly, http://www.oasis-open.org/docbook/ | terribly alert. Chair, DocBook Technical Committee | To subscribe or unsubscribe from this elist use the subscription manager: http://lists.oasis-open.org/ob/adm.pl
Re: DOCBOOK: Forcing seperate documents
Ken, I can't tell you how to force separate entities into different documents, but I can tell you that it is possible to turn off ToC in each chapter. If you go into the html/param.xsl and do a search on toc, Norm has labeled everything (Good job there) and it's a matter of replacing 1 with 0 to turn it off. I do that for most of my HTML documents, since my stuff is short enough that it's more distracting than useful. At 04:20 2001-09-17, Ken Walton wrote: Hi All I am using ver4.1 of DocBookx.dtd with the xsl stylesheets and Xalan. In my book I am declaring a number of documents as entities. Can you tell me how I can force these into seperate documents rather than have them all included in one htm file. Is it also possible to not have a ToC in each chapter? Regards Ken -- Ken Walton Digital Design Development www.ddd.co.za Tel: +27 011 8862299 Fax: +27 011 7813498 Mobile: 082 5787937 To subscribe or unsubscribe from this elist use the subscription manager: http://lists.oasis-open.org/ob/adm.pl Derek [EMAIL PROTECTED] http://www.mm.com/user/djdees/ Out the 10Base-T, through the router, down the T1, over the leased line, off the bridge, past the firewall, ...nothing but Net. -- Dilbert (Scott Adams) To subscribe or unsubscribe from this elist use the subscription manager: http://lists.oasis-open.org/ob/adm.pl
Re: DOCBOOK: Forcing seperate documents
* Derek Dees: I can't tell you how to force separate entities into different documents, but I can tell you that it is possible to turn off ToC in each chapter. If you go into the html/param.xsl and do a search on toc, Norm has labeled everything (Good job there) and it's a matter of replacing 1 with 0 to turn it off. I do that for most of my HTML documents, since my stuff is short enough that it's more distracting than useful. I'd rather write a special XSLT stylesheet overriding these values. It is considered very bad practise to modify the original distribution. Here is a sample XSLT that does the job: toc.xsl- ?xml version='1.0'? xsl:stylesheet xmlns:xsl=http://www.w3.org/1999/XSL/Transform; version=1.0 xsl:import href='/usr/local/share/xml/docbook/xsl/modular/html/docbook.xsl' / xsl:param name=generate.component.toc select=1/ xsl:param name=generate.division.toc select=1/ xsl:param name=toc.section.depth4/xsl:param /xsl:stylesheet Simply process your doc with toc.xsl instead of docbook.xsl, so you have a maintainable setup... -- Jean-Baptiste Quenot http://caraldi.com/jbq/ To subscribe or unsubscribe from this elist use the subscription manager: http://lists.oasis-open.org/ob/adm.pl
DOCBOOK-APPS: customizing XSL titlepages
Hope you don't mind, but I changed the Subject line to better reflect the current question. I'm just learning the titlepage customization myself, so don't consider this an authoritative answer. The titlepage elements are processed in various modes, so that might be why your new template is being missed. I was able to get holder wrapped in P with these templates in a customization layer: xsl:template match=copyright mode=book.titlepage.recto.mode xsl:apply-templates mode=book.titlepage.recto.mode/ /xsl:template xsl:template match=holder mode=book.titlepage.recto.mode P xsl:apply-templates/ /P /xsl:template I don't think you need to include the year/ and holder/ elements in your titlepage.templates.xml spec file, because templates are applied to the children of copyright anyway. I just needed to specify the templates in the right mode. The one for copyright is just to pass the mode down to the holder template, since modes are not automatically propagated to children. Hope this is something that helps. bobs Bob Stayton 400 Encinal Street Publications Architect Santa Cruz, CA 95060 Technical Publications voice: (831) 427-7796 Caldera International, Inc. fax: (831) 429-1887 email: [EMAIL PROTECTED] From: Dave Pawson [EMAIL PROTECTED] One more if I may. Defining titlepages, e.g. for 'holder' I want a p element. have t:titlepage element=book wrapper=div class=titlepage t:titlepage-content side=recto title/ subtitle/ author/ contrib/ edition/ copyright year/ holder/ /copyright legalnotice/ publisher/ pubdate/ dedication/ abstract/ /t:titlepage-content t:titlepage-content side=verso /t:titlepage-content t:titlepage-separator hr/ /t:titlepage-separator t:titlepage-before side=recto /t:titlepage-before t:titlepage-before side=verso /t:titlepage-before /t:titlepage and I'm defining a template for holder. Its being overridden somewhere, Is the format of the xml file right, with nesting? Any clues please? Regards DaveP To subscribe or unsubscribe from this elist use the subscription manager: http://lists.oasis-open.org/ob/adm.pl To subscribe or unsubscribe from this elist use the subscription manager: http://lists.oasis-open.org/ob/adm.pl
DOCBOOK-APPS: Re: customizing XSL titlepages
At 02:18 17/09/2001 -0700, Bob Stayton wrote: The titlepage elements are processed in various modes, so that might be why your new template is being missed. I was able to get holder wrapped in P with these templates in a customization layer: xsl:template match=copyright mode=book.titlepage.recto.mode xsl:apply-templates mode=book.titlepage.recto.mode/ /xsl:template xsl:template match=holder mode=book.titlepage.recto.mode P xsl:apply-templates/ /P /xsl:template I don't think you need to include the year/ and holder/ elements in your titlepage.templates.xml spec file, because templates are applied to the children of copyright anyway. I just needed to specify the templates in the right mode. The one for copyright is just to pass the mode down to the holder template, since modes are not automatically propagated to children. Hope this is something that helps. Thanks Bob. It was the moded templates I've missed. I guess its the same for revhistory? I put a straight template for revhistory in my top level stylesheet and Norm ignored it! The cheek of the fellah :-) One occasion when import precedence doesn't work out. grin type=documentaryHow to document the list of moded templates?/grin Thanks, DaveP To subscribe or unsubscribe from this elist use the subscription manager: http://lists.oasis-open.org/ob/adm.pl
DOCBOOK-APPS: Any suggestions on Java problems? (with Saxon)
Having some Java problems today. Normally I use 'xsltproc' for all my DocBook XML, but today I wanted to do a comparison with the output from Saxon 6.2.2. But I keep getting this annoying error about 'java.lang.NoClassDefFoundError'. In the script below, you can see that the relevant .jar files are in my $CLASSPATH variable, and I have also tried calling it directly using the command-line '-cp' to set the classpath. In neither case does it work. (I have also blanked out the CLASSPATH variable as well in the process of testing.) I am using Sun's 1.3.1 JRE. I also tried it with IBM's JRE as well. Any ideas? (Beyond the obvious of avoiding Java altogether and sticking with xsltproc? ;-) $ echo $CLASSPATH .:/usr/share/xalan/xalan.jar:/usr/share/xalan/xerces.jar:/usr/share/xalan/samples/xalansamples.jar:/usr/share/xalan/bsf.jar:/usr/share/saxon/saxon.jar:/usr/share/saxon/saxon-fop.jar $ $ java com.icl.saxon.Stylesheet sample.xml indent.xsl out-saxon.xml Exception in thread main java.lang.NoClassDefFoundError: com/icl/saxon/Stylesheet $ $ java -cp /usr/share/saxon/saxon.jar com.icl.saxon.Stylesheet sample.xml indent.xsl out-saxon.xml Exception in thread main java.lang.NoClassDefFoundError: com/icl/saxon/Stylesheet $ Thanks, Dan -- Dan York, Director of Training[EMAIL PROTECTED] Ph: +1-613-751-4401 Cell: +1-613-263-4312 Fax: +1-613-564-7739 Mitel Network Corporation Network Server Solutions Group 150 Metcalfe St., Suite 1500, Ottawa,ON K2P 1P1 Canada http://www.e-smith.com/http://www.mitel.com/ To subscribe or unsubscribe from this elist use the subscription manager: http://lists.oasis-open.org/ob/adm.pl
Re: DOCBOOK-APPS: Any suggestions on Java problems? (with Saxon)
Dan: Try the following: java com.icl.saxon.StyleSheet That usually works for me Carlos Once upon a time, Dan York was seen writting: Having some Java problems today. Normally I use 'xsltproc' for all my DocBook XML, but today I wanted to do a comparison with the output from Saxon 6.2.2. But I keep getting this annoying error about 'java.lang.NoClassDefFoundError'. In the script below, you can see that the relevant .jar files are in my $CLASSPATH variable, and I have also tried calling it directly using the command-line '-cp' to set the classpath. In neither case does it work. (I have also blanked out the CLASSPATH variable as well in the process of testing.) I am using Sun's 1.3.1 JRE. I also tried it with IBM's JRE as well. Any ideas? (Beyond the obvious of avoiding Java altogether and sticking with xsltproc? ;-) $ echo $CLASSPATH .:/usr/share/xalan/xalan.jar:/usr/share/xalan/xerces.jar:/usr/share/xalan/samp les/xalansamples.jar:/usr/share/xalan/bsf.jar:/usr/share/saxon/saxon.jar:/usr/ share/saxon/saxon-fop.jar $ $ java com.icl.saxon.Stylesheet sample.xml indent.xsl out-saxon.xml Exception in thread main java.lang.NoClassDefFoundError: com/icl/saxon/Stylesheet $ $ java -cp /usr/share/saxon/saxon.jar com.icl.saxon.Stylesheet sample.xml indent.xsl out-saxon.xml Exception in thread main java.lang.NoClassDefFoundError: com/icl/saxon/Stylesheet $ Thanks, Dan -- --- P |Carlos Araya _ |WebCT Administrator/Trainer G |California Virtual Campus, Region 1 C/O De Anza College 10650 Bubb Road Cupertino, CA 95014 mail: [EMAIL PROTECTED] web:http://www.cvc1.org (work) http://www.silverwolf-net.net (personal) PGP Fingerprint: E629 5DFD 7EAE 4995 E9D7 3D2F 5A9F 0CE7 DFE7 1756 If a man does not erect in this age his own tomb ere he dies, he shall live no longer in monument than the bell rings, and the widow weeps. -- Wm. Shakespeare To subscribe or unsubscribe from this elist use the subscription manager: http://lists.oasis-open.org/ob/adm.pl
DOCBOOK-APPS: [PSGML] Splitting docbook files
Hi all, I'm just getting up to speed with DocBook (via NWalsh's The Def Guide). I can publish my document in rtf and html ok, but the sgm file is huge - and I want to break it up. I've found how to insert it into my master as an entity, but since the child sub-file can't contain a DTG I can't see how to get emacs/psgml to allow me to process the DTD or allow my to insert elements. I've set the sgml-parent-file parameter, hoping that this would make emacs pull the DTD from the parent file, but this didn't happen. I guess I could try inserting the DTD reference into the child-file and pressing Parse DTD from the menu bar - then commenting it out again before I do a real publish, but I'm hoping there's a better way of doing it. Can anybody give me some direction in this please? Thanks, Ian To subscribe or unsubscribe from this elist use the subscription manager: http://lists.oasis-open.org/ob/adm.pl
Re: DOCBOOK-APPS: LaTeX style-sheet
On 20010913 07:59 (Thursday), S-Kal wrote: I started to write new style-sheet for generating a pure LaTeX backend. Please tell me if I have to continue (it takes a long time). As far as I know there is already a project that does this : http://db2latex.sourceforge.net/ It's not finished yet and cannot be used for production AFAIK. But it's usable though. I'm sure they will appreciate your help. The genitor of the project and some of the people helping are also Frenchmen by the way. Regards, -- Marc-Aurèle DARCHE http://ma.darche.free.fr AFUL http://www.aful.org Association Francophone des Utilisateurs de Linux/Logiciels Libres French speaking Linux and Free Software Users' Association To subscribe or unsubscribe from this elist use the subscription manager: http://lists.oasis-open.org/ob/adm.pl
Re: DOCBOOK-APPS: Any suggestions on Java problems? (with Saxon)
* Dan York: Having some Java problems today. Normally I use 'xsltproc' for all my DocBook XML, but today I wanted to do a comparison with the output from Saxon 6.2.2. I find saxon much better than xsltproc in terms of output. For example, saxon outputs entity references for latin-1 characters. Also, xsltproc does not yet fully implements the XSLT standard. I once tried to process a document written with Resume DTD, and xsltproc failed whereas saxon did the job perfectly. However with saxon, because the JVM must be started each time you invoke saxon, and sadly because of the very nature of Java, it is much slower than xsltproc. If you read M. Kay's book, I'm sure you will be a Saxon addict. IMHO, it is really a professional XSLT processor, it is very careful about all the subtleties of implementing XSLT. $ java com.icl.saxon.Stylesheet sample.xml indent.xsl out-saxon.xml $ java com.icl.saxon.StyleSheet sample.xml indent.xsl out-saxon.xml --- Capitalize the s :-) BTW, I know you tweaked a lot the XSL stylesheets, so could you tell me (or maybe someone else who reads this) how you would manage to alter the output HTML's title/ tag, for example to make my company name appear in all window titles. Cheerio! -- Jean-Baptiste Quenot http://caraldi.com/jbq/ To subscribe or unsubscribe from this elist use the subscription manager: http://lists.oasis-open.org/ob/adm.pl
Re: DOCBOOK-APPS: Any suggestions on Java problems? (with Saxon)
Jean-Baptiste, I find saxon much better than xsltproc in terms of output. For example, xsltproc does everything I need, and then some. It has been working excellent and DV has been extremely responsive to any issues that have arisen. Have you tried the most recent versions? (He just put out one this past weekend - more info at http://www.xmlsoft.org/XSLT/ ) However with saxon, because the JVM must be started each time you invoke saxon, and sadly because of the very nature of Java, it is much slower than xsltproc. Accent the much slower. If you read M. Kay's book, I'm sure you will be a Saxon addict. IMHO, I have read his book, which I found quite good. I used Saxon for a good bit, too, and liked it. But... I was having some Java problems that did not allow me to work with it, and I stumbled upon xsltproc... and I haven't looked back. The speed increase - and not having to have a working Java environment - are HUGE wins for me! $ java com.icl.saxon.Stylesheet sample.xml indent.xsl out-saxon.xml $ java com.icl.saxon.StyleSheet sample.xml indent.xsl out-saxon.xml --- Capitalize the s :-) Geez operator error. You know, I even wrote a note to myself on a white board in my cube - and wrote the note wrong! Thanks for the fix... it worked fine when I did the command correctly. BTW, I know you tweaked a lot the XSL stylesheets, so could you tell me (or maybe someone else who reads this) how you would manage to alter the output HTML's title/ tag, for example to make my company name appear in all window titles. Hmmm... I haven't actually modified that... I'd have to take a look - I'll give it a shot tomorrow. Thanks again for the help, Dan -- Dan York, Director of Training[EMAIL PROTECTED] Ph: +1-613-751-4401 Cell: +1-613-263-4312 Fax: +1-613-564-7739 Mitel Network Corporation Network Server Solutions Group 150 Metcalfe St., Suite 1500, Ottawa,ON K2P 1P1 Canada http://www.e-smith.com/http://www.mitel.com/ To subscribe or unsubscribe from this elist use the subscription manager: http://lists.oasis-open.org/ob/adm.pl
DOCBOOK-APPS: Re: DOCBOOK: RedHat 7.1 and DocBook 4?
Moved to the docbook-apps list. I've cc:'ed mark directly, as I don't know if he's on the list. Please just reply to the list directly. On Mon, 2001-09-17 at 16:06, Mark Derricutt wrote: Hiya, on my RedHat 7.1 machine, I can see that I have the DocBook 4.1 DTDs and everything installed (along with 3.0, 3.1, 4.0 it seems), yet I seem to only be using 3.0 or something. I'm building my pdf with the command: jw -d jtime.dsl -b pdf jtime.sgm The top of my DSL looks like: !DOCTYPE style-sheet PUBLIC -//James Clark//DTD DSSSL Style Sheet//EN [ !ENTITY dbstyle SYSTEM /usr/share/sgml/docbook/utils-0.6/docbook-utils.dsl CDATA DSSSL ] As it was the only thing that seemed to work, although I tried a different heading last night I found on another page, that yeilded a different looking document, but still not picking up the things like classsynopsis or qanda. Is there some simple thing I'm missing? Not sure, as I'm not exactly following what the problem is. Are your documents SGML or XML? What DTD is in the docs? I'm a little confused as to why you think changing the DOCTYPE in the stylesheets would change the version of DocBook that you're using. Does it work properly if you don't try to use your custom stylesheet? That's all I can think of offhand, Greg To subscribe or unsubscribe from this elist use the subscription manager: http://lists.oasis-open.org/ob/adm.pl