IT's taken some time (I had a rather optimistic estimate of tmy free time)
but I'm finally making some headway with rewriting parts of the documentation. My current aim is to rewrite Gimplite Quickies. Problem is, I
still don't know how to build the html. I was told here on the mailing list
that Ubuntu has all the needed tools but I wasn't told what they are...
Validating is not a problem, I have XML validation tools, but editing XML
blindly can only go so far: I really need to see what I'm doing.

Can anyone help me with this?

BTW, I'm targeting 2.8, i.e., changing references from "save as" to "Export", etc.

This wiki entry may help you

http://gimp-wiki.who.ee/index.php/Hacking:Building/Linux#Building_the_Documentation

Owen

2011/3/23 Owen

This wiki entry may help you

http://gimp-wiki.who.ee/index.php/Hacking:Building/Linux#Building_the_Documentation

Owen

OK, wiki says to type this:

./autogen.sh --without-gimp ALL_LINGUAS="en"

Then look for errors on missing dependencies, install them, repeat until
autogen finishes successfully.

First of all I updated my local copy of GIT. I installed the following packages:
gettext
docbook
automake
docbook2odf
pngcrush
pngnq

And got autogen to announce I can now use make. I can either build html or PDF.
I managed to build a PDF, so that's good news, but when I try to build the
HTML I get this:

michael@michael-desktop:~/gimp-help-2$ LINGUAS=en make Making all in quickreference
make[1]: Entering directory `/home/michael/gimp-help-2/quickreference' make[1]: Nothing to be done for `all'. make[1]: Leaving directory `/home/michael/gimp-help-2/quickreference' make[1]: Entering directory `/home/michael/gimp-help-2' Cleaning up 'en' xml files ...
*** Making html for en ...
I/O error : Attempt to load network entity http://docbook.sourceforge.net/release/xsl/current/xhtml/chunk.xsl warning: failed to load external entity " http://docbook.sourceforge.net/release/xsl/current/xhtml/chunk.xsl" compilation error: file stylesheets/plainhtml.xsl line 10 element import
xsl:import : unable to load
http://docbook.sourceforge.net/release/xsl/current/xhtml/chunk.xsl make[1]: *** [html/en/index.html] Error 5 make[1]: Leaving directory `/home/michael/gimp-help-2' make: *** [all-recursive] Error 1

Any ideas? (I can reach the XSL using Firefox)

I can work with the PDF but I'd be happier if I could see the HTML result.

Could I suggest that you run autogen.sh again, and read the last 20 or so lines.

Just see what programs weren't found and install them.

Now if you have the style sheets on your computer, it shouldn't have to go to the net to get them. Install all the stylesheets you can find (I think you were using Ubuntu so just search synaptic for stylesheets )

I remember having problems getting this external link to work, maybe 5 or 6 years ago, and since then have used local copies

HTH

Owen

Michael Grosberg (Thursday, 24. March 2011) [...]

*** Making html for en ...
I/O error : Attempt to load network entity http://docbook.sourceforge.net/release/xsl/current/xhtml/chunk.xsl warning: failed to load external entity "

You have to install the DocBook stylesheets (package name probably "docbook-xsl" or "docbook-xsl-stylesheets"; source: http://sourceforge.net/projects/docbook/). Then you'll have a local copy of ".../xhtml/chunk.xsl" and xsltproc should use this version.

Bye, Ulf

Keiner schreibt, daß er nichts zu sagen hat;
doch die meisten, die schreiben, sagen nichts als das.
		-- Karlheinz Deschner

On Thu, 24 Mar 2011 13:54:08 +0200 Michael Grosberg wrote:

I am totally out of my depth here, but here are some ramblings

Now, some more questions:
1. There are two folders, both with XML files: XML and SRC. I understand XML is the one files are built from, and SRC is the one GIT uses to fetch files. But how do the two interact? do I copy files manually or is there some tool or script to update one or the other? In other words what is the work process here?

I am pretty sure this is all controlled by the Makefile. have a sqizz if you are happy reading that stuff

2. UI screenshots: Do you have a preference for the theme used in the screenshots? The wiki says screenshots should use the "default theme" but is it the Gnome's or Ubuntu's default theme I should be using? Gnome's default is Clearlooks, right?

I am pretty sure what is meant here is that the "Default" is that set out in the preferences under themes, .../share/gimp/2.0/themes/Default

3. I intend to replace the astronomy images used in the quickies with images more representative of something a normal user would use, everyday objects such as cars, animals, plants, tourist attractions and if I find the right subjects, people. These are good looking images I took myself, but I want to know if I need to do anything rights-wise, you know, do I need to explicitly release them under the GPL or CC or what have you, and if I do, how do I do it.

Too hard, Ulf or Roman may help here.

4. it's a long shot, but does anyone here use Notepad++ and has the correct HTMLtidy settings file to correctly reflow and indent docbook XML?

Don't know Notepad++, but there is a linux program "tidy" which does a fairly good job once you psyche it out.

Owen

Owen (Thursday, 24. March 2011)

On Thu, 24 Mar 2011 13:54:08 +0200 Michael Grosberg wrote:

[...]

1. There are two folders, both with XML files: XML and SRC. I understand XML is the one files are built from, and SRC is the one GIT uses to fetch files. But how do the two interact? do I copy files manually or is there some tool or script to update one or the other? In other words what is the work process here?

I am pretty sure this is all controlled by the Makefile. have a sqizz if you are happy reading that stuff

Yes, English is a special case (no po/pot files), the files are just copied when you type e.g.
'make html-en'
or
'make xml-en'.

2. UI screenshots: Do you have a preference for the theme used in the screenshots? The wiki says screenshots should use the "default theme" but is it the Gnome's or Ubuntu's default theme I should be using? Gnome's default is Clearlooks, right?

I am pretty sure what is meant here is that the "Default" is that set out in the preferences under themes, .../share/gimp/2.0/themes/Default

I think you are right. But IMO it's much more important which OS and (under Linux) which desktop manager is used. IMHO we should use distribution-independent (default) themes - e.g. Gnome's default theme rather than Ubuntu's.

3. I intend to replace the astronomy images used in the quickies with images more representative of something a normal user would use, everyday objects such as cars, animals, plants, tourist attractions and if I find the right subjects, people. These are good looking images I took myself, but I want to know if I need to do anything rights-wise, you know, do I need to explicitly release them under the GPL or CC or what have you, and if I do, how do I do it.

Too hard, Ulf or Roman may help here.

I wonder if we won't get a copyright problem if the images are replaced... And even if not, shouldn't we show respect for the original author?

Ulf

Daß Götter stets nur in Menschengestalt kommen,
hat noch keinen Gläubigen nachdenklich gemacht.
		-- Karlheinz Deschner