[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: D-I Manual on official Debian website [long]



Hello Frank,

On Tuesday 28 December 2004 17:57, Frank Lichtenheld wrote:
> On the directory structure I have researched how difficult it would
> be to adjust the filenames and links. Turns out it is not difficult at
> all. Proof-of-concept patch against the sarge branch:

Working from your patches I think I have created a workable solution.
It consists of an extra stylesheet that takes care of your filenaming 
wishes and a new wrapper script for buildone.sh specifically for the 
website (both attached for review).

This solution needs only a minor change in buildone.sh:
-stylesheet_html="$stylesheet_dir/style-html.xsl"
+if [ ! "$web_build" ]; then
+    stylesheet_html="$stylesheet_dir/style-html.xsl"
+else
+    stylesheet_html="$stylesheet_dir/style-html-web.xsl"
+fi

The advantage of this solution is that it leaves the builds for the 
debian-installer-manual package and for the CD's unaffected.
As content negociation only works if the files are served from a webserver 
that supports it, I see no benefits in changing the filenames there.
(As they will mostly be opened from a file browser.)

I have built a testset using the new wrapper script for a limited set of 
arches and langs, available at [1].
Please let me know if this meets with your requirements.


Looking at [2] I think that, for content negotiation, naming the files 
"<name>.<format>.<lang>" is preferable over "<name>.<lang>.<format>".
With a few minor changes in the attached files this could be supported.
In style-html-web.xsl:
  -<xsl:param name="html.ext" select="concat('.',/book/@lang,'.html')"/>
  +<xsl:param name="html.ext" select="concat('.html.',/book/@lang)"/>
And in buildweb.sh:
  -    mv ./build.out/install.$lang.$format "$destination/$destsuffix"
  +    mv ./build.out/install.$lang.$format \
  +       "$destination/$destsuffix/install.$format.$lang"

What do you think?

[1] http://home.tiscali.nl/isildur/d-i/manual_web.tar.gz
[2] http://httpd.apache.org/docs-2.0/content-negotiation.html.en#naming

Cheers,
FJP

Attachment: buildweb.sh
Description: application/shellscript

Attachment: pgpmG7FaHSV9x.pgp
Description: PGP signature


Reply to: