From giunta.gaetano at sea-aeroportimilano.it  Thu Sep 14 12:38:12 2006
From: giunta.gaetano at sea-aeroportimilano.it (Gaetano Giunta)
Date: Thu Sep 14 12:38:53 2006
Subject: [docbook-css] css enhancements for function prototypes
Message-ID: <001a01c6d7fa$a5297030$9701010a@sea.spa.dom>

Hello

I just tried the 0.4 css available on http://www.badgers-in-foil.co.uk/projects/docbook-css/ on the docbook I use for the php-xmlrpc project documentation.


I found it to be lacking in the formatting of "funcprototype" elements, so i added a custom set of rules, with the goal of having function prototypes looking as similar as possible to the results of applying the stock xslt transforms.

Some of these rules will only be shown by Opera or Mozilla, since they depend on :before and ;after pseudo-selector, which IE6 does not support.

Feel free to test out these additions and incorporate them into the main distribution.

Note that i still have a problem with multiple funcprototype elements inside a funcsynopsis: i would like these to appear on multiple lines, while by default they all appear on the same line.
I tried setting funcprototype to display:block, but this has the drawback of loosing the vertical aligment with the surrounding sections. I was hoping for something like funcprototype:after { content: "\A" } but it looks like only Opera currently supports this...

Any hint?

Thanks
Gaetano

ps: There is an oldish msg in the list mentioning the css moving to the official sf.net docbook site. has it happened? is it planned?

pps: here follow the css rules and example function definitions
----------------------------------------
funcprototype {
	font-family:monospace;
}
funcprototype:after {
  	content:");";
}
funcdef:after {
	content:"(";
}
paramdef type:after {
	content:" ";
}
funcdef function {
	font-weight:bold;
}
paramdef initializer:before
{
	content:" = ";
}
paramdef:after
{
  	content:",";
}
/* remove the extra comma after the last paramdef of a funcprotoype */
paramdef:last-child:after
{
  	content:"";
}
----------------------------------------
        <funcsynopsis>
          <funcprototype>
            <funcdef>$msg = new <function>xmlrpcmsg</function></funcdef>
            <paramdef><type>string</type><parameter>$methodName</parameter></paramdef>
            <paramdef><type>array</type><parameter>$parameterArray</parameter><initializer>null</initializer></paramdef>
          </funcprototype>
        </funcsynopsis>
----------------------------------------
From dave at badgers-in-foil.co.uk  Thu Sep 21 10:05:10 2006
From: dave at badgers-in-foil.co.uk (David Holroyd)
Date: Thu Sep 21 10:05:25 2006
Subject: [docbook-css] css enhancements for function prototypes
In-Reply-To: <001a01c6d7fa$a5297030$9701010a@sea.spa.dom>
References: <001a01c6d7fa$a5297030$9701010a@sea.spa.dom>
Message-ID: <20060921100510.GB376@badgers-in-foil.co.uk>

Hi there!

On Thu, Sep 14, 2006 at 02:38:12PM +0200, Gaetano Giunta wrote:
> I just tried the 0.4 css available on http://www.badgers-in-foil.co.uk/projects/docbook-css/ on the docbook I use for the php-xmlrpc project documentation.
> 
> 
> I found it to be lacking in the formatting of "funcprototype" elements, so i added a custom set of rules, with the goal of having function prototypes looking as similar as possible to the results of applying the stock xslt transforms.
> 
> Some of these rules will only be shown by Opera or Mozilla, since they depend on :before and ;after pseudo-selector, which IE6 does not support.
> 
> Feel free to test out these additions and incorporate them into the main distribution.

I will do.  Thank you!

I just need to add your example to the set of test files.


> Note that i still have a problem with multiple funcprototype elements inside a funcsynopsis: i would like these to appear on multiple lines, while by default they all appear on the same line.
> I tried setting funcprototype to display:block, but this has the drawback of loosing the vertical aligment with the surrounding sections. I was hoping for something like funcprototype:after { content: "\A" } but it looks like only Opera currently supports this...

Not much time to look into it right not, I'm afraid.  Certainly things
are better than they where for the addition of these styles, so I will
add them as they are.


> ps: There is an oldish msg in the list mentioning the css moving to
> the official sf.net docbook site. has it happened? is it planned?

The stylesheets are now officially hosted in the DB sf.net Subversion
repository.  I've not made a release since the move happened though.

  http://svn.sourceforge.net/viewvc/docbook/trunk/css/xml/docbook/

Not been working with any docbook stuff these last many months :(


ta,
dave

-- 
http://david.holroyd.me.uk/