Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 10 Nov 2002 17:25:24 +0100
From:      Udo Erdelhoff <ue@nathan.ruhr.de>
To:        freebsd-doc@freebsd.org
Subject:   Putting translated release notes onto the web site
Message-ID:  <20021110162524.GZ59222@nathan.ruhr.de>

next in thread | raw e-mail | index | archive | help
Hi,
I am currently trying to make the German translation of the release
notes available on the FreeBSD web site.  I hope/believe that it
will not be a big problem to do this static release notes: check
out the correct version of the sources, run make, copy the html
files into www/de/relnotes/releases/<whatever>R, translate the few
.sgml files in that directory, connect it to the build, test,
commit, done.

Ok, the de part of the website is "a little" out of date and the
web build is not DOC_PREFIX clean, but that is a topic for another
time.

The part that could get *REALLY* messy is the up-to-date version
of the release notes.  As far as I can see, this version of the
release notes is only available in english.  And to make matter
worse, the active version of these release notes (i.e. the one
pointed to be all the links) is installed without a LANGCODE prefix.
If you look around on the website, you can find a LANGCODE version
of them (http://www.freebsd.org/relnotes/CURRENT/en_US.ISO8859-1)
but that directory only contains some subdirs and has been stale
since April.

What would be a good way forward here?  Obviously, I would prefer
to go for a solution that uses LANGCODE for all versions (including
en_US).  If I remember correctly, this is the set-up we currently
use for the FAQ - the official location of this document is
http://www.freebsd.org/doc/en_US.ISO8859-1/books/faq/

...and there is a maze of symbolic links and Apache redirects to make
make all the old locations work as well.  I want to avoid something
like this for the release notes.

Additionally, it may be neccessary to make some small changes on
www.  If I read www/en/relnotes/Makefile correctly, only the US
version has been checked out on www in /usr/relnotes/doc
and /usr/relnotes4/doc, this would have to be changed to support
the translations.

So, what would be a good way forward here?

/s/Udo
-- 
People who claim Windows is superior to Unix are the same people who'd
argue that you better use your hand instead of toilet paper to wipe your
ass. I can hear them now - 'It's colourful and it's intuitive and easy
to use and even a child could do it.'.

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20021110162524.GZ59222>