Re: www/ cleanup patch

----Security_Multipart(Mon_Jul_17_00_09_23_2006_307)--
Content-Type: Text/Plain; charset=iso-8859-1
Content-Transfer-Encoding: quoted-printable

G=E1bor K=F6vesd=E1n <[e-mail]> wrote
  in <[e-mail]>:

ga> Hiroki Sato wrote:
ga> >     To activate the side navigation bar, we need the following li=
ne
ga> >     only in the DOCTYPE declaration now:
ga> >
ga> >     <!ENTITY % include.nav.FOO "INCLUDE">
ga> >
ga> >     Actually FOO is replaced with "about", "community", "develope=
rs",
ga> >     and so on.
ga> >   =

ga> This is a great idea, but how this applies to translations? Do they=
 =

ga> still need a bunch of custom include files or can we add files like=
 =

ga> navibar.lang.ent to share/sgml?

 Simply putting the localized navibar.ent into
 www/<lang>/share/sgml/navibar.l10n.ent will do the trick.
 No change is needed for each *.sgml/*.xml file.

 Definitions in that file overrides the English ones; this means that
 entities both in www/<lang>/share/sgml/navibar.l10n.ent and in
 www/share/sgml/navibar.ent are always used but ones in the former are
 preferentially used when they exist on per-entity basis.

ga> For these tree sections, is there a good way to use the English xml=
 =

ga> files in translations? Since some translations have very limited hu=
man =

ga> resources, translated news is hard to keep up-to-date. The Hungaria=
n =

ga> translation will be such thing, since only I am working on that, an=
d we =

ga> don't even have a Hungarian committer. I looked at the French codeb=
ase, =

ga> they just take the English xml from the Makefile:
ga> =

ga> newsflash.html: newsflash.xsl news.xml\
ga>                         includes.xsl ${XML_INCLUDES}
ga>         ${XSLTPROC} ${XSLTPROCOPTS} -o ${.TARGET} \
ga>                 --param "news.project.xml-master" =

ga> "'${XML_NEWS_NEWS_MASTER}'" \
ga>                 --param "news.project.xml" "'${XML_NEWS_NEWS}'" \
ga>                 --param "transtable.xml" "'${XML_TRANSTABLE}'" \
ga>                 ${.CURDIR}/newsflash.xsl ${.CURDIR}/news.xml
ga> =

ga> Accordingly, the French webpages have to be rebuilt always when som=
ebody =

ga> commits some news to www/en to be up-to-date. Do you have any idea =
how =

ga> this can be done better?

 This Makefile does not mean the French webpages use the English versio=
n
 of news.xml.  The reason why the English news items are used is that
 changes for picking up partial translation were committed in 2004 (see=

 www/share/sgml/includes.misc.xsl rev.1.14 and other related changes).
 More specifically, if a translated entry exists in www/<lang>/news/new=
s.xml,
 it will be used.  If not, the English entry will be used.
 This selection will be done automatically and no need to have duplicat=
ed
 copy of the English entries in the localized news.xml.

 So what you have to do is putting a translated news.xml file into
 www/<lang>/news/news.xml.  Note that the translated news.xml
 needs to contain translated part only.  Items which are not
 translated yet will be inserted into newsflash.html and so on
 when the English version is updated (after rebuilding the localized
 tree, of course).

-- =

| Hiroki SATO




----Security_Multipart(Mon_Jul_17_00_09_23_2006_307)--
Content-Type: application/pgp-signature
Content-Transfer-Encoding: 7bit

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.2 (FreeBSD)

iD8DBQBEulajTyzT2CeTzy0RAlZgAJ9cju/tvrmn0GrxInGW1oNb4oeGMACfdalb
+LLiVftF6TY4+xdMZRtxqSo=
=4/yu
-----END PGP SIGNATURE-----

----Security_Multipart(Mon_Jul_17_00_09_23_2006_307)----