Re: [docbook-apps] docbook 5 cover page example

On 1/25/07, Bob Stayton <bobs@sagehill.net> wrote:

Hi,

Ah, there is a bit of a misunderstanding here. Your book.titlepage.recto template is outputting an unprocessed <mediaobject> element to your FO file instead of what it gets processed into, which is a <fo:external-graphic> element. Your XSL-FO processor doesn't know how to handle that <mediaobject> element.

The titlepage spec mechanism is kind of complicated, but that's because everyone wants their titlepage to be different. There are many potential elements in bookinfo that could be on the title pages, in many orders, and in many different formats. The titlepage spec file lets you specify those things without having to write full XSL-FO code to format them. It is a code generator. But there are times when you don't need all that complexity, and you can bypass it and write your own XSL-FO code instead.

My suggestion of editing a copy of titlepage.templates.xml was to add a mediaobject element to the titlepage specs. But that is for handling a mediaobject inside the bookinfo element so you can have a different image for each document, specified in the document itself.

In your case, it looks like what you want is a constant logo, which would be output in all documents, so you wouldn't want or need to specify the logo filename in each document. If that is the case, you can skip the titlepage specification step and simply edit the template with name="book.titlepage.recto", as in your first attempt. You just need to provide the correct XSL-FO syntax instead of DocBook elements:



<xsl:param name="logo.filename">images/logo.jpg</xsl:param>



<xsl:template name="book.titlepage.recto">
<fo:block>
    <fo:external-graphic src="url($logo.filename)"
          width="100%" content-width="scale-to-fit"/>
</fo:block>
</xsl:template>

This will output the logo image full width onto the front page, and nothing else. If you want a title or such, then take a look at the template with that name in fo/titlepage.templates.xsl to see how it handles the other elements like titles, and add them to your custom template.

Bob Stayton
Sagehill Enterprises
DocBook Consulting
bobs@sagehill.net

----- Original Message -----

From: Linux Solutions

To: Bob Stayton

Cc: docbook-apps@lists.oasis-open.org

Sent: Thursday, January 25, 2007 6:09 PM

Subject: Re: [docbook-apps] docbook 5 cover page example

Thanks for the information. I was hoping for a much easier way of adding an image to the title page. Here's what I have been doing unsuccessfully,

1. Copy docbook-xsl/fo/title.template.page.xml as custom.xml
2. Edit custom.xml and add <mediaobject/> to <bookinfo>
3. Generate custom.xsl from custom.xml using xsltproc
4. Create a mycustom.xsl that includes custom.xml and custom.xsl with <mediaobject/>. For example,


<?xml version="1.0"?>
<xsl:stylesheet version='1.0' xmlns:xsl="http://www.w3.org/1999/XSL/Transform " xmlns:fo="http://www.w3.org/1999/XSL/Format">
<xsl:import href="/opt/docbook-xsl-1.71.1/fo/docbook.xsl"/>
<xsl:include href="/opt/docbook- xsl-1.71.1/fo/custom.xsl"/>
<xsl:import href="/opt/docbook-xsl-1.71.1/fo/custom.xml"/>

<xsl:template name="book.titlepage.recto">
<mediaobject>
    <imageobject>
        <imagedata fileref="images/logo.jpg" format="JPEG" />
    </imageobject>
</mediaobject>
</xsl:template>
</xsl:stylesheet>
<! -- END XSL -->

5. I get an error when I compile, but xsltproc processes my XML files and so does FOP. I have the PDF without the title image. I don't recall the error completely other than the root element should be one of article..... something like that. I can try it and get the exact error if it helps.

Any help would be appreciated.

Thanks

On 1/25/07, Bob Stayton <bobs@sagehill.net > wrote:

Hi,

Unfortunately, cover is not currently implemented in the stylesheets. The cover element was added to allow a document to specify the information to appear on a cover. In practice, a cover is not usually generated with the document output because it has to be in a separate output file for production purposes.

I think what you want is to add an image to your titlepage. That can be done using the titlepage spec file mechanism, as described in this section:

http://www.sagehill.net/docbookxsl/TitlePagePrint.html#AddingTitlepageGraphics

The section titled "Titlepage spec file" on that HTML page describes how to process the spec file after you have customized it. Then any mediaobject inside your bookinfo or info element will be output on the titlepage.

Bob Stayton
Sagehill Enterprises
DocBook Consulting
bobs@sagehill.net

----- Original Message -----

From: Linux Solutions

To: docbook-apps@lists.oasis-open.org

Sent: Thursday, January 25, 2007 12:32 PM

Subject: [docbook-apps] docbook 5 cover page example

Hello,

I'm trying to get an image on the index page and my attempts have been unsuccessful. I have read numerous posts (including sagehill books) about customizing it with XSL templates and all. It is quite confusing and complicated for a docbook newbie and my attempts have failed.

I moved to docbook 5 (and docbook5-xsl-1.72.0) to use the cover page feature which makes it easier to add the image on the first page.

To begin with, I coped and saved the example from the following link to add a JPG logo to the first page,
http://www.docbook.org/tdg5/en/html/cover.html

The book compiles fine using xsltproc with FOP 0.93, but I don't see an image. but everything else is available.

I'm lost and does anyone have any experience or ideas to get this done?

Thanks in advance!

docbook-apps message