Subject: htdocs layout [was Re: CVS commit: htdocs]
To: None <heinz@NetBSD.org>
From: Mike M. Volokhov <mishka@apk.od.ua>
List: netbsd-docs
Date: 04/04/2005 12:24:58
On Sat,  2 Apr 2005 12:38:37 +0000 (UTC)
Klaus Heinz <heinz@NetBSD.org> wrote:

> 
> Module Name:	htdocs
> Committed By:	heinz
> Date:		Sat Apr  2 12:38:37 UTC 2005
> 
[snip]
> Log Message:
> At long last: removed alles files below se/ and moved them to sv/ as
> discussed on the www list. "se" is the country code for Sweden, while
> "sv" is the correct language code for Swedish.

Hello,

What about movement the whole English site to it's own subdirectory -
htdocs/en? As I have posted few month ago (but haven't got reply yet),
the new layout may looks like follows:

	share/mk	- [already] shared XML and makefiles.
	share/xsl	- [already] XSLT things.
	share/xml	- [already] XML things.
	share/tools	- various tools, such as translate.sh, list2html, etc.
	images		- the pictures.
	images/guide	- pictures to the NetBSD guide.
	en		- English site.
	en/guide	- English guide.
	de		- German site.
	de/guide	- German guide.
	<lang>		- and so on, other language dependend sites.
	index.html	- the file. Would contain the copy of en/index.html,
			  but with modified links (relative to htdocs/en/..).
			  Or may contain links to various languages. Or even
			  may contain plain redirect directive.

Then, all makefiles should include link to share/mk/web.site.<lang>.mk
(which will include share/mk/web.site.mk) only and it would "did a
magic". IMHO, this will look much cleaner and easy to understand.

Also, just all Makefile.inc files (except toplevel files for languages,
i.e. htdocs/Makefile.inc, de/Makefile.inc, etc.) contains similar to the
following, but nothing else:

	WEB_PREFIX?=	${.CURDIR}/../..

And the primary Makefile for each directory have:

	.include "Makefile.inc"

This looks bit silly. Why not set WEB_PREFIX just inside primary
Makefile, and use Makefile.inc only for directories, when it is really
needed?

Any opinion, please?

--
Mishka.