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.