Guide regen job
Juan Manuel Palacios
jmpp at macports.org
Sat Dec 8 18:46:49 PST 2007
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
More information about the macports-dev
mailing list