Subject: The htdocs layout proposal
To: None <netbsd-docs@netbsd.org>
From: Mike M. Volokhov <mishka@apk.od.ua>
List: netbsd-docs
Date: 11/30/2004 12:14:48
Greetings!
At this moment files in htdocs stored as follows:
- the htdocs contains an English site.
- other languages are stored in relevant directories.
IMHO this makes more troubles rather advantages. A few of:
- we should use some dirty hacks to build language dependent files.
- many tools and other extra files are mixed with site content.
- build process seems not clean and too complex.
- non English sites built without own layout.
For example, many sites use "en" as build language, which is incorrect:
mishka@nostromo:176> pwd
/usr/home/mishka/prj/runetbsd/htdocs/ru/Releases/formal-2.0
mishka@nostromo:177> make -n -d v | grep LANG
Global:LANG = en
Global:XSLFILE = ${WEB_PREFIX}/share/xsl/netbsd-webpage-${LANG}.xsl
mishka@nostromo:205> pwd
/usr/home/mishka/prj/runetbsd/htdocs/de/Releases/formal-2.0
mishka@nostromo:206> make -n -d v | grep LANG
Global:LANG = en
Global:XSLFILE = ${WEB_PREFIX}/share/xsl/netbsd-webpage-${LANG}.xsl
My proposal is create a more clean directory hierarchy. Thus, the very
top level would contains:
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.
en - English site.
de - German site.
jp - Japanese site.
<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.
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". This looks just like the NetBSD source tree.
Any comments please?
--
Mishka.
P.S. Moreover, at this period we may reorganize the site content too.