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