Re: [PHP-DOC] Re: PDF with internal links
Jouni, maybe you could contact the people who generated the XML documentations PDF format at W3C. They used some html2ps utility, and the links are fine ;) Easiest, but not free way how to get PDF file with links from DocBook is to use Jade to generate RTF output. This output you can then open in MS Word and use Acrobat Distiller to get PDF. Heh :) And not a one that can be automated. Extract from the XML Spec (Second edition) I appendix Production notes: "The PDF version was produced with the html2ps facility and a distiller program" Goba
Re: [PHP-DOC] Re: PDF with internal links
as a side project, make some progress on the XSLT front, the tools seem to be maturing. Jirka, I remember that you and Jim did some experimenting with XSLT transformer tools in the beginning of this year. Would you make a summary of what the results were and why we aren't using those tools yet, or, if you have already done that, point me to it? We are exactly on the same way here ;) I contacted Jirka about those XSLT sheets, and what they can do, and got some good letters. Especially it seems that the XSLT ones are better for chm generation, as we can generate the three documents needed for the CHM make program in one step, and no need for those tricky but ugly PHP regexs in make_chm.php and make_chm_fancy.php :)) Quotes from Jirka about this subject (from personal letters): I have used XSLT stylesheets to generate CHM from phpdoc few months ago with great success. If you have any problems, don't hesitate contact me. Current DocBook XSL stylesheets contains out-of-the box support for HTML Help, so there is no need for downloading separate archive from my site. XSL stylesheets work perfectly, only problems is that many people are not used to them (many unix system comes with DSSSL support but not with XSL). I ported main customizations from DSSSL to XSL quite ago. It looked to me that noone uses this stuff, so I did not add new features. If there is something missing what is in DSSSL and not XSL tell me, I can fix it. And you can read README.xsl in the phpdoc root to get some info how you can build the docs using XSLT. Goba
Re: [PHP-DOC] Re: PDF with internal links
On Sun, 5 Aug 2001, Hojtsy Gabor wrote: And you can read README.xsl in the phpdoc root to get some info how you can build the docs using XSLT. Did it. Somehow I have missed realizing that there's already so much work done... I'll start playing with this. Don't expect immediate results. -- Jouni
Re: [PHP-DOC] Re: PDF with internal links
On Sun, 5 Aug 2001, Hojtsy Gabor wrote: And you can read README.xsl in the phpdoc root to get some info how you can build the docs using XSLT. Did it. Somehow I have missed realizing that there's already so much work done... I'll start playing with this. Don't expect immediate results. Actually I got some results. It's sad, but DocBook XSL isn't yet ready for production use if you want a printable version. HTML is quite ok. Maybe Jirka Kosek can say something positive about the PDF version. He is involved closely in DocBook XSL stylesheets IMHO. Goba
Re: [PHP-DOC] Re: PDF with internal links
On Sun, 5 Aug 2001, Hojtsy Gabor wrote: Maybe Jirka Kosek can say something positive about the PDF version. He is involved closely in DocBook XSL stylesheets IMHO. Let's hope so. -- Jouni
Re: [PHP-DOC] Re: PDF with internal links
Hojtsy Gabor wrote: Maybe Jirka Kosek can say something positive about the PDF version. He is involved closely in DocBook XSL stylesheets IMHO. The problem of generating PDFs with XSL stylesheet isn't in stylesheets but in FO processors. All current free implementations of XSL FO (PassiveTeX, FOP) have some serious limitations. IMHO for these days, it is better to use XSL for getting HTML and HTML Help output and stay with DSSSL for getting printed version. I think that in one year maturity of XSL FO processors will be better than Jade, but not for now. For using XSLT for getting HTML are two main reasons - with libxslt it is faster than using DSSSL+Jade and generated HTML code is much pretty than from Jade. Jirka - Jirka Kosek e-mail: [EMAIL PROTECTED] http://www.kosek.cz
Re: [PHP-DOC] Re: PDF with internal links
On Sun, 5 Aug 2001, Jirka Kosek wrote: The problem of generating PDFs with XSL stylesheet isn't in stylesheets but in FO processors. All current free implementations of XSL FO (PassiveTeX, FOP) have some serious limitations. IMHO for these days, it is better to use XSL for getting HTML and HTML Help output and stay with DSSSL for getting printed version. I think that in one year maturity of XSL FO processors will be better than Jade, but not for now. Ah, I'm reliefed. There's still quite a lot of time to learn XSL. If I have understood it right, you are somehow involved with the development of DocBook XSL and, if not directly, you at least follow the development of some FO processor. Please drop a note to this list when you think it would be the time to test and seriously consider switching the PDF generating tools. Unless, of course, you just do the switch yourself... I think you are one of the few (maybe the only one) who actually knows what he's speaking about when it comes to XSL. -- Jouni
[PHP-DOC] Re: PDF with internal links
Hojtsy gbor wrote: Jouni, maybe you could contact the people who generated the XML documentations PDF format at W3C. They used some html2ps utility, and the links are fine ;) Easiest, but not free way how to get PDF file with links from DocBook is to use Jade to generate RTF output. This output you can then open in MS Word and use Acrobat Distiller to get PDF. Jirka - Jirka Kosek e-mail: [EMAIL PROTECTED] http://www.kosek.cz