Re: Wiki Markup for ECMA documents.

Atsushi Eno <[email protected]>
Newsgroups gmane.comp.gnome.mono.documentation
Message-ID <[email protected]>
Hola!

>> Am not sure what kind of transformations are actually wanted, so
>> am putting as its initial draft. The output is like:
>> http://monkey.workarea.jp/trans/mono/index.php/TestMonodocToMediaWiki
> I think the idea (at least what I thought it was) was to transform not
> the entire XML docs but what goes inside every section the user can
> edit (say summary, remarks, ...). So, the XSLT should transform the
> "example", "list", "table", .... tags (the buttons that you can find
> in the monodoc tool when you hit the Edit link) into something more
> Wiki-like. And the other way around.

Yup, I agree with you. In fact, my stylesheet is designed to accept
"summary" and "remarks" as the document element (as well as other
elements, so that I can test the stylesheet itself) :-)

Actually, I've noticed that editing the entire document would also
be easy when we have to copy and paste the contents on things like
a couple of overloads. I mostly use text editor to write docs because
of this reason; writing raw XML is not so painful *for me* as
compared to editing content on monodoc, because browser.exe anyways
wants me to write raw <see>/<seealso> markups.

>> (I also think that some kind of editor UI which is well-tailored for
>> monodoc would be better.)
> What are you exactly thinking (there is already the monodoc tool UI
> for editing).

Well, I thought that the original idea is to receive more
contributions *via the web* (MediaWiki). Thus, what I've thought was,
kind of web forms (either simple HTML + submission form, or kind of
web applications).

If it is just a matter of input syntax, no further thought is needed ;-)

Atsushi Eno
_______________________________________________
Mono-docs-list maillist  -  [email protected]
http://lists.ximian.com/mailman/listinfo/mono-docs-list
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.