Nathan Sharfi wrote: >I thought the existing nant documentation was lacking, and also wanted to >increase my xsl-fu. Hence, I'm converting the existing documentation to XML >and using XSL to get html files. as you can see, I don't use MS' msxsl >command-line util; I use one that's available from >http://www.fh-frankfurt.de/~igor/projects/libxml/ . In case you're horribly >lazy, you can get a pre-done collection of the thing at >www.cyclooctane.com/files/libxslt-in-a-box.zip . > >The documentation: >www.cyclooctane.com/files/nant-doc.zip >
Nathan, While this is good work I'm afraid its a little backward. You see the html documentation is already automatically generated from XML code comments using the ndoc tool and custom xslt. So what it looks like you've done is reverse engineer the generated html into xml and then transformed it again into html. I'm not sure why you've used libxml when the dotnet framework has a perfectly good xslt library built in. I don't mean to be overly critical but theres no way to easily use what you've done within our current framework. You should look into nant\src\NAnt.Documenter to see how we're currently building the docs. There a some gaps that we need to fill and any ideas/ suggestions/patches would be much appreciated. I wish you'd posted to the list before you did all this work. Ian > >Pending issues: > Generalizing conditional additions for stuff like if, unless, verbose, >timeout, and other common attributes. I don't want to do the manual labor >involved in adding commmon boilerplate, and I'd rather factor out as much >text as possible. I've assumed that every task does if, unless, and verbose, >but I'd like something like <attributeset alsoincludes='timeout quux bar'> >or something like that. > >Comments and constructive criticism welcome. > >P.S. I also give my e-mail out as [EMAIL PROTECTED], by the way. > > >_______________________________________________ >Nant-developers mailing list >[EMAIL PROTECTED] >https://lists.sourceforge.net/lists/listinfo/nant-developers > > _______________________________________________ Nant-developers mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/nant-developers
