Re: [docbook-apps] Adding user comments to HTML output

[Tom_Towle@bcbsil.com]

Hi, I have built a prototype commenting system using open source
Flexbuilder 3.0 (yes Adobe has offered Flex to the world) with a PHP MYSQL
backend to provide the commenting. It is using DITA to produce the HTML
output but I think it could accomodate Docbook easily enough. Take a look
and leave a comment:) Here is the link.
http://site.oakhillgarden.com/dita/demos/frameset.html
 Mind you it is a draft prototype so any feedback on the interface is much
appreciated. I am also looking for any kind of statistics proving or
disproving the efficacy of such an approach to user documentation feedback
in real time mode.
I am presenting this as a paper at the Content Management Conference in
Florida later this month so any feedback would be reflected back to the
community.


                                                                           
             Doug                                                          
             <doug.duboulay@gm                                             
             ail.com>                                                   To 
                                       docbook-apps@lists.oasis-open.org   
             04/16/2009 06:12                                           cc 
             PM                                                            
                                                                   Subject 
                                       Re: [docbook-apps] Adding user      
                                       comments to HTML output             
                                                                           
                                                                           
                                                                           
                                                                           
                                                                           
                                                                           




Hi Paul,

On Thu, 16 Apr 2009, Paul Millar wrote:
> Hi all,
>
> I'm looking to add support for allowing user comments within DocBook
> generated HTML output.  It's not such an original idea (people like
> PostGreSQL and PHP have had this feature for a while) but I recently came
> across it again with the Hg book:
>
>            http://hgbook.red-bean.com/read/
>
> With the hgbook above, it looks like they're doing this using JavaScript
to
> add the comments rather than adjusting the HTML XSLT customisation layer
to
> emit the right HTML.  My preference would be to add this at the XSLT
> customisation layer.
>
> My college suggested using http://www.intensedebate.com Although these
> people look good, I would like to use some open-source software rather
than
> relying on an external supplier.
>
> So, two questions:
>
>  a.  anyone had any experience with adding support for
>       in-document user-generated command with DocBook?

>  b.  has anyone had any experience with specific commenting
>       systems/scripts, such as www.intensedebate.com ?

Take a look at annotate:
   http://www.brettnacher.org/annotate/

Its an XSLT customisation combined with a CGI script.
It worked quite well for me when I tried it, but boy did it ever
attract the spam monkeys.

cheers
Doug

---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org






**********

The information contained in this communication is confidential, private, proprietary, or otherwise privileged and is intended only for the use of the addressee.  Unauthorized use, disclosure, distribution or copying is strictly prohibited and may be unlawful.  If you have received this communication in error, please notify the sender immediately at (312)653-6000 in Illinois; (800)835-8699 in New Mexico; (918)560-3500 in Oklahoma; or (972)766-6900 in Texas.

**********