Re: Small patch for www.gnome.org docbook building

[Peter Williams <peter newton cx>]

I'm not sure what patch you're referring to, but it looks like you need
a newer gnome-doc-utils. Looks like the pkg-config call is returning an
empty string, which it does for variables it doesn't recognize.

The problem with the press release is that all the article text is
inside the <abstract> element. The stylesheets handle it although it is
invalid DocBook (big ups to nXML mode in Emacs). If you look at the HTML
source to the pages on the website, you'll see that all the text is
there, but it's embedded in a <meta name="description"> tag. 

Anyway, the attached patch should fix the issue, I hope. I'm not sure if
it's the best solution but it looks OK on my computer.

Peter

On Tue, 2005-12-06 at 17:01 +0100, Murray Cumming wrote:
> On my computer (Ubuntu Dapper) this seems to break the build:
> xsltproc -o tour-C.omf --stringparam db2omf.basename tour --stringparam
> db2omf.format 'docbook' --stringparam db2omf.dtd "-//OASIS//DTD DocBook
> XML V4.1.2//EN" --stringparam db2omf.lang C --stringparam db2omf.omf_dir
> "" --stringparam db2omf.help_dir "" --stringparam db2omf.omf_in
> "`pwd`/./tour.omf.in" `pkg-config --variable db2omf gnome-doc-utils`
> C/tour.xml
> compilation error: file C/tour.xml line 14 element article
> xsltParseStylesheetProcess : document is not a stylesheet
> make[5]: *** [tour-C.omf] Error 5
> 
> It doesn't seem to be breaking the build on the server though.
> 
> 
> I wanted to investigate why the 2.12 press release translations are now
> blank:
> http://www.gnome.org/start/2.12/press_release/C/
> 
> (They have been for at least a month.)
> 
-- 
Peter Williams / peter newton cx

? www.gnome.org/start/2.12/press_release/TEST
? www.gnome.org/start/2.12/press_release/docbook/bg/bg
? www.gnome.org/start/2.12/press_release/docbook/ca/ca
? www.gnome.org/start/2.12/press_release/docbook/cy/cy
? www.gnome.org/start/2.12/press_release/docbook/de/de
? www.gnome.org/start/2.12/press_release/docbook/el/el
? www.gnome.org/start/2.12/press_release/docbook/es/es
? www.gnome.org/start/2.12/press_release/docbook/fr/fr
? www.gnome.org/start/2.12/press_release/docbook/id/id
? www.gnome.org/start/2.12/press_release/docbook/it/it
? www.gnome.org/start/2.12/press_release/docbook/mk/mk
? www.gnome.org/start/2.12/press_release/docbook/nl/nl
? www.gnome.org/start/2.12/press_release/docbook/pa/pa
? www.gnome.org/start/2.12/press_release/docbook/pt_BR/pt_BR
? www.gnome.org/start/2.12/press_release/docbook/ru/ru
? www.gnome.org/start/2.12/press_release/docbook/th/th
? www.gnome.org/start/2.12/press_release/docbook/uk/uk
? www.gnome.org/start/2.12/press_release/docbook/vi/vi
Index: www.gnome.org/start/2.12/press_release/Makefile.am
===================================================================
RCS file: /cvs/gnome/gnomeweb-wml/www.gnome.org/start/2.12/press_release/Makefile.am,v
retrieving revision 1.2
diff -u -r1.2 Makefile.am
--- www.gnome.org/start/2.12/press_release/Makefile.am	30 Sep 2005 04:58:59 -0000	1.2
+++ www.gnome.org/start/2.12/press_release/Makefile.am	6 Dec 2005 20:19:26 -0000
@@ -25,16 +25,16 @@
 #And this would be easier if I could define some variables inside the @for loop.
 #Murray Cumming
 html:
-	@for docbookdir in $(DOC_LINGUAS_PLUS_ORIGINAL); do \
+	for docbookdir in $(DOC_LINGUAS_PLUS_ORIGINAL); do \
 	  echo "Generating html for language: " $$docbookdir; \
 	  rm -rf $$docbookdir; \
 	  mkdir $$docbookdir; \
 	  echo "Running xlstproc on: " docbook/$$docbookdir/$(ROOTDOC); \
-	  xsltproc --xinclude -o $$docbookdir/index.html \
+	  xsltproc --xinclude -o $$docbookdir/unused.html.ignore \
 	    --param yelp_max_chunk_depth 1 \
- 	    --stringparam admon.graphics.path ./images/ \
+	    --stringparam admon.graphics.path ./images/ \
 	    --stringparam http_root http://www.gnome.org \
-	    --stringparam http_prefix /start/2.12/notes \
+	    --stringparam http_prefix /start/2.12/press_release \
 	    $(STYLE_PATH)db2html.xsl docbook/$$docbookdir/$(ROOTDOC); \
 	  echo "  xlstproc finished"; \
 	  for i in $$docbookdir/*.html; do \
Index: www.gnome.org/start/2.12/press_release/docbook/C/press_release.xml
===================================================================
RCS file: /cvs/gnome/gnomeweb-wml/www.gnome.org/start/2.12/press_release/docbook/C/press_release.xml,v
retrieving revision 1.15
diff -u -r1.15 press_release.xml
--- www.gnome.org/start/2.12/press_release/docbook/C/press_release.xml	1 Sep 2005 06:36:23 -0000	1.15
+++ www.gnome.org/start/2.12/press_release/docbook/C/press_release.xml	6 Dec 2005 20:19:26 -0000
@@ -11,15 +11,19 @@
 <!-- the "xinclude" and "postvalid" command line options to xmllint             -->
 <!-- and the "xinclude" option to xsltproc                                      -->
 
-<article id="index" lang="en" xmlns:xi="http://www.w3.org/2001/XInclude";>
+<article id="toplevel" lang="en" xmlns:xi="http://www.w3.org/2001/XInclude";>
   <articleinfo>
     <title>GNOME &version; Press Release</title>
 
     <abstract>
-
       <title>GNOME &version; DESKTOP AND DEVELOPER PLATFORM RELEASED</title>
+      <para>New version of the popular free-software desktop environment offers convenience and capability.</para>
+    </abstract>
+  </articleinfo>
+
+<sect1 id="index">
 
-<sect1>
+<title>GNOME &version; DESKTOP AND DEVELOPER PLATFORM RELEASED</title>
 
 <para><emphasis>New version of the popular free-software desktop environment offers convenience and capability.</emphasis></para>
 
@@ -71,8 +75,5 @@
 </sect2>
 
 </sect1>
-
-    </abstract>
-  </articleinfo>
 
 </article>