>-----Original Message----- >From: [EMAIL PROTECTED] >[mailto:[EMAIL PROTECTED] On Behalf Of >John Maddock >Sent: 10 December 2006 17:10 >To: Boost documentation format, structure, and processing discussion >Subject: Re: [Boost-docs] questions on pdf documentation using >quickbookandboostbook
>I've had no end of difficulty getting decent PDF's from >DocBook: Apache FOP >in particular is pretty useless IMO. It's not helped by the >fact that many >of the things we take for granted are actually supplied by the >.css style >sheets in the HTML version (i believe this is the case in the >two examples >you site above). > >I could be wrong but I don't believe there are any options we >can inject >into the Docbook XML to control these formatting options: >they're controlled >by the XSL stylesheets that translate Docbook-XML to FO. >While there are >some stylesheet options that can control this, a lot of the >things I would >like to see in PDF output (syntax highlighting of code for >example) can only >be achieved by writing a custom Docbook->FO translation layer. I would just observe that although the end result of John's struggles (using a commercial product) lacks nice features like colored code, the pdf still has advantages over the html when it comes to navigating. Since the documentation for John's Math Functions are now over 200 pages (phew!) I have difficulties finding things even if I wrote a bit of it. Using a pdf reader one can search the whole document for words etc - which is a bit of a substitute for a proper index. Making indexes manually is obviously obselete - and I'm bored just writing docs, never mind the index ;-) Google does also already help - but I am now clear how to limit the search to just one document in Boost? Can we use the Google desktop indexing to provide this somehow? Paul --- Paul A Bristow Prizet Farmhouse, Kendal, Cumbria UK LA8 8AB +44 1539561830 & SMS, Mobile +44 7714 330204 & SMS [EMAIL PROTECTED] ------------------------------------------------------------------------- Take Surveys. Earn Cash. Influence the Future of IT Join SourceForge.net's Techsay panel and you'll get the chance to share your opinions on IT & business topics through brief surveys - and earn cash http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV _______________________________________________ Boost-docs mailing list [email protected] Unsubscribe and other administrative requests: https://lists.sourceforge.net/lists/listinfo/boost-docs
