Re: Support of ITS tags in docbooks?

Hussein Shafie <[email protected]> Mon, 5 Dec 2022 10:19:12 +0100
Newsgroups gmane.editors.xxe.general
Message-ID <[email protected]>
On 12/4/22 15:50, Stéphane Aubry wrote:
> 
> I would like to include some ruby characters in my docbook.
> https://en.wikipedia.org/wiki/Ruby_character
> 
> The ITS (Internationalization Tag Set) makes it possible to include ruby characters in docbooks.
> 
> This page contains a sample docbook with some ruby characters:
> https://lists.oasis-open.org/archives/docbook-apps/201201/msg00042.html
> 
> I paste it here for your convenience:
> <book xmlns="http://docbook.org/ns/docbook" xmlns:its="http://www.w3.org/2005/11/its" version="5.0">
>   <title>...</title>
>   <chapter>
>    <title>...</title>
>    <para>この本は <its:ruby>
>      <its:rb>慶応義塾大学</its:rb>
>      <its:rp>(</its:rp>
>      <its:rt>けいおうぎじゅくだいがく</its:rt>
>      <its:rp>)</its:rp>
>     </its:ruby>の歴史を説明するものです。</para>
>   </chapter>
> </book>
> 
> When I open this docbook in XML Editor Personal Edition 10.2.0, I get this error:
>   element "ruby" from namespace "https:www.w3.org/2005/11/its" not allowed in this context
> 
> - Is there anything wrong in the sample file?

Nothing. Simply the DocBook schema used by XMLmind XML Editor does not 
include the ITS vocabulary.

See docbook-apps mailing list message about this topic here: 
https://lists.oasis-open.org/archives/docbook-apps/201201/msg00042.html



> - Could you send me a sample docbook file with ruby characters inside that works fine in XML Editor?
> 

There is no sufficient demand for this feature, therefore it's not 
implemented.

We currently support Ruby only as part of HTML5. See 
XXE_INSTALL_DIR/demo/xhtml/xhtml5-objects.html. See corresponding 
attached screenshot (with the "Emulate Web Browser" CSS stylesheet 
selected).

If authoring your structured document in DocBook is not absolutely 
mandatory, an alternative would be to use our HTML5-based (hence having 
Ruby support) ebooks. See tutorial "HTML5 as an alternative to DITA and 
DocBook", http://www.xmlmind.com/tutorials.html

(As a bonus, with ebooks, the deliverables, PDF, EPUB, DOCX, WebHelp, 
etc, look much better than what's created using the stock DocBook XSL 
stylesheets shipped with XMLmind XML Editor.)


--
XMLmind XML Editor Support List
[email protected]
http://www.xmlmind.com/mailman/listinfo/xmleditor-support
Ruby_view_in_HTML5.png (image/png, 187.4 KB) - not displayed