On Dec 8, 2007, at 9:41 AM, Simon Ruderich wrote:
On Fri, Dec 07, 2007 at 10:12:16PM -0400, Juan Manuel Palacios wrote:
Hey guys!
I'm happy to announce that I'm now working with Bill to setup our guide on the Mac OS Forge servers as http://guide.macports.org. In doing that I'm also testing it's automated regen, so that we can trigger it as a post-commit hook against the trunk/doc-new sources.
We're experiencing some errors and warnings, however:
[snip]
Anyone care to comment on them?
Regards,...
-jmpp
Hi Juan,
most of these problems are going to be fixed soon, when we have integrated the data from the old man pages.
Good to hear!
But I'm not sure how to fix one, it is caused by the xsl file and I don't know very much about xsl code:
WARNING: cannot add @xml:base to node set root element. Relative paths may not work.
I don't know any xsl code either, unfortunately! Can't help you there :-(
So for now these errors can be ignored and cause no problems for our new guide.
I have to be honest that I hadn't tried generating the guide locally, so I thought the errors were fatal. But it turns out they aren't so I predict we'll have the guide up on the official web server really soon now! One thing I'd like to ask, though... how about this little patch: Index: Makefile =================================================================== --- Makefile (revision 31776) +++ Makefile (working copy) @@ -45,7 +45,7 @@ mkdir -p $(GUIDE-RESULT) cp $(GUIDE)/resources/$(STYLESHEET) $(GUIDE-RESULT)/$(STYLESHEET) cp $(GUIDE)/resources/images/* $(GUIDE-RESULT)/ - xsltproc --xinclude $(STRINGPARAMS) --output $(GUIDE-RESULT)/ guide.html \ + xsltproc --xinclude $(STRINGPARAMS) --output $(GUIDE-RESULT)/ index.html \ $(GUIDE-XSL) $(GUIDE-SRC)/guide.xml man: Renaming the generated file from "guide.html" to "index.html" will allow us to load a standard guide.macports.org URL and have the guide spring up right there without having to request an explicit file (guide.macports.org/guide.html). Seems better to me like that.
Thanks, Simon
Regards,... -jmpp