[publican-list] Organization issue and multiple docs

Don Domingo ddomingo at redhat.com
Fri Oct 10 03:35:50 UTC 2008


thanks for the reminder Jeff. i've already made the necessary additions 
to the Users Guide for a "Conditional Tagging" section, and i asked 
Murray to commit them since i dont have write access yet.

Jeff Fearn wrote:
> 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.
>

-------------- next part --------------
A non-text attachment was scrubbed...
Name: ddomingo.vcf
Type: text/x-vcard
Size: 318 bytes
Desc: not available
URL: <http://listman.redhat.com/archives/publican-list/attachments/20081010/0f315382/attachment.vcf>


More information about the publican-list mailing list