[publican-list] Organization issue and multiple docs

[Jeff Fearn]

Mike McGrath wrote:
> On Thu, 9 Oct 2008, Paul W. Frields wrote:
> 
>> On Thu, 2008-10-09 at 12:46 -0400, Jared Smith wrote:
>>> On Thu, 2008-10-09 at 11:40 -0500, Mike McGrath wrote:
>>>> Ok, thats freaking awesome.  Is there a way to build a book where
>>>> "role==users" ?
>>> Absolutely... I'm not sure what the proper way to do this in Publican
>>> is, but my own toolchains have always just had a setting in the Makefile
>>> that generates the document based on a particular role.  If you're using
>>> xsltproc to process your XML, you can simply set "--stringparam
>>> profile.condition users" to have it only process nodes that have no role
>>> set or the role == users.
>> Jared makes a great point I stupidly left out, which is that by leaving
>> the @role out entirely, you more-or-less guarantee that an XML element
>> will be in all the versions of the document.  You only need to put the
>> @role in where it's needed.
>>
> 
> yeah, I think this is exactly what I want, now I just have to figure out
> how to get it to work with publican.
> 

Hi Mike, publican does not use the role attribute for profiling docbook. This is because some tags use the role attribute for controlling styling of output instead of profiling.

e.g. In the default DocBook XSL the para tag uses role to set the css class in XHTML.

Publican uses the condition attribute for profiling as this is exclusively used this way and avoids confusion as to what the usage of role means for any particular use.

Say you have three conditions, admin, dev, user:

<para condition="admin"> For admins

<para condition="admin,dev"> For admins and devs

make CONDITION=admin html-en-US

You can also hard code CONDITION in your Makefile.

Building conditional desktop rpms is not currently supported as there is no way to differentiate the rpms.

I do believe Don owes me some user documentation on this feature ... pokety poke!

Cheers, Jeff.

-- 
Jeff Fearn <jfearn at redhat.com>
Software Engineer
Engineering Operations
Red Hat, Inc
Freedom ... courage ... Commitment ... ACCOUNTABILITY