Re: DOCBOOK-APPS: HTMLHelp, XSL Driver File,Book Request for XSL customizations
On 01/22/02 6:59, Maggie Strevell [EMAIL PROTECTED] wrote: Three items... First: I am trying to come up with HTMLHelp file that has a simple hierarchy. Since I am new to XML, XSL and DocBook, I am unsure if I am specifying the wrong tags or if I need to customize the HTMLHelp XSL in my XSL driver file. What I am trying to do is generate a help table of contents that 1)Has an article that isn't inside a folder/book 2) To title each folder/book without it being a link to something. I am using the docbookx.dtd. How about using a preface? The preface goes before anything but index and legal stuff if I remember correctly, look into TDG for more information, If you're using sect1 as to create the subheadings, I believe you need to customize the stylesheet or look for a parameter that does this. Second: I would like to override the XSL template for hhc-main to specify the ImageType of Book rather than Folder (which is in the original). The only difference between the example below (which is in my driver file) and the one in the original XSL is the ImageType value. This works, but is there a simpler way in my driver file to change this property? What is the best way to override a template in a driver file and make it so that I don't customize more than I need to? If there's a param.xsl file on htmlhelp you should be able to create the driver and just override the parameters. You'd still need to import docbook.xsl, but overriding parameters should be much easier than rewriting an entire template Third: Can anyone make a XSL book recommendation (or on-line tutorial, etc...) that teaches how to customize a stylesheet using a driver file? Does Norm use a htmlhelp stylesheet driver file to produce the help for the DocBook book? I have the CD, just wondering if it exists and where it might be on the CD. I'd say look at the docbook.xsl file on the htmlhelp directory for a starting point. Other people may have a different idea Many Thanks! Maggie -- Carlos E. Araya ---+ WebCT Administrator/Trainer P | California Virtual Campus - | C/O De Anza College G | 21250 Stevens Creek Blvd ---+ Cupertino, CA 95014 email [EMAIL PROTECTED] web http://www.cvc1.org/ (work) http://www.silverwolf-net.net (personal) phone 408 257 0420 (work) PGP Fingerprint:E629 5DFD 7EAE 4995 E9D7 3D2F 5A9F 0CE7 DFE7 1756 Do not meddle in the affairs of dragonsfor you are crunchy and taste good with ketchup and mayonnaise..
RE: DOCBOOK-APPS: HTMLHelp, XSL Driver File,Book Request for XSL customizations
First: A preface can't come before a book. I tried anyway, but Saxon gives an error message and looking at the DocBook Hierarchy, it appears preface must be nested in something like book. Thought of using set, but if I am reading the nesting of elements properly, you can't have a preface inside a set before a book. I've tried a few things, but have gotten worse results than the code I show here. Second: I've been overriding the parameters that are simple, such as those specified in the documentation found at xsl\doc\html\index.html (params that the param.xsl refers to). This time I need to specify something that isn't in that list. Maybe the question should be: How do I reference the ImageType parameter from a XSL driver file without having to override the entire template? Third: I'm open for more suggestions on where to find help on customizing stylesheets via a driver file. Does an XSL driver file that produced the HTMLHelp for docbook exist? If it's on the CD, I will keep looking. Always thankful for a reply, Maggie -Original Message- From: Carlos Araya [mailto:[EMAIL PROTECTED]] Sent: Tuesday, January 22, 2002 9:10 AM To: [EMAIL PROTECTED] Subject: Re: DOCBOOK-APPS: HTMLHelp, XSL Driver File, Book Request for XSL customizations On 01/22/02 6:59, Maggie Strevell [EMAIL PROTECTED] wrote: Three items... First: I am trying to come up with HTMLHelp file that has a simple hierarchy. Since I am new to XML, XSL and DocBook, I am unsure if I am specifying the wrong tags or if I need to customize the HTMLHelp XSL in my XSL driver file. What I am trying to do is generate a help table of contents that 1)Has an article that isn't inside a folder/book 2) To title each folder/book without it being a link to something. I am using the docbookx.dtd. How about using a preface? The preface goes before anything but index and legal stuff if I remember correctly, look into TDG for more information, If you're using sect1 as to create the subheadings, I believe you need to customize the stylesheet or look for a parameter that does this. Second: I would like to override the XSL template for hhc-main to specify the ImageType of Book rather than Folder (which is in the original). The only difference between the example below (which is in my driver file) and the one in the original XSL is the ImageType value. This works, but is there a simpler way in my driver file to change this property? What is the best way to override a template in a driver file and make it so that I don't customize more than I need to? If there's a param.xsl file on htmlhelp you should be able to create the driver and just override the parameters. You'd still need to import docbook.xsl, but overriding parameters should be much easier than rewriting an entire template Third: Can anyone make a XSL book recommendation (or on-line tutorial, etc...) that teaches how to customize a stylesheet using a driver file? Does Norm use a htmlhelp stylesheet driver file to produce the help for the DocBook book? I have the CD, just wondering if it exists and where it might be on the CD. I'd say look at the docbook.xsl file on the htmlhelp directory for a starting point. Other people may have a different idea Many Thanks! Maggie -- Carlos E. Araya ---+ WebCT Administrator/Trainer P | California Virtual Campus - | C/O De Anza College G | 21250 Stevens Creek Blvd ---+ Cupertino, CA 95014 email [EMAIL PROTECTED] web http://www.cvc1.org/ (work) http://www.silverwolf-net.net (personal) phone 408 257 0420 (work) PGP Fingerprint:E629 5DFD 7EAE 4995 E9D7 3D2F 5A9F 0CE7 DFE7 1756 Do not meddle in the affairs of dragonsfor you are crunchy and taste good with ketchup and mayonnaise..
Re: DOCBOOK-APPS: HTMLHelp, XSL Driver File,Book Request for XSL customizations
On 01/22/02 7:41, Maggie Strevell [EMAIL PROTECTED] wrote: First: A preface can't come before a book. I tried anyway, but Saxon gives an error message and looking at the DocBook Hierarchy, it appears preface must be nested in something like book. Thought of using set, but if I am reading the nesting of elements properly, you can't have a preface inside a set before a book. I've tried a few things, but have gotten worse results than the code I show here. I misunderstood your question. I thought you wanted something that goes before the content but still inside the book. I don't think there's a way of doing what you're looking for Second: I've been overriding the parameters that are simple, such as those specified in the documentation found at xsl\doc\html\index.html (params that the param.xsl refers to). This time I need to specify something that isn't in that list. Maybe the question should be: How do I reference the ImageType parameter from a XSL driver file without having to override the entire template? If it's not a parameter, then the only way I know of is to redo the template as you did in your previous message. Third: I'm open for more suggestions on where to find help on customizing stylesheets via a driver file. Does an XSL driver file that produced the HTMLHelp for docbook exist? If it's on the CD, I will keep looking. Again I misunderstood the question. After looking around the distribution and the TDG CS, it looks like htmlhelp.xsl is the file that is used when generating htmlhelp. I couldn't find a driver either. I apologize for the confusion the previous answer may have caused Carlos -Original Message- From: Carlos Araya [mailto:[EMAIL PROTECTED]] Sent: Tuesday, January 22, 2002 9:10 AM To: [EMAIL PROTECTED] Subject: Re: DOCBOOK-APPS: HTMLHelp, XSL Driver File, Book Request for XSL customizations On 01/22/02 6:59, Maggie Strevell [EMAIL PROTECTED] wrote: Three items... First: I am trying to come up with HTMLHelp file that has a simple hierarchy. Since I am new to XML, XSL and DocBook, I am unsure if I am specifying the wrong tags or if I need to customize the HTMLHelp XSL in my XSL driver file. What I am trying to do is generate a help table of contents that 1)Has an article that isn't inside a folder/book 2) To title each folder/book without it being a link to something. I am using the docbookx.dtd. How about using a preface? The preface goes before anything but index and legal stuff if I remember correctly, look into TDG for more information, If you're using sect1 as to create the subheadings, I believe you need to customize the stylesheet or look for a parameter that does this. Second: I would like to override the XSL template for hhc-main to specify the ImageType of Book rather than Folder (which is in the original). The only difference between the example below (which is in my driver file) and the one in the original XSL is the ImageType value. This works, but is there a simpler way in my driver file to change this property? What is the best way to override a template in a driver file and make it so that I don't customize more than I need to? If there's a param.xsl file on htmlhelp you should be able to create the driver and just override the parameters. You'd still need to import docbook.xsl, but overriding parameters should be much easier than rewriting an entire template Third: Can anyone make a XSL book recommendation (or on-line tutorial, etc...) that teaches how to customize a stylesheet using a driver file? Does Norm use a htmlhelp stylesheet driver file to produce the help for the DocBook book? I have the CD, just wondering if it exists and where it might be on the CD. I'd say look at the docbook.xsl file on the htmlhelp directory for a starting point. Other people may have a different idea Many Thanks! Maggie -- Carlos E. Araya ---+ WebCT Administrator/Trainer P | California Virtual Campus - | C/O De Anza College G | 21250 Stevens Creek Blvd ---+ Cupertino, CA 95014 email [EMAIL PROTECTED] web http://www.cvc1.org/ (work) http://www.silverwolf-net.net (personal) phone 408 257 0420 (work) PGP Fingerprint:E629 5DFD 7EAE 4995 E9D7 3D2F 5A9F 0CE7 DFE7 1756 Do not meddle in the affairs of dragonsfor you are crunchy and taste good with ketchup and mayonnaise.. -- Carlos E. Araya ---+ WebCT Administrator/Trainer P | California Virtual Campus - | C/O De Anza College G | 21250 Stevens Creek Blvd ---+ Cupertino, CA 95014 email [EMAIL PROTECTED] web http://www.cvc1.org/ (work) http://www.silverwolf-net.net (personal) phone 408 257 0420 (work) PGP Fingerprint:E629 5DFD 7EAE 4995 E9D7 3D2F 5A9F 0CE7 DFE7 1756 Paradoxically, a refusal to 'put a monetary value on life' means that life is often
RE: DOCBOOK-APPS: HTMLHelp, XSL Driver File,Book Request for XSL customizations
-Original Message- From: Maggie Strevell [mailto:[EMAIL PROTECTED]] Sent: Tuesday, January 22, 2002 10:00 AM To: [EMAIL PROTECTED] Subject: DOCBOOK-APPS: HTMLHelp, XSL Driver File, Book Request for XSL customizations What I am trying to do is generate a help table of contents that 1)Has an article that isn't inside a folder/book 2) To title each folder/book without it being a link to something. I am using the docbookx.dtd. In my recent HTML Help project, I used the stylesheet only to generate the first pass of the TOC. I renamed this file, and thereafter maintained the TOC file manually (ignoring the regenerated one). If you have the HTML Help Workshop, it's much simpler to edit the TOC there - adding indentation and non-linking or customized icons, for instance - than to customize the style sheet. It also frees you from the physical structure of your document in a way that the book-oriented stylesheet does not. Of course, if you require absolutely everything to be generated, then this is not the solution for you, and I guess you'll need to customize the stylesheet. What is the best way to override a template in a driver file and make it so that I don't customize more than I need to? Can anyone make a XSL book recommendation (or on-line tutorial, etc...) that teaches how to customize a stylesheet using a driver file? These two questions are related. One place to start is with the documentation that ships with docbook.xsl. Try doc\ch01s04.html (Customizing DocBook XSL stylesheets). Good luck! Denis
RE: DOCBOOK-APPS: HTMLHelp, XSL Driver File,Book Request for XSL customizations
Appears the answer to most everything here is to customize the stylesheet via a driver file. If anyone has any other ideas (book/tutorial recommendation?), please don't hesitate. Thanks, Maggie -Original Message- From: Carlos Araya [mailto:[EMAIL PROTECTED]] Sent: Tuesday, January 22, 2002 10:50 AM To: [EMAIL PROTECTED] Subject: Re: DOCBOOK-APPS: HTMLHelp, XSL Driver File, Book Request for XSL customizations On 01/22/02 7:41, Maggie Strevell [EMAIL PROTECTED] wrote: First: A preface can't come before a book. I tried anyway, but Saxon gives an error message and looking at the DocBook Hierarchy, it appears preface must be nested in something like book. Thought of using set, but if I am reading the nesting of elements properly, you can't have a preface inside a set before a book. I've tried a few things, but have gotten worse results than the code I show here. I misunderstood your question. I thought you wanted something that goes before the content but still inside the book. I don't think there's a way of doing what you're looking for Second: I've been overriding the parameters that are simple, such as those specified in the documentation found at xsl\doc\html\index.html (params that the param.xsl refers to). This time I need to specify something that isn't in that list. Maybe the question should be: How do I reference the ImageType parameter from a XSL driver file without having to override the entire template? If it's not a parameter, then the only way I know of is to redo the template as you did in your previous message. Third: I'm open for more suggestions on where to find help on customizing stylesheets via a driver file. Does an XSL driver file that produced the HTMLHelp for docbook exist? If it's on the CD, I will keep looking. Again I misunderstood the question. After looking around the distribution and the TDG CS, it looks like htmlhelp.xsl is the file that is used when generating htmlhelp. I couldn't find a driver either. I apologize for the confusion the previous answer may have caused Carlos -Original Message- From: Carlos Araya [mailto:[EMAIL PROTECTED]] Sent: Tuesday, January 22, 2002 9:10 AM To: [EMAIL PROTECTED] Subject: Re: DOCBOOK-APPS: HTMLHelp, XSL Driver File, Book Request for XSL customizations On 01/22/02 6:59, Maggie Strevell [EMAIL PROTECTED] wrote: Three items... First: I am trying to come up with HTMLHelp file that has a simple hierarchy. Since I am new to XML, XSL and DocBook, I am unsure if I am specifying the wrong tags or if I need to customize the HTMLHelp XSL in my XSL driver file. What I am trying to do is generate a help table of contents that 1)Has an article that isn't inside a folder/book 2) To title each folder/book without it being a link to something. I am using the docbookx.dtd. How about using a preface? The preface goes before anything but index and legal stuff if I remember correctly, look into TDG for more information, If you're using sect1 as to create the subheadings, I believe you need to customize the stylesheet or look for a parameter that does this. Second: I would like to override the XSL template for hhc-main to specify the ImageType of Book rather than Folder (which is in the original). The only difference between the example below (which is in my driver file) and the one in the original XSL is the ImageType value. This works, but is there a simpler way in my driver file to change this property? What is the best way to override a template in a driver file and make it so that I don't customize more than I need to? If there's a param.xsl file on htmlhelp you should be able to create the driver and just override the parameters. You'd still need to import docbook.xsl, but overriding parameters should be much easier than rewriting an entire template Third: Can anyone make a XSL book recommendation (or on-line tutorial, etc...) that teaches how to customize a stylesheet using a driver file? Does Norm use a htmlhelp stylesheet driver file to produce the help for the DocBook book? I have the CD, just wondering if it exists and where it might be on the CD. I'd say look at the docbook.xsl file on the htmlhelp directory for a starting point. Other people may have a different idea Many Thanks! Maggie -- Carlos E. Araya ---+ WebCT Administrator/Trainer P | California Virtual Campus - | C/O De Anza College G | 21250 Stevens Creek Blvd ---+ Cupertino, CA 95014 email [EMAIL PROTECTED] web http://www.cvc1.org/ (work) http://www.silverwolf-net.net (personal) phone 408 257 0420 (work) PGP Fingerprint:E629 5DFD 7EAE 4995 E9D7 3D2F 5A9F 0CE7 DFE7 1756 Do not meddle in the affairs of dragonsfor you are crunchy and taste good with ketchup and mayonnaise.. -- Carlos E. Araya ---+ WebCT Administrator/Trainer P | California Virtual Campus - | C/O De Anza College G
Re: DOCBOOK-APPS: HTMLHelp,XSL Driver File,Book Request for XSL customizations
Maggie Strevell wrote: Second: I've been overriding the parameters that are simple, such as those specified in the documentation found at xsl\doc\html\index.html (params that the param.xsl refers to). This time I need to specify something that isn't in that list. Maybe the question should be: How do I reference the ImageType parameter from a XSL driver file without having to override the entire template? Currently there is no other way than overriding whole template. You can request this feature at and I will add it into next version of stylesheets. Third: I'm open for more suggestions on where to find help on customizing stylesheets via a driver file. Does an XSL driver file that produced the HTMLHelp for docbook exist? If it's on the CD, I will keep looking. I think that used DSSSL stylesheet for CD production. This HTML Help DSSSL was not released in public domain, it was part of Epic editor from ArborText. Jirka -- - Jirka Kosek e-mail: [EMAIL PROTECTED] http://www.kosek.cz
Re: DOCBOOK-APPS: HTMLHelp,XSL Driver File,Book Request for XSL customizations
Sorry, I forgot address for posting new feature request: https://sourceforge.net/tracker/?atid=373750group_id=21935func=browse -- - Jirka Kosek e-mail: [EMAIL PROTECTED] http://www.kosek.cz
