Re: [Boost-users] QuickBook

Subject: Re: [Boost-users] QuickBook
From: OvermindDL1 (overminddl1_at_[hidden])
Date: 2010-08-15 18:45:28

On Sun, Aug 15, 2010 at 1:51 AM, Daniel James <dnljms_at_[hidden]> wrote:
>> Heh, well fop is what quickbook recommends and uses
>
> No it isn't.

Well on:
  http://boost.org/doc/libs/1_43_0/doc/html/boostbook/getting/started.html
and:
  http://beta.boost.org/doc/libs/1_44_0/doc/html/boostbook/getting/started.html
and the auto setup script those pages mention, they all only talk about fop

On Sun, Aug 15, 2010 at 1:51 AM, Daniel James <dnljms_at_[hidden]> wrote:
>> never heard of xep, will it pick it up if I aptitude install it?
>
> No, it's not open source.
>
> https://svn.boost.org/trac/boost/wiki/BoostDocs/GettingStarted#Howtobuildpdfs

If that is the current documentation, then the official docs need to
be updated, pretty badly, as linked to above...

On Sun, Aug 15, 2010 at 1:54 AM, Daniel James <dnljms_at_[hidden]> wrote:
> On 14 August 2010 17:29, OvermindDL1 <overminddl1_at_[hidden]> wrote:
>>
>> How can I pull this off?
>
> It's not supported. You'll have to write your code out twice for now.
> You could implement it yourself if it's really a problem.

Hmm, maybe later, I am not doing this for myself, but a different
open-source project.

On Sun, Aug 15, 2010 at 2:43 AM, John Maddock <boost.regex_at_[hidden]> wrote:
>>>> Also, the onehtml does not want to use the boostbook.css where the
>>>> html one uses it fine. Is it trying to include it manually into the
>>>> file somehow, and if so, it seems like it is not finding the file
>>>> (same directory as the root qbk file, the specified root directory),
>>>> where does it need to be or how do I tell it where the file is
>>>> located?
>>>>
>>>
>>> Look at the html source to see what stylesheet it uses.
>>
>> It does not, that is the problem, it has no stylesheet import or
>> anything, else I would have done so, but onehtml does not use a
>> stylesheet at all in the generated html.
>
> I think what happens here is that our XSL stylesheets for html generation
> set a default value for the css stylesheet to use, but the XSL wrapper used
> for the "onehtml" target doesn't.  You can always set your own stylesheet
> for the html to use using an xsl:param of course, but maybe we should fix
> the onehtml target to be as similar as possible to the html one  - just with
> chunking turned off?

What xsl:param do I use?  I did not see this in quickboook or boostbook's docs.

On Sun, Aug 15, 2010 at 5:45 AM, Paul A. Bristow
<pbristow_at_[hidden]> wrote:
>> From: boost-users-bounces_at_[hidden] [mailto:boost-users-bounces_at_[hidden]] On Behalf Of Daniel James
> But RendeX helpfully gave permission for it to be used free to generate Boost docs.
>
> Otherwise you probably should buy it :-(
>
> (Unlike fop, it actually works ;-)
>
> (I found specifying the line in my user-config was picky
>
> # XSLT-FO processor from RenderX.com
> using fop
> Â : # XEP batch filename
> Â # Note you may need to increase the Java heap size.
> Â  "C:/Progra~1/renderx/xep/xep.bat" # OK
> Â # "C:/Program Files/renderx/xep/xep.bat" # Definitely does NOT seem to work.
> Â # "C:\\Program Files\\renderx\\xep\\xep.bat" # NOT OK
> Â #'C:\Program' is not recognized as an internal or external command, operable program or batch file.
>
> Â # Java executable called by xep.bat.
> Â # C:/PROGRA~1/Java/jre6 #OK
> Â # "C:/PROGRA~1/Java/jre6" # OK
> Â #"C:/Program files/Java/jre6" # OK
> Â  "C:\\Program files\\Java\\jre6" # OK
> Â #"C:\Program files\Java\jre6" # NOT OK
> Â ;
>
> # Â actually C:\Program Files\RenderX\XEP\xep.bat
> #  actually  C:\Program Files\Java\jre6

I am doing this on linux currently, but easy enough to figure out
paths, however I need something that will not cost money as if this is
used, it will be used for a major and rather large open-source
project.