Proposal for Implementing a Docbook Editor

[Yaakov Nemoy]

2009/3/21 Matthew Daniels <danielsmw at gmail.com>:
> Satya,
>
> A docbook XML editor, especially web-based as you propose, could definitely
> be useful for the docs team. I don't think it would totally eliminate the
> need to know XML, but it doesn't need to. Just giving a way for contributers
> to write content without having to learn a rich markup language would
> probably mean we could recruit more people and get things done faster.
>
> Keep us updated on your progress!

I've also found that for some people (myself included) that having WSYWIG and XML side by side can work as a good on the job learning aid. You could certainly market it as away for beginners to get used to working with XML.

-Yaakov

>
> On Mar 21, 2009, at 8:04 AM, satya komaragiri <satya.komaragiri at gmail.com>
> wrote:
>
>> Hello,
>>
>> I am a final year undergraduate student from India and I plan to apply
>> for Google Summer of Code. I would like to implement a Docbook editor.
>> I discussed this idea with Mr. Yaakov Nemoy (cc'ed in this mail) who
>> has agreed and is guiding me through the process.
>>
>> The Docbook editor will make it easy to write documentation through a
>> wysiwyg interface. Since Docbook has a great collection of XSLs[1] it
>> will be easy to convert it to HTML and write a web based editor.
>>
>> My research has pointed me to Beacon[2], which is a similar editor for
>> GuideXML (Gentoo's documentation format). It uses an XSLT engine to
>> transform XML to HTML and vice versa. I contacted the developer of
>> this project and it seems like this project has been in hibernation
>> for couple of months or so. But the codebase is quite developed and
>> should be easy to work with. The developers were also making it a
>> generic plug-able framework for easy integration of other doc types.
>>
>> Since it is a web-based editor, we can integrate this into the Fedora
>> documentation site for easy editing and creation.
>>
>> It would be very nice if the Docs team could provide some feedback on
>> what they feel about  a web-based GUI editor which would eliminate the
>> need for knowing the Docbook XML format. If I am given a go ahead, I
>> would like to put this up as a Feature.
>>
>> Regards,
>> Satya Komaragiri
>>
>>
>> [1]  Existing XSL for Docbook:
>> http://wiki.docbook.org/topic/DocBookXslStylesheets
>> [2]  Beacon: http://beacon.kix.in/
>>
>> --
>> fedora-docs-list mailing list
>> fedora-docs-list at redhat.com
>> To unsubscribe:
>> https://www.redhat.com/mailman/listinfo/fedora-docs-list
>
> --
> fedora-docs-list mailing list
> fedora-docs-list at redhat.com
> To unsubscribe:https://www.redhat.com/mailman/listinfo/fedora-docs-list
>

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 270 bytes
Desc: OpenPGP digital signature
Url : http://lists.fedoraproject.org/pipermail/docs/attachments/20090322/2a063af2/attachment.bin