[Mono-docs-list] XHtml provider, mono handbook provider

Lee Mallabone mono-docs@fonicmonkey.net
01 Jun 2003 16:21:37 +0100


On Wed, 2003-05-28 at 05:00, Miguel de Icaza wrote:
> Good job!  The code looks good, please commit to CVS.

I've now checked in the code. Sorry it took so long. Please feel free to
hack out bits that don't look so great. It works, but I'm not at all
happy with my URL handling, (see below).

> If you use "xhtml:" in the links you generate, you will need to be able
> to tell the various help sources appart, or as you noticed, the
> resolution will fail.
> 
> The trick I used in the old ecma-provider, was to use the
> HelpSource.SourceID, and the urls look like this:
> 
> 	source-id:N:ecma:....
> 
> Just prefix every one of your links with "source-id:NNN", and things
> will work as they should.  The trick is that you will need to do some
> XPath processing at runtime and replace the nodes.

I read this a few times, thought I'd got it figured, tweaked my code a
bit, reread this a few more times, utterly confused myself, and now I'm
not sure what The Right Thing to do is, in terms of correctly loading
from the right help source. Maybe it's really obvious, but I just don't
100% understand how the url lookup system maps to the help source
system?

> It looks fine.  We should integrate these into a makefile in the Mono
> tutorial tree, so I can run that before making a Monodoc release. 

I think the only thing stopping this is that the assembler never gets
installed anywhere? Because of that, it's tricky to write a generic
makefile... Maybe we should rename it monodoc-assembler and put a shell
wrapper script in the install path? I could write a patch for the
monkeyguide makefile trivially then...

> And now is a good time for me to go and review the other pending
> Monodoc patch to get the About box in place.

I also committed a tiny tweak to handle relative anchors; hope you don't
mind!

Regards,

Lee.