[emacs-wiki-discuss] Re: First pass RNC Schema for muse-xml.el

[Michael Olson]

Brad Collins <address@hidden> writes:

> Attatched is a first pass at writing a schema for muse-xml.
>
> I used the Compact syntax of RelaxNG.  RNC has a lot of advantages
> over other schemas.  It's far easier to read and write than the XML
> syntax and it can easily be converted to DTD or XML Schema.

I've included this with Muse.  Thanks very much!  Sorry about the
delayed response.

> A few suggestions:
>
>   - The verse element should have a child element for each line.
>
>         <verse>
>           <line>line of crud</line>
>           <line>line of crud</line>
>         </verse>

OK, done.  I've also implemented the use of "<line />" for a blank
line (separating stanzas).

>   - The root element page should be upper case PAGE, or changed to
>     something like MUSE, this is a common convention for the root
>     element in a markup language.

Will do -- I'll use "MUSE" for muse-xml and "PLANNER" for planner-xml.

>   - do tables need to wrap each <tr> in a <tbody>?
>
>     <table>
>       <tbody><tr><td>stuff</td></td></tbody>
>       <tbody><tr><td>stuff</td></td></tbody>
>       <tbody><tr><td>stuff</td></td></tbody>
>     </table>
>
>    I have written the schema to describe the above, but wouldn't it
>    be better like this:
>
>     <table>
>       <tr><td>stuff</td></td>
>       <tr><td>stuff</td></td>
>       <tr><td>stuff</td></td>
>     </table>

The former case was a bug.  Tables should be the latter format.  This
should be fixed now.

> I'll be happy to maintain the the muse schema/s on a regular basis.
> They will have to be updated every time the muse-xml is tweaked.

Excellent!  I'm glad to hear that :^) .

> Please have a look and play around with the schema and let me know
> what you want added or changed.
>
> Personally, I will use muse-xml via xml.el or xml-parse.el (which I
> prefer) to convert the file into a list which is easily manipulated
> in elisp.  I've never been much of a fan of XSLT (also from James
> Clarke).

Can people who are interested in XML publishing please try muse-xml +
muse.rnc and let us know if anything might need to be tweaked?

For that matter, can someone give a simple series of commands (or
usage scenario) so that I can document this effectively?

-- 
Michael Olson -- FSF Associate Member #652 -- http://www.mwolson.org/
Interests: anime, Debian, XHTML, wiki, Emacs Lisp
  /` |\ | | | IRC: mwolson on freenode.net: #hcoop, #muse, #pulug
 |_] | \| |_| Jabber: mwolson_at_hcoop.net

pgpCpIbfl7UZw.pgp
Description: PGP signature