[publican-list] RFC: Supporting RevisionFlag attribute

Paul Morgan pmorgan at redhat.com
Thu May 6 12:56:35 UTC 2010


On Wed, May 05, 2010 at 10:47:01AM +1000, Jeffrey Fearn wrote:
> Currently RevisionFlag isn't used by Publican, I think it can be 
> used to  aid reviewing documentation.
>
> http://www.docbook.org/tdg/en/html/ref-elements.html#common.attributes
>
> The idea being that when an author modifies a book, they set the  
> RevisionFlag and if the book is in draft mode then Publican would  
> highlight that tag.
>
> e.g.
>
> RevisionFlag="Changed" might have a yellow background.
> RevisionFlag="Added" might have a green background.
> RevisionFlag="Deleted" might have strike through applied.
>
> This way reviewers would get visual queues about what has happened 
> at the tag level.
>
> It probably makes sense to only use this at the block level, para 
> etc, but I don't see any reason to enforce that usage.

I haven't hacked xslt enough; would change bars be possible?

-paul




More information about the publican-list mailing list