[Mono-docs-list] MonkeyGuide and Monodoc futures.

Miguel de Icaza miguel@novell.com
Mon, 04 Apr 2005 18:27:14 -0400


Hello,

> >     Am considering whether it would be a good idea to move the content
> > into the Mono Wiki, namespacing it with `Guide:' just to get organized,
> > and then implement a Monodoc provider for plain HTML pages and ship with
> > Monodoc the contents from the Wiki (extracted in some form, yet to be
> > determined).
> 
> Using XSLT for the Monkeyguide would be a really good idea.  It would 
> make it easy to format the contents for Monodoc and for the web.  A page 
> of Monkeyguide could look like:

Joshua, I know that you do not quite like the Wiki, but I am about to
give up on the Monkeyguide receiving anything remotely close to the
attention it deserves if it stays on SVN.

Those with access to SVN are the developers, and they are typically too
busy developing to maintain and use the docs.

Am wondering if you could assist us with the proper XSLT glue to
transform our current XHTML documentation into something that MediaWiki
would consume.

All that matters I believe is to turn:

<pre>
XXX
YYY
</pre>

into:

<space>XXX
<space>YYY

External links:

	<a href="http://...">abc</a>

Into:
	[http:// abc]

Internal links:

	<a href="blah">Dum</a>

	[[blah Dum]]

<p>...</p> just adds a newline between them.

The rest we can probably copy-edit manually once we have the pages up. 

Miguel.