Date: Mon, 11 Nov 2002 10:22:07 -0800 From: "Bruce A. Mah" <bmah@FreeBSD.ORG> To: Udo Erdelhoff <ue@nathan.ruhr.de> Cc: freebsd-doc@FreeBSD.ORG Subject: Re: Putting translated release notes onto the web site Message-ID: <200211111822.gABIM79h003216@intruder.bmah.org> In-Reply-To: <20021110162524.GZ59222@nathan.ruhr.de> References: <20021110162524.GZ59222@nathan.ruhr.de>
next in thread | previous in thread | raw e-mail | index | archive | help
--==_Exmh_-1703392626P Content-Type: text/plain; charset=us-ascii If memory serves me right, Udo Erdelhoff wrote: > 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. That's pretty close. I usually use the image target from src/release/doc/share/examples/Makefile.relnotesng to get all of the html files in a directory; it munges all of the filenames so that we can have all of the architecture-dependent renditions in one directory. (This is also the thing that I use to maintain my snapshot page.) The SGML files you referred to are, for the most part, "glue" to hook together the different architecture-dependent files. The only change between versions is typically the version number. > 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/ I vaguely remember thinking that the en release documentation was already implicitly "covered" by a LANGCODE prefix because it lived in the en_US part of the Web site. Thus we didn't need to add another LANGCODE prefix to the pathname. If that's true, then the de version of the release documentation would just live under http://www.freebsd.org/ de/relnotes/CURRENT (for example). > ...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. In the case of the Handbook and FAQ, there should be no symbolic links left, and I don't think there should be any redirects either (someone correct me if I'm wrong). Much effort was put into making sure that that hyperlinks from other files actually worked. > 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. As I read the webupdate script on the Web server, I think that all of src/release/doc is checked out and available, but it's been awhile since I've thought about this. > So, what would be a good way forward here? For everyone else here on doc, I asked Udo to post here because we were discussing it and I wasn't sure how to proceed. :-) Bruce. --==_Exmh_-1703392626P Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.0 (FreeBSD) Comment: Exmh version 2.5+ 20020506 iD8DBQE9z/VP2MoxcVugUsMRAhTFAJ0XLIf0uImvXlQ36o/P5fqdWIBeQgCcDjEg sGxX6TI0xSn0ZVtwtTzEL6w= =kEFC -----END PGP SIGNATURE----- --==_Exmh_-1703392626P-- 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?200211111822.gABIM79h003216>