On 18 February 2011 21:15, Shlomi Fish <[email protected]> wrote:
> Hi Mr. Rackham,
>
> thanks for your response. See below for mine.
>
> On Thursday 17 Feb 2011 22:12:58 Stuart Rackham wrote:
>> On 17/02/11 21:30, Shlomi Fish wrote:
>> > Hi all,
>> >
>> > I've been enjoying using AsciiDoc for the user-documentation of Freecell
>> > Solver ( http://fc-solve.berlios.de/ ). I've picked up AsciiDoc so I can
>> > convert the fc-sovle documentation with relative ease to DocBook/XML
>> > (which is a relatively rare feature among all lightweight markup
>> > languages), and it worked nicely. Its AsciiDocs are in English, though
>> > now a contributor has begun translating them to Dutch.
>> >
>> > In any case, I've written or started to write some
>> > stories/novellas/novels and some screenplays in these dedicated
>> > lightweight markup languages which I've implemented that convert them to
>> > a custom XML format and from it to DocBook and/or XHTML:
>> >
>> > * http://freshmeat.net/projects/xml-grammar-fiction
>> >
>> > (A known issue with the screenplays is that their output format is a
>> > popular one among some Internet screenplays I've seen an not the one
>> > enforced by Holywood and other film studios.)
>> >
>> > I've been thinking of using AsciiDoc at least instead of the -Fiction
>> > part, but I see two possible issues:
>> >
>> > 1. Some of my stories are in Hebrew and I need good support for
>> > bidirectional scripts. The words "hebrew", "arabic", "direction",
>> > "bidi", "rtl", "ltr", etc. do not appear in the AsciiDoc documentation
>> > even once, so I don't know if it's possible there. If you believe it is,
>> > let me know. I suppose AsciiDoc supports Unicode and I can insert the
>> > special unicode bidirectional characters (e.g: LRM, RLM, POP, etc.).
>> > However, all of these should be mentioned somewhere in the
>> > documentation.
>>
>> There is no explicit bidirectional support in AsciiDoc.
>>
>
> I see. Would you accept a patch that will add one where appropriate
> (documentation, test code, production code and everything.)?
Hi Shiomi,
Just for my education, in a batch tool like Asciidoc, what do you mean
by "bidirectional support"? I think I can understand what bidi
support means on a graphical tool, but not here?
Cheers
Lex
>
>> > 2. I believe DocBook 5.x has better Bidi and Right-to-left languages
>> > support than DocBook 4.x, but AsciiDoc does not appear to support it.
>> > Will a patch that adds support for DocBook 5.x (or replaces the DocBook
>> > 4.x support with it - it's your call) will be accepted?
>>
>> In theory all that's necessary is to write a docbook50.conf backend
>> configuration file. Out of interest I made a start last year, I thought it
>> would be a trivial exercise but it quickly degenerated into a can of
>> worms: you need a DocBook 5 specific toolchain to process it and the
>> semantically tighter DocBook 5 makes markup generation difficult. DocBook
>> 5 brings nothing new to AsciiDoc so I put it aside.
>>
>
> Ah. Well, there's a DocBook 4->DocBook 5 XSLT stylesheet I think. I personally
> prefer DB5 over DB4 because many things are more consistent there (e.g: xlink
> based href's) and it also has some features that I miss in it.
>
>> Here are my (very rough and unchecked) notes and I've attached my wholly
>> incomplete docbook50.conf file. If you do create working docbook50.conf
>> file we could look at including it in the distribution as an
>> ``experimental'' backend.
>
> Thanks! I might work on it. ("When a FOSS developer says he'll do something,
> he or she means 'maybe'." as I once said in
> http://www.shlomifish.org/humour/fortunes/osp_rules.html ).
>
> Regards,
>
> Shlomi Fish
>
>>
>> 8<--------
>> DocBook 5
>> ---------
>>
>> - See http://www.sagehill.net/docbookxsl/ProcesingDb5.htm
>> - Ubuntu DocBook 5 specific packages: docbook5-xml, docbook-xsl-ns
>> - See docbook50.conf, it's nowhere near finished.
>>
>> To validate use RelaxNG schema e.g.
>>
>> xmllint --noout --relaxng
>> /usr/share/xml/docbook/schema/rng/5.0/docbook.rng doc/article.xml
>>
>> NOTE: Don't use the --valid option as this causes xmllint to look for
>> an external DTD and you will get a 'Validation failed: no DTD found'
>> error.
>>
>> DocBook 5 is not as relaxed as DocBook 4 e.g.
>>
>> - 'abstract' must occur inside 'info', cannot appear like section.
>> - Admonitions can't occur in 'article' element.
>> - Doesn't like preamble to proceed first section.
>> 8<--------
>>
>>
>> Cheers, Stuart
>>
>> > ----------------
>> >
>> > That put aside, I've been playing with the idea of adding more "artsy"
>> > tags to DocBook/5.x to allow for writing fiction and stories with ease
>> > using it. I've already written the novella
>> > http://www.shlomifish.org/humour/human-hacking/ using DocBook/XML and
>> > also made the original DocBook available, but trying to use DocBook/XML
>> > for screenplays failed spectacularly. But it is not directly related to
>> > the point of my suggestions for the improvement of AsciiDoc.
>> >
>> > Regards,
>> >
>> > Shlomi Fish
>
> --
> -----------------------------------------------------------------
> Shlomi Fish http://www.shlomifish.org/
> Understand what Open Source is - http://shlom.in/oss-fs
>
> Chuck Norris can make the statement "This statement is false" a true one.
>
> Please reply to list if it's a mailing list post - http://shlom.in/reply .
>
> --
> You received this message because you are subscribed to the Google Groups
> "asciidoc" group.
> To post to this group, send email to [email protected].
> To unsubscribe from this group, send email to
> [email protected].
> For more options, visit this group at
> http://groups.google.com/group/asciidoc?hl=en.
>
>
--
You received this message because you are subscribed to the Google Groups
"asciidoc" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/asciidoc?hl=en.
