> native, Lisp-programmable documentation generation system. A starting
> point might be my own Markup library:
>
> <http://www.gigamonkeys.com/lisp/markup/>
I like that :) But I was thinking that it would be better for the
future (including localisation, form/structure/content separation
etc) to include a few notions like:
1) structure:
-what is block level formating
-what is inline level formating
in a very generic form like what OD does:
<text:p> and <text:span> are the core of textual items there. The
rest is attributes like:
<text:p style:name="style1">
From there you can also implement style sheet which allows for
different output types (and css could be a very good option for your
markup I suppose)
To make that look like your markup I suppose you could have stuff like:
(Where \p is for paragraph and \i is for inline and :snb is for style
number)
\p{Some paragraph with no specific style info maybe defaulting to ":s0"
\i:s1{into which a ":s1" styled segment would appear}
then we go back to the \p default formating.}
\p:s2{Here we start with a formatted paragraph
\i:s0{with what could be a revert to default \p values}
and back to \p:s2 stuff.}
2) contents specification:
-what is localizable contents
see Internationalization Tag Set (ITS) at:
http://www.w3.org/TR/its/
I suppose a transfer of the ITS tags could look like that:
(With l: for localizable)
@l:s1 (a declaration that makes all :s1 sections localizable)
\p{Some paragraph with no specific style info maybe defaulting to ":s0"
\i:s1{into which a ":s1" styled segment would appear} (so here this
section would be localizable)
then we go back to the \p default formating.}
\p:s2:l{Here we start with a formatted paragraph (to affect only
the :s2 part)
\i:s0{with what could be a revert to default \p values}
and back to \p:s2 stuff.} (here also l: would be applied)
This kind of stuff could easily be exported to xliff with only
relevant l10nable contents.
This is vastly beyond what I suppose you had in mind and that may not
be relevant at all too...
Jean-Christophe Helary
_______________________________________________
Gardeners mailing list
[email protected]
http://www.lispniks.com/mailman/listinfo/gardeners
