Jim Campbell | 1 May 18:23 2009
Picon

Re: [docbook] Best wiki engines or tools for wiki-to-docbook conversions?

COUTHURES Alain wrote:
> Hello Jim,
>> The project's current documentation is written in docbook, but as 
>> part of this effort, we want to make it easier for new contributors 
>> to write documentation without overwhelming them with the details of 
>> docbook.
> Yes, it's important for new contributors and my current project 
> (XSLTForms) has now a documentation in wiki format even though I would 
> prefer an XML notation such as Docbook.
>> With that in mind, in your experience, what open-source wiki engines 
>> (if any) provide the best output to docbook? If you can't think of 
>> any, what tools may provide the best means of converting wiki text to 
>> docbook?
> I would seriously consider using an XSLT stylesheet. With just adding 
> a document element, even XSLT 1.0 can parse text in wiki format. It 
> might sound weird but I have already parsed CSS stylesheets and XPath 
> expressions with XSLT 1.0 only. Today, XSLT 1.0 is well supported by 
> almost any environment, at client-side and at server-side.
>
> My current project is an XForms implementation at client-side 
> (http://www.agencexml.com/xsltforms). I have already thought of a wiki 
> editor being integrated in a form in place of a textarea control and 
> an extension function could, even, locally perform the XSLT 
> transformation to DocBook notation before submitting it !
>
> What do you think of this ?
>
> Best regards,
>
> Alain Couthures
(Continue reading)

Bob Stayton | 4 May 18:57 2009
Picon

Re: Generating modified 5.0 DTD using mods to RELAX NG version

Hi Bob,
Yes, the DTD for 5.0 was generated from the RelaxNG schema by Norm Walsh using automated tools that included Trang, but possibly including some other massaging to get it to work.  You might ask Norm directly.
 
Bob Stayton
Sagehill Enterprises
bobs <at> sagehill.net
 
 
----- Original Message -----
Sent: Tuesday, April 28, 2009 10:38 AM
Subject: [docbook] Generating modified 5.0 DTD using mods to RELAX NG version

I created an RNG schema modification file, as described at http://www.docbook.org/docs/howto/, and using jing I can validate a demo document against it.
 
Next, I tried to create a DTD from my modification file using trang, but got a lot of errors. Even using trang to try to convert docbook-5.0\rng\docbook.rng with no reference to modifications, I get about 100 error messages. Most say 'error: sorry, cannot handle this kind of "choice"', but many follow this format:
 
  sorry, not handled: duplicate declaration of element "info" from namespace "http://docbook.org/ns/docbook"
 
Were the official distribution DTD versions created using an automated tool, and if so, which one? 
 
thanks,
 
Bob
Disclaimer:
-----------

"This e-mail and any files transmitted with it are for the sole use of the intended recipient(s) and may contain confidential and privileged information. If you are not the intended recipient, please contact the sender by reply e-mail and destroy all copies of the original message. Any unauthorized review, use, disclosure, dissemination, forwarding, printing or copying of this e-mail or any action taken in reliance on this e-mail is strictly prohibited and may be unlawful."
Richard Quadling | 5 May 10:52 2009

Re: DocBook's Definitive Guide XML.

2009/4/22 Thomas Schraitle <tom_schr <at> web.de>:
> Hi,
>
>> I assume that the DocBook Definitive Guide is available in DocBook format?
>>
>> If so, where can I download it from please?
>
> See http://www.docbook.org/tdg/
>
>
> Tom
>

Hi.

That's the nice HTML files. I'm looking for the XML sources, assuming
(ahem) that DocBook is capable of being used to describe DocBook.

--

-- 
-----
Richard Quadling
Zend Certified Engineer : http://zend.com/zce.php?c=ZEND002498&r=213474731
"Standing on the shoulders of some very clever giants!"
Dongsheng Song | 5 May 11:33 2009
Picon

Re: DocBook's Definitive Guide XML.

See:

https://docbook.svn.sourceforge.net/svnroot/docbook/trunk/defguide
https://docbook.svn.sourceforge.net/svnroot/docbook/trunk/defguide5

2009/4/22 Richard Quadling <rquadling <at> googlemail.com>:
> Hi.
>
> I assume that the DocBook Definitive Guide is available in DocBook format?
>
> If so, where can I download it from please?
>
Richard Quadling | 5 May 12:30 2009

Re: DocBook's Definitive Guide XML.

2009/5/5 Dongsheng Song <dongsheng.song <at> gmail.com>:
> See:
>
> https://docbook.svn.sourceforge.net/svnroot/docbook/trunk/defguide
> https://docbook.svn.sourceforge.net/svnroot/docbook/trunk/defguide5
>
> 2009/4/22 Richard Quadling <rquadling <at> googlemail.com>:
>> Hi.
>>
>> I assume that the DocBook Definitive Guide is available in DocBook format?
>>
>> If so, where can I download it from please?
>>
>

Thank you.

--

-- 
-----
Richard Quadling
Zend Certified Engineer : http://zend.com/zce.php?c=ZEND002498&r=213474731
"Standing on the shoulders of some very clever giants!"
Richard Quadling | 5 May 12:30 2009

Re: DocBook's Definitive Guide XML.

2009/5/5 ben.guillon <ben.guillon <at> gmail.com>:
> On Tue, 05 May 2009 10:52:49 +0200, Richard Quadling
> <rquadling <at> googlemail.com> wrote:
>
>> Hi.
>>
>> That's the nice HTML files. I'm looking for the XML sources, assuming
>> (ahem) that DocBook is capable of being used to describe DocBook.
>>
>>
>
> You can browse the sources here for DocBook 4.X :
> http://docbook.svn.sourceforge.net/viewvc/docbook/trunk/defguide/
>
> Or here for DocBook NG :
> http://docbook.svn.sourceforge.net/viewvc/docbook/trunk/defguide5/
>
> You can either download tarballs from the SVN web GUI, or grab it directly
> from SVN (see http://sourceforge.net/scm/?type=svn&group_id=21935).
>
> Regards,
> BG
>

Thank you.

--

-- 
-----
Richard Quadling
Zend Certified Engineer : http://zend.com/zce.php?c=ZEND002498&r=213474731
"Standing on the shoulders of some very clever giants!"
Tobias Anstett [k15t.com] | 5 May 18:32 2009

Re: Best wiki engines or tools for wiki-to-docbook conversions?

Hi Jim,

Atlassian is offering free licenses of their Enterprise Wiki
'Confluence' for Open Source projects. It is the best wiki I know !
E.g. some projects of Apache are using Confluence too. In combination
with a free 'open source license' of Scroll Wiki Exporter
(http://www.scrollyourwiki.com) you can export to DocBook as well as
PDF. To get more information just visit the home page or contact me
directly.

Cheers,
Tobias

On Thu, Apr 30, 2009 at 6:11 PM, Jim Campbell <jwcampbell <at> ubuntu.com> wrote:
> Hi All,
>
> I contribute to a Free Software project called Xfce (http://www.xfce.org).
> Xfce is a lightweight graphical desktop environment for Linux and BSD-based
> PC's. While the project itself is moving along fine, the project's end-user
> documentation is currently a bit out of date, and I've been talking with one
> of the developers about getting it updated.
>
> The project's current documentation is written in docbook, but as part of
> this effort, we want to make it easier for new contributors to write
> documentation without overwhelming them with the details of docbook. The
> approach we have in mind right now would be to have contributors use a wiki
> to compose the docs, and then output the content to docbook.  We have tools
> that allow translators to translate the docbook strings, and the original
> and translated docbook strings can then be output to html.
>
> With that in mind, in your experience, what open-source wiki engines (if
> any) provide the best output to docbook? If you can't think of any, what
> tools may provide the best means of converting wiki text to docbook?  The
> team currently uses dokuwiki as their wiki engine, but they are not tied to
> this.  Also, if you can think of an alternate workflow that may work better,
> please feel free to suggest that, too.
>
> Thanks very much for your consideration,
>
> Jim
>
Richard JOHNSON | 5 May 23:39 2009

Re: Best wiki engines or tools for wiki-to-docbook conversions?

On Thu, Apr 30, 2009 at 11:11:10AM -0500, Jim Campbell wrote:
[...]
> With that in mind, in your experience, what open-source wiki engines (if
> any) provide the best output to docbook? If you can't think of any, what
> tools may provide the best means of converting wiki text to docbook?  The
> team currently uses dokuwiki as their wiki engine, but they are not tied to
> this.  Also, if you can think of an alternate workflow that may work better,
> please feel free to suggest that, too.

As for wiki tools, I have tried them all, even tried it out today and I
will say that even with Tidy it still isn't pretty. It would be great for
the person doing the writing to Wiki but a hell of a lot more difficult for
the person who has to do the converting. For 4 years now we have watched
super slow progress on Wiki->DocBook on various Wiki systems, and if I
remember correctly, both Matthew and I helped with one of the first
versions with a Google Summer of Code student.

Honestly, you want to make it easy for people to contribute without having
to learn DocBook, rST is it, and you saw the presentation put on by the
Python people this past weekend. As long as you don't hear "well don't
subject your possible contributors to any kind of markup." If you hear
that, then just accept plain text or even ODF files and manually convert
later. rST has super easy markup, if that is what you want to call it, and
converting it to DocBook or any other format is pretty good.

-- 
 Name|  Richard JOHNSON
Title|  Developer
  WWW|  http://www.ubuntu.com
Email|  nixternal <at> ubuntu.com
GnuPG|  9554 2BCC 3AA2 3898 0939  56E7 3EC9 A39D 2E2C 0124
On Thu, Apr 30, 2009 at 11:11:10AM -0500, Jim Campbell wrote:
[...]
> With that in mind, in your experience, what open-source wiki engines (if
> any) provide the best output to docbook? If you can't think of any, what
> tools may provide the best means of converting wiki text to docbook?  The
> team currently uses dokuwiki as their wiki engine, but they are not tied to
> this.  Also, if you can think of an alternate workflow that may work better,
> please feel free to suggest that, too.

As for wiki tools, I have tried them all, even tried it out today and I
will say that even with Tidy it still isn't pretty. It would be great for
the person doing the writing to Wiki but a hell of a lot more difficult for
the person who has to do the converting. For 4 years now we have watched
super slow progress on Wiki->DocBook on various Wiki systems, and if I
remember correctly, both Matthew and I helped with one of the first
versions with a Google Summer of Code student.

Honestly, you want to make it easy for people to contribute without having
to learn DocBook, rST is it, and you saw the presentation put on by the
Python people this past weekend. As long as you don't hear "well don't
subject your possible contributors to any kind of markup." If you hear
that, then just accept plain text or even ODF files and manually convert
later. rST has super easy markup, if that is what you want to call it, and
converting it to DocBook or any other format is pretty good.

--

-- 
 Name|  Richard JOHNSON
Title|  Developer
  WWW|  http://www.ubuntu.com
Email|  nixternal <at> ubuntu.com
GnuPG|  9554 2BCC 3AA2 3898 0939  56E7 3EC9 A39D 2E2C 0124
Dougie Richardson | 6 May 01:23 2009

Re: Best wiki engines or tools for wiki-to-docbook conversions?

Hi Richard,

2009/5/5 Richard JOHNSON <nixternal <at> ubuntu.com>:
> Honestly, you want to make it easy for people to contribute without having
> to learn DocBook, rST is it, and you saw the presentation put on by the
> Python people this past weekend. As long as you don't hear "well don't
> subject your possible contributors to any kind of markup." If you hear
> that, then just accept plain text or even ODF files and manually convert
> later. rST has super easy markup, if that is what you want to call it, and
> converting it to DocBook or any other format is pretty good.

I'm increasingly of the mind set that expanding the number of people
working with DocBook and encouraging plain text submission is the
easiest route to simplifying contribution.

Regards,

Dougie Richardson
http://www.lynxworks.eu/
dougierichardson <at> ubuntu.com

Doug | 6 May 01:41 2009
Picon

Re: Best wiki engines or tools for wiki-to-docbook conversions?

On Fri, 1 May 2009, Jim Campbell wrote:
> Hi All,
[snip]

> With that in mind, in your experience, what open-source wiki engines (if
> any) provide the best output to docbook? If you can't think of any, what
> tools may provide the best means of converting wiki text to docbook?  The
> team currently uses dokuwiki as their wiki engine, but they are not tied to
> this.  Also, if you can think of an alternate workflow that may work
> better, please feel free to suggest that, too.

You might be interested in DocBookWiki. IIUC, content is entered
online as DocBook, so no conversion is necessary.

http://doc-book.sourceforge.net/homepage/

Sorry, I don't have any experience with it.

Cheers
Doug

Gmane