Guide regen job

[Juan Manuel Palacios]

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