Re: [docbook-apps] A Few Style Questions from a Beginner

[David Shevitz <dshevitz at singlestep dot com>]

Ah. It is an article that I'm using at the moment. I could have a table 
of contents, but I turned it off (I was/am hoping to use FOP's 
extensions to create PDF bookmarks, which I think makes for better 
navigation. I'm still not sure I can't get that working, or even if its 
the best idea. But I digress.)

When I did have the TOC running, this title appeared before it. 
Essentially, it's the first thing that gets printed (or so it appears).

I'm sure this is just a "figure out what it's called" issue. There's 
just so many items, that it's easy to get lost.

Again, thanks!

Dave

PS--I use the DocBook XSL Guide all the time... it's an invaluable 
resource, and the more I learn about this stuff, the more use I get out 
of it... So thanks!

Bob Stayton wrote:

> DocBook uses the term "title page" to mean all the titles and information
> before the content of an element starts, regardless of whether it is on its
> own page or not.  And the term is used for all division levels in the
> document. So a section has a "title page" too, even though it is usually
> just the section title without any page breaks.
>
> I'm not clear on what kind of document you have.  It doesn't look like a
> book. Is it an article?  Does the table of contents appear anywhere?
>
> Bob Stayton
> Sagehill Enterprises
> DocBook Consulting
> bobs@sagehill.net
>
>
> ----- Original Message ----- 
> From: "David Shevitz" <dshevitz@singlestep.com>
> To: <docbook-apps@lists.oasis-open.org>
> Sent: Tuesday, June 15, 2004 12:18 PM
> Subject: Re: [docbook-apps] A Few Style Questions from a Beginner
>
>
>  
>
> >    
> >
> > > > Hello all,
> > > >
> > > > My apologies if this isn't the correct forum for these questions, but I
> > > > am on my own as I learn how to best use DocBook, XML, and such.
> > > >
> > > > I have successfully created a DocBook XML file and, using FOP, created a
> > > > PDF from it. I have even learned how to create a customization layer so
> > > > the PDF output conforms to my company's style conventions. However, I
> > > > have hit two snags:
> > > >
> > > > 1. When I create the PDF, a default title appears. It is in a large
> > > > font, centered. I have been trying to find what template applies to this
> > > > title, but to no avail. Does anyone know about this title, and what I
> > > > need to do to change its appearance?
> > > >
> > > >
> > > >        
> > > When you say the default title, I presume you mean the title of your
> > > document but appearing in the default location where you don't want it?
> > >
> > > If so, your customization is probably has a template that processes a
> > > sequence of elements where you want them, but it hasn't turned off the
> > > template that gets applied by default.  In general, the stylesheets
> > >      
> operate
>  
>
> > > by doing apply-templates recursively (sometimes in a special mode). So in
> > > many cases you have to redefine a template to perform no action because
> > >      
> your
>  
>
> > > customized template already handled that element.
> > >
> > > The title page stuff has many templates that it can use to provide a lot
> > >      
> of
>  
>
> > > opportunities for customization.  This reference lists the modes that are
> > > tried for each element on a title page:
> > >
> > > http://www.sagehill.net/docbookxsl/HtmlCustomEx.html#d0e10008
> > >
> > > You may need to add something like this:
> > >
> > > <xsl:template match="title" mode="book.titlepage.recto.mode">
> > > </xsl:template>
> > >
> > >
> > >
> > >      
> > Thanks. Unfortunately, I'm still having trouble tracking down this
> > title. Basically, when I output into a PDF, my first page appears as
> > follows:
> >
> > TITLE OF DOCUMENT
> >
> > First Section Title
> > First Section Content
> >
> > Second Section Title
> > Second Section Content
> >
> > Its the "TITLE OF DOCUMENT" that I want to modify. The information I am
> > reading on title pages seem to be a separate matter (i.e., creating an
> > actual title page, which is not what I want). I've tried
> > compont.title.properties, matching a template to article/title, all
> > without much luck. Perhaps the information I've supplied might be enough
> > to ring a bell with anyone else?
> >
> >    
> >
> > > > 2. Similar to #1, I have learned how to change some of the font
> > > > properties associated with the header and footer in the PDF output.
> > > > However, the header and footer continue to be centered, when I would
> > > > like them to be flush left. None of the parameters I have found have
> > > > successfully changed the justification for these sections. Could anyone
> > > > point me in the right direction?
> > > >
> > > >
> > > >        
> > > The headers and footers are formatted as a table with three cells: left,
> > > center and right. Your content is probably in the center cell, and will
> > > always be centered.  You want to put your content in the left cell.  See
> > > this reference to customize the header content:
> > >
> > > http://www.sagehill.net/docbookxsl/PrintHeaders.html
> > >
> > > You may also want to change the relative size of the cells, using the
> > > 'header.column.widths' parameter.  See the doc included with the
> > >      
> stylesheets
>  
>
> > > (the online doc hasn't been updated to 1.65.1 yet).
> > >
> > >
> > >
> > >      
> > This did work much better--many thanks! My headers and footers still
> > aren't _quite_ what I want, but I'm much closer and I'm sure I'll figure
> > it out eventually.
> >
> > Thanks in advance for any additional help,
> >
> > Dave
> >
> > To unsubscribe from this list, send a post to
> >    
> docbook-apps-unsubscribe@lists.oasis-open.org, or visit
> http://www.oasis-open.org/mlmanage/.
>  
>
> >    
>
>
>
> To unsubscribe from this list, send a post to docbook-apps-unsubscribe@lists.oasis-open.org, or visit http://www.oasis-open.org/mlmanage/.
>
>
>  

To unsubscribe from this list, send a post to docbook-apps-unsubscribe@lists.oasis-open.org, or visit http://www.oasis-open.org/mlmanage/.