OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

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

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.
 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

             ail.com>                                                   To 
             04/16/2009 06:12                                           cc 
                                       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
> add the comments rather than adjusting the HTML XSLT customisation layer
> 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
> 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:

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.


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.


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]