[publican-list] Organization issue and multiple docs

Murray McAllister mmcallis at redhat.com
Fri Oct 10 04:13:27 UTC 2008


Don Domingo wrote:
> 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.
> 
I committed your changes to svn.
> 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.
>>
> 
> _______________________________________________
> publican-list mailing list
> publican-list at redhat.com
> https://www.redhat.com/mailman/listinfo/publican-list
> Wiki: https://fedorahosted.org/publican




More information about the publican-list mailing list