/[gentoo]/xml/htdocs/proj/en/glep/glep-0010.html
Gentoo

Diff of /xml/htdocs/proj/en/glep/glep-0010.html

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.1 Revision 1.5
6PEP, see http://www.python.org/peps/pep-0001.html for instructions and links 6PEP, see http://www.python.org/peps/pep-0001.html for instructions and links
7to templates. DO NOT USE THIS HTML FILE AS YOUR TEMPLATE! 7to templates. DO NOT USE THIS HTML FILE AS YOUR TEMPLATE!
8--> 8-->
9<head> 9<head>
10 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 10 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
11 <meta name="generator" content="Docutils 0.3.0: http://docutils.sourceforge.net/" /> 11 <meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" />
12 <title>GLEP 10 -- Internationalization of www.gentoo.org</title> 12 <title>GLEP 10 -- Localized Gentoo Sites</title>
13 <link rel="stylesheet" href="tools/glep.css" type="text/css" /> 13 <style type="text/css">
14
15/*
16:Author: David Goodger
17:Contact: goodger@users.sourceforge.net
18:date: $Date: 2006/10/10 20:25:14 $
19:version: $Revision: 1.5 $
20:copyright: This stylesheet has been placed in the public domain.
21
22Default cascading style sheet for the PEP HTML output of Docutils.
23*/
24
25.first {
26 margin-top: 0 }
27
28.last {
29 margin-bottom: 0 }
30
31.navigation {
32 width: 100% ;
33 background: #cc99ff ;
34 margin-top: 0px ;
35 margin-bottom: 0px }
36
37.navigation .navicon {
38 width: 150px ;
39 height: 35px }
40
41.navigation .textlinks {
42 padding-left: 1em ;
43 text-align: left }
44
45.navigation td, .navigation th {
46 padding-left: 0em ;
47 padding-right: 0em ;
48 vertical-align: middle }
49
50.rfc2822 {
51 margin-top: 0.5em ;
52 margin-left: 0.5em ;
53 margin-right: 0.5em ;
54 margin-bottom: 0em }
55
56.rfc2822 td {
57 text-align: left }
58
59.rfc2822 th.field-name {
60 text-align: right ;
61 font-family: sans-serif ;
62 padding-right: 0.5em ;
63 font-weight: bold ;
64 margin-bottom: 0em }
65
66a.toc-backref {
67 text-decoration: none ;
68 color: black }
69
70body {
71 margin: 0px ;
72 margin-bottom: 1em ;
73 padding: 0px }
74
75dd {
76 margin-bottom: 0.5em }
77
78div.section {
79 margin-left: 1em ;
80 margin-right: 1em ;
81 margin-bottom: 1.5em }
82
83div.section div.section {
84 margin-left: 0em ;
85 margin-right: 0em ;
86 margin-top: 1.5em }
87
88div.abstract {
89 margin: 2em 5em }
90
91div.abstract p.topic-title {
92 font-weight: bold ;
93 text-align: center }
94
95div.attention, div.caution, div.danger, div.error, div.hint,
96div.important, div.note, div.tip, div.warning {
97 margin: 2em ;
98 border: medium outset ;
99 padding: 1em }
100
101div.attention p.admonition-title, div.caution p.admonition-title,
102div.danger p.admonition-title, div.error p.admonition-title,
103div.warning p.admonition-title {
104 color: red ;
105 font-weight: bold ;
106 font-family: sans-serif }
107
108div.hint p.admonition-title, div.important p.admonition-title,
109div.note p.admonition-title, div.tip p.admonition-title {
110 font-weight: bold ;
111 font-family: sans-serif }
112
113div.figure {
114 margin-left: 2em }
115
116div.footer, div.header {
117 font-size: smaller }
118
119div.footer {
120 margin-left: 1em ;
121 margin-right: 1em }
122
123div.system-messages {
124 margin: 5em }
125
126div.system-messages h1 {
127 color: red }
128
129div.system-message {
130 border: medium outset ;
131 padding: 1em }
132
133div.system-message p.system-message-title {
134 color: red ;
135 font-weight: bold }
136
137div.topic {
138 margin: 2em }
139
140h1 {
141 font-family: sans-serif ;
142 font-size: large }
143
144h2 {
145 font-family: sans-serif ;
146 font-size: medium }
147
148h3 {
149 font-family: sans-serif ;
150 font-size: small }
151
152h4 {
153 font-family: sans-serif ;
154 font-style: italic ;
155 font-size: small }
156
157h5 {
158 font-family: sans-serif;
159 font-size: x-small }
160
161h6 {
162 font-family: sans-serif;
163 font-style: italic ;
164 font-size: x-small }
165
166.section hr {
167 width: 75% }
168
169ol.simple, ul.simple {
170 margin-bottom: 1em }
171
172ol.arabic {
173 list-style: decimal }
174
175ol.loweralpha {
176 list-style: lower-alpha }
177
178ol.upperalpha {
179 list-style: upper-alpha }
180
181ol.lowerroman {
182 list-style: lower-roman }
183
184ol.upperroman {
185 list-style: upper-roman }
186
187p.caption {
188 font-style: italic }
189
190p.credits {
191 font-style: italic ;
192 font-size: smaller }
193
194p.label {
195 white-space: nowrap }
196
197p.topic-title {
198 font-family: sans-serif ;
199 font-weight: bold }
200
201pre.line-block {
202 font-family: serif ;
203 font-size: 100% }
204
205pre.literal-block, pre.doctest-block {
206 margin-left: 2em ;
207 margin-right: 2em ;
208 background-color: #eeeeee }
209
210span.classifier {
211 font-family: sans-serif ;
212 font-style: oblique }
213
214span.classifier-delimiter {
215 font-family: sans-serif ;
216 font-weight: bold }
217
218span.interpreted {
219 font-family: sans-serif }
220
221span.option-argument {
222 font-style: italic }
223
224span.pre {
225 white-space: pre }
226
227span.problematic {
228 color: red }
229
230table {
231 margin-top: 0.5em ;
232 margin-bottom: 0.5em }
233
234td, th {
235 padding-left: 0.5em ;
236 padding-right: 0.5em ;
237 vertical-align: top }
238
239td.num {
240 text-align: right }
241
242th.field-name {
243 font-weight: bold ;
244 text-align: left ;
245 white-space: nowrap }
246
247h1 tt, h2 tt, h3 tt, h4 tt, h5 tt, h6 tt {
248 font-size: 100% }
249
250tt {
251 background-color: #eeeeee }
252
253ul.auto-toc {
254 list-style-type: none }
255
256</style>
14</head> 257</head>
15<body bgcolor="white"> 258<body bgcolor="white">
16<table class="navigation" cellpadding="0" cellspacing="0" 259<table class="navigation" cellpadding="0" cellspacing="0"
17 width="100%" border="0"> 260 width="100%" border="0">
18<tr><td class="navicon" width="150" height="35"> 261<tr><td class="navicon" width="150" height="35">
19<a href="http://www.gentoo.org/" title="Gentoo Linux Home Page"> 262<a href="http://www.gentoo.org/" title="Gentoo Linux Home Page">
20<img src="http://www.gentoo.org/images/gentoo-new.gif" alt="[Gentoo]" 263<img src="http://www.gentoo.org/images/gentoo-new.gif" alt="[Gentoo]"
21 border="0" width="150" height="35" /></a></td> 264 border="0" width="150" height="35" /></a></td>
22<td class="textlinks" align="left"> 265<td class="textlinks" align="left">
23[<b><a href="http://www.gentoo.org/">Gentoo Linux Home</a></b>] 266[<b><a href="http://www.gentoo.org/">Gentoo Linux Home</a></b>]
24[<b><a href="http://www.gentoo.org/proj/en/glep">GLEP Index</a></b>] 267[<b><a href="http://www.gentoo.org/peps">GLEP Index</a></b>]
25[<b><a href="http://www.gentoo.org/proj/en/glep/glep-0010.txt">GLEP Source</a></b>] 268[<b><a href="http://www.gentoo.org/proj/en/glep/glep-0010.txt">GLEP Source</a></b>]
26</td></tr></table> 269</td></tr></table>
27<div class="document">
28<table class="rfc2822 field-list" frame="void" rules="none"> 270<table class="rfc2822 docutils field-list" frame="void" rules="none">
29<col class="field-name" /> 271<col class="field-name" />
30<col class="field-body" /> 272<col class="field-body" />
31<tbody valign="top"> 273<tbody valign="top">
32<tr class="field"><th class="field-name">GLEP:</th><td class="field-body">10</td> 274<tr class="field"><th class="field-name">GLEP:</th><td class="field-body">10</td>
33</tr> 275</tr>
34<tr class="field"><th class="field-name">Title:</th><td class="field-body">Internationalization of www.gentoo.org</td> 276<tr class="field"><th class="field-name">Title:</th><td class="field-body">Localized Gentoo Sites</td>
35</tr> 277</tr>
36<tr class="field"><th class="field-name">Version:</th><td class="field-body">1.1</td> 278<tr class="field"><th class="field-name">Version:</th><td class="field-body">1.4</td>
37</tr> 279</tr>
38<tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference" href="http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/proj/en/glep/glep-0010.txt?cvsroot=gentoo">2003/08/04 18:03:54</a></td> 280<tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference" href="http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/proj/en/glep/glep-0010.txt?cvsroot=gentoo">2004/08/22 13:57:11</a></td>
39</tr> 281</tr>
40<tr class="field"><th class="field-name">Author:</th><td class="field-body">Sven Vermeulen &lt;swift&#32;&#97;t&#32;gentoo.org&gt;</td> 282<tr class="field"><th class="field-name">Author:</th><td class="field-body">Tobias Scherbaum &lt;dertobi123&#32;&#97;t&#32;gentoo.org&gt;, Sven Vermeulen &lt;swift&#32;&#97;t&#32;gentoo.org&gt;</td>
41</tr> 283</tr>
42<tr class="field"><th class="field-name">Status:</th><td class="field-body">Draft</td> 284<tr class="field"><th class="field-name">Status:</th><td class="field-body">deferred</td>
43</tr> 285</tr>
44<tr class="field"><th class="field-name">Type:</th><td class="field-body">Standards Track</td>
45</tr>
46<tr class="field"><th class="field-name">Content-Type:</th><td class="field-body"><a class="reference" href="glep-0002.html">text/x-rst</a></td>
47</tr>
48<tr class="field"><th class="field-name">Created:</th><td class="field-body">4 Aug 2003</td> 286<tr class="field"><th class="field-name">Created:</th><td class="field-body">4-Aug-2003</td>
49</tr> 287</tr>
50<tr class="field"><th class="field-name">Post-History:</th><td class="field-body">4-Aug-2003</td> 288<tr class="field"><th class="field-name">Post-History:</th><td class="field-body">4-Aug-2003, 22-Aug-2003, 14-Mar-2004, 2-May-2004, 22-Aug-2004</td>
51</tr> 289</tr>
52</tbody> 290</tbody>
53</table> 291</table>
54<hr /> 292<hr />
55<div class="contents topic" id="contents"> 293<div class="contents topic">
56<p class="topic-title"><a name="contents">Contents</a></p> 294<p class="topic-title first"><a id="contents" name="contents">Contents</a></p>
57<ul class="simple"> 295<ul class="simple">
296<li><a class="reference" href="#status" id="id4" name="id4">Status</a></li>
58<li><a class="reference" href="#abstract" id="id11" name="id11">Abstract</a></li> 297<li><a class="reference" href="#abstract" id="id5" name="id5">Abstract:</a></li>
59<li><a class="reference" href="#motivation" id="id12" name="id12">Motivation</a></li> 298<li><a class="reference" href="#motivation" id="id6" name="id6">Motivation:</a></li>
60<li><a class="reference" href="#rationale" id="id13" name="id13">Rationale</a></li> 299<li><a class="reference" href="#rationale" id="id7" name="id7">Rationale:</a></li>
61<li><a class="reference" href="#implementation" id="id14" name="id14">Implementation</a><ul> 300<li><a class="reference" href="#implementation" id="id8" name="id8">Implementation:</a><ul>
62<li><a class="reference" href="#cvs-structure" id="id15" name="id15">CVS Structure</a></li>
63<li><a class="reference" href="#internationalized-website" id="id16" name="id16">Internationalized Website</a></li>
64<li><a class="reference" href="#permissions" id="id17" name="id17">Permissions</a></li> 301<li><a class="reference" href="#website-pages" id="id9" name="id9">Website Pages:</a><ul>
302<li><a class="reference" href="#requirements-for-small-localized-sites" id="id10" name="id10">Requirements for &quot;small&quot; localized sites:</a></li>
303<li><a class="reference" href="#requirements-for-big-localized-sites" id="id11" name="id11">Requirements for &quot;big&quot; localized sites:</a></li>
65</ul> 304</ul>
66</li> 305</li>
67<li><a class="reference" href="#backwards-compatibility" id="id18" name="id18">Backwards Compatibility</a></li> 306<li><a class="reference" href="#cvs-structure" id="id12" name="id12">CVS Structure:</a></li>
307<li><a class="reference" href="#mail" id="id13" name="id13">Mail:</a></li>
68<li><a class="reference" href="#references" id="id19" name="id19">References</a></li> 308<li><a class="reference" href="#xsl" id="id14" name="id14">XSL:</a></li>
69<li><a class="reference" href="#copyright" id="id20" name="id20">Copyright</a></li>
70</ul> 309</ul>
310</li>
311</ul>
71</div> 312</div>
72<div class="section" id="abstract"> 313<div class="section">
314<h1><a class="toc-backref" href="#id4" id="status" name="status">Status</a></h1>
315<p>Due to insufficient resources, the doc team is unable to implement
316this GLEP at this time. It has therefore been marked &quot;deferred&quot;.</p>
317</div>
318<div class="section">
73<h1><a class="toc-backref" href="#id11" name="abstract">Abstract</a></h1> 319<h1><a class="toc-backref" href="#id5" id="abstract" name="abstract">Abstract:</a></h1>
74<p>The <a class="reference" href="http://www.gentoo.org">Gentoo web site</a> <a class="footnote-reference" href="#id3" id="id4" name="id4">[2]</a> is the main source of documentation regarding 320<p>The Gentoo Website <a class="footnote-reference" href="#gentoo" id="id1" name="id1">[1]</a> is the main source of documentation regarding
75Gentoo itself. It hosts all documents that the <a class="reference" href="http://www.gentoo.org/proj/en/gdp">Gentoo Documentation 321Gentoo itself. It hosts all documents that the Gentoo Documentation Project
76Project</a> <a class="footnote-reference" href="#id5" id="id6" name="id6">[3]</a> delivers, including all made translations.</p> 322<a class="footnote-reference" href="#gdp" id="id2" name="id2">[2]</a> delivers, including all made translations. In addition the website
77<p>This GLEP proposes a change in CVS structure regarding the documentation 323contains the GWN and its translations and several news items.</p>
78so that the individual translation teams can create a localized Gentoo
79website as proposed by <a class="reference" href="http://bugs.gentoo.org/show_bug.cgi?id=23199">Bug #23199</a> <a class="footnote-reference" href="#id7" id="id8" name="id8">[4]</a>.</p>
80</div> 324</div>
81<div class="section" id="motivation"> 325<div class="section">
82<h1><a class="toc-backref" href="#id12" name="motivation">Motivation</a></h1> 326<h1><a class="toc-backref" href="#id6" id="motivation" name="motivation">Motivation:</a></h1>
83<p>Lots of people have shown interest in the internationalization proposal, 327<p>Lots of people have shown interest in the localization proposal, and
84and even the infrastructure team has given positive feedback. However, 328even the infrastructure team has given positive feedback. However, due
85due to lack of a good roadmap and proposal this suggestion has never 329to lack of a good roadmap and proposal this suggestion has never grown
86grown beyond what it is now: a suggestion.</p> 330beyond what it is now: a suggestion. Between the first draft of this
87<p>The current CVS structure (and permissions) are insufficient to implement an 331proposal and now some communities grown faster than others. Actually it
88internationalized website. The current permissions are to broad while they 332is obvious that we have big communities (lots of users, lots of
89should be very strict, the current layout is too fragmented while it should be 333translators) and smaller communities (less users, less translators). If
90grouped together.</p> 334we speak about localized Gentoo sites we need to find a capable
335solution for small and even bigger communities. This leads us to a
336point where the lead translator can decide between a small localized
337site including necessarily translated documents and only some
338additional pages and a bigger variant with lots of translated gdp
339documents, translated news and gwn plus additional pages.</p>
91</div> 340</div>
92<div class="section" id="rationale"> 341<div class="section">
93<h1><a class="toc-backref" href="#id13" name="rationale">Rationale</a></h1> 342<h1><a class="toc-backref" href="#id7" id="rationale" name="rationale">Rationale:</a></h1>
94<p>The current layout regarding documentation in the CVS is as follows:</p> 343<p>The current layout regarding documentation in the CVS is as follows:</p>
95<pre class="literal-block"> 344<blockquote>
96[gentoo]/xml/htdocs/doc/en/* 345[gentoo]/xml/htdocs/doc/en/*
97[gentoo]/xml/htdocs/doc/nl/* 346[gentoo]/xml/htdocs/doc/nl/*
98[gentoo]/xml/htdocs/doc/fr/* 347[gentoo]/xml/htdocs/doc/fr/*</blockquote>
99... 348<p>However, there are several other documents (about, policy, etc) in
100</pre> 349main/$lang:</p>
101<p>However, the documentation index page itself (and several other 350<blockquote>
102important parts of the Gentoo website) are structed like this:</p>
103<pre class="literal-block">
104[gentoo]/xml/htdocs/main/en/* 351[gentoo]/xml/htdocs/main/en/*
105[gentoo]/xml/htdocs/main/nl/* 352[gentoo]/xml/htdocs/main/nl/*
106[gentoo]/xml/htdocs/main/fr/* 353[gentoo]/xml/htdocs/main/fr/*</blockquote>
107...
108</pre>
109<p>This structure makes it very difficult for assigning permissions to the 354<p>This structure makes it very difficult for assigning permissions to the
110individual translation teams, and even more difficult to really localise 355individual translation teams, and even more difficult to really localize
111the Gentoo Website. At this very moment, the translation teams can edit 356the Gentoo Website. At this very moment, the translation teams can edit
112documents of other languages or even the master English documents. English 357documents of other languages or even the master English documents. English
113reviewers and editors can touch documents of languages they possibly don't 358reviewers and editors can touch documents of languages they possibly don't
114even know. Although we do trust every single documentation editor, a better 359even know. Although we do trust every single documentation editor, a better
115implementation is advisable.</p> 360implementation is advisable. We also can't give access to well-known
361but non-dev translators.</p>
116<p>We want to restructure the current layout so that the Gentoo Website is 362<p>We want to restructure the current layout so that the Gentoo Website is
117more easily internationalized.</p> 363more easily internationalized.</p>
118</div> 364</div>
119<div class="section" id="implementation"> 365<div class="section">
120<h1><a class="toc-backref" href="#id14" name="implementation">Implementation</a></h1> 366<h1><a class="toc-backref" href="#id8" id="implementation" name="implementation">Implementation:</a></h1>
121<div class="section" id="cvs-structure"> 367<div class="section">
368<h2><a class="toc-backref" href="#id9" id="website-pages" name="website-pages">Website Pages:</a></h2>
369<p>The Lead Translator can choose if he wants to maintain a &quot;small&quot; or a
370&quot;big&quot; localized site. All localized sites will be accessible on
371<a class="reference" href="http://$lang.gentoo.org">http://$lang.gentoo.org</a> which will point to [gentoo]xml/htdocs/$lang.
372All localized sites must be implemented in GuideXML.</p>
373<div class="section">
374<h3><a class="toc-backref" href="#id10" id="requirements-for-small-localized-sites" name="requirements-for-small-localized-sites">Requirements for &quot;small&quot; localized sites:</a></h3>
375<blockquote>
376<ul class="simple">
377<li>all documents marked as required in our Translators Howto</li>
378<li>$lang/main/translators.xml, listing of all translators (including
379GWN translators)</li>
380<li>$lang/main/communities.xml, listing of all community sites available in $lang</li>
381<li>index.xml &quot;welcome page&quot;, listing of available ressources on
382$lang.gentoo.org (i.e. links to documentation, translators.xml and
383communities.xml)</li>
384</ul>
385</blockquote>
386</div>
387<div class="section">
388<h3><a class="toc-backref" href="#id11" id="requirements-for-big-localized-sites" name="requirements-for-big-localized-sites">Requirements for &quot;big&quot; localized sites:</a></h3>
389<blockquote>
390<ul class="simple">
391<li>all documents marked as required in our Translators Howto</li>
392<li>$lang/main/translators.xml, listing of all translators (including
393GWN translators)</li>
394<li>$lang/main/communities.xml, listing of all community sites available in $lang</li>
395<li>translated $lang/main documents</li>
396<li>translated $lang/news/gwn</li>
397<li>translated news items ($lang/news) (only translated news items,
398news items on a per-lang basis aren't allowed)</li>
399</ul>
400</blockquote>
401</div>
402</div>
403<div class="section">
122<h2><a class="toc-backref" href="#id15" name="cvs-structure">CVS Structure</a></h2> 404<h2><a class="toc-backref" href="#id12" id="cvs-structure" name="cvs-structure">CVS Structure:</a></h2>
123<p>A better implementation is to fully seperate each language from the 405<p>Actual scheme, everything is relative to [gentoo]/xml/htdocs:</p>
124other. For instance:</p>
125<pre class="literal-block"> 406<pre class="literal-block">
126[gentoo]/xml/htdocs/en/doc 407main/en Contains the main Gentoo Website (about, policy, lists, etc.)
127[gentoo]/xml/htdocs/en/main 408main/$lang Contains some translated Website pages
128[gentoo]/xml/htdocs/en/proj 409doc/en Contains the master English Documentation
129... 410doc/$lang Contains the translated Documentation
130[gentoo]/xml/htdocs/nl/doc 411news Contains English news items
131[gentoo]/xml/htdocs/nl/main 412news/en/gwn Contains the master English GWNs
132[gentoo]/xml/htdocs/nl/proj 413news/$lang/gwn Contains translated GWNs
133... 414proj/en Contains the project Webpages
134[gentoo]/xml/htdocs/fr/doc
135[gentoo]/xml/htdocs/fr/main
136[gentoo]/xml/htdocs/fr/proj
137...
138</pre> 415</pre>
139<p>This implementation has several advantages:</p> 416<p>Proposed scheme, relative to [gentoo]/xml/htdocs:</p>
140<ul>
141<li><p class="first">Easy (and more secure) CVS permissions</p>
142<p>Every translation team can now be contained in its own group regarding
143permissions. That group has access to the full
144[gentoo]/xml/htdocs/${LANGUAGE} directory and subdirectories. Other
145languages (including English) cannot be touched by the translation
146teams.</p>
147</li>
148<li><p class="first">Better integration regarding the website</p>
149<p>Currently, the website's <a class="reference" href="http://www.gentoo.org/main/en/docs.xml">documentation page</a> <a class="footnote-reference" href="#id9" id="id10" name="id10">[5]</a> lists all translations
150too. Every time a new translation is uploaded, the links are adjusted.
151With the new structure, the translation teams are in charge of their
152own documentation page which can be found through
153<a class="reference" href="http://www.gentoo.org">http://www.gentoo.org</a>/${LANGUAGE}/main/docs.xml.</p>
154</li>
155<li><p class="first">Internationalization of the website</p>
156<p>In this stadium <a class="reference" href="http://www.gentoo.org">http://www.gentoo.org</a>/${LANGUAGE} would host the
157internationalized Gentoo web site. The infrastructure-team would then
158make sure that <a class="reference" href="http:/">http:/</a>/${LANGUAGE}.gentoo.org refers to the
159beforementioned URL.</p>
160</li>
161</ul>
162<p>This CVS restructure shouldn't take much time, it does require an atomic
163move of the existing directories, meaning CVS access for all affected
164parties (and this <em>includes</em> the Gentoo Project webpages) would be
165unavailable during the transition. It also requires a rewrite of permissions
166which is discussed further down this GLEP.</p>
167</div>
168<div class="section" id="internationalized-website">
169<h2><a class="toc-backref" href="#id16" name="internationalized-website">Internationalized Website</a></h2>
170<p>The Gentoo web servers (and their update-pace) aren't created for
171high-volume data transfers or updates. Therefor a consensus was made
172that the teams in charge of the internationalization of the Gentoo web
173site (in this proposal the translation teams) would not create a
174blog-like situation, but link existing localised gentoo communities <a class="footnote-reference" href="#id2" id="id1" name="id1">[1]</a>
175from the <a class="reference" href="http:/">http:/</a>/${LANGUAGE}.gentoo.org website.</p>
176<p>Some people might ask why we wouldn't just have
177<a class="reference" href="http:/">http:/</a>/${LANGUAGE}.gentoo.org refer (through DNS or otherwise) to the
178respective community site. This is because that implementation is only
179plausible if there is only one community site regarding the
180language/country. However, there can be several such community sites,
181and providing one with the referral and not the other would be
182discriminating.</p>
183</div>
184<div class="section" id="permissions">
185<h2><a class="toc-backref" href="#id17" name="permissions">Permissions</a></h2>
186<p>The proposed implementation would result in the following possible
187permission scheme (all read/write):</p>
188<pre class="literal-block"> 417<pre class="literal-block">
189cvswebdoc: [gentoo]/xml/htdocs/en/main and [gentoo]/xml/htdocs/en/doc 418$lang/main Contains some translated Website pages
190cvsnlweb: [gentoo]/xml/htdocs/nl 419$lang/doc Contains the translated Documentation
191cvsfrweb: [gentoo]/xml/htdocs/fr 420$lang/news Contains translated news items
192... 421$lang/news/gwn Contains translated GWNs
193cvskernel: [gentoo]/xml/htdocs/en/proj/kernel
194cvsgdp: [gentoo]/xml/htdocs/en/proj/gdp
195cvsinfrastruct: [gentoo]/xml/htdocs/en/proj/infrastructure
196</pre> 422</pre>
197<p>As you can see, the translation teams are in charge of the whole
198internationalization: translation of website, projects, documentation.</p>
199<p>The English documentation team is contained in cvswebdoc and has access
200to the doc/ subdirectory (in which the documentation resides) and the
201main/ subdirectory (in which the docs.xml page and others reside).</p>
202<p>The project web pages themselves are contained in seperate groups as is
203currently the case.</p>
204</div> 423</div>
424<div class="section">
425<h2><a class="toc-backref" href="#id13" id="mail" name="mail">Mail:</a></h2>
426<p>All mails to <a class="reference" href="mailto:www-$lang&#64;gentoo.org">www-$lang&#64;gentoo.org</a> should be forwarded to the Lead
427Translator and his Follow-Up.</p>
205</div> 428</div>
206<div class="section" id="backwards-compatibility"> 429<div class="section">
207<h1><a class="toc-backref" href="#id18" name="backwards-compatibility">Backwards Compatibility</a></h1> 430<h2><a class="toc-backref" href="#id14" id="xsl" name="xsl">XSL:</a></h2>
208<p>Although nothing gets lost, the new implementation is not compatible with the 431<p>We need to &quot;hack&quot; our guide.xsl to support something like inserts.xml for the
209current one. However, due to the nature of documentation (and website) this is 432whole site.</p>
210not a problem.</p>
211</div>
212<div class="section" id="references">
213<h1><a class="toc-backref" href="#id19" name="references">References</a></h1>
214<table class="footnote" frame="void" id="id2" rules="none"> 433<table class="docutils footnote" frame="void" id="gentoo" rules="none">
215<colgroup><col class="label" /><col /></colgroup> 434<colgroup><col class="label" /><col /></colgroup>
216<tbody valign="top"> 435<tbody valign="top">
217<tr><td class="label"><a class="fn-backref" href="#id1" name="id2">[1]</a></td><td>A sum of such community sites can be found at 436<tr><td class="label"><a class="fn-backref" href="#id1" name="gentoo">[1]</a></td><td><a class="reference" href="http://www.gentoo.org">http://www.gentoo.org</a></td></tr>
218<a class="reference" href="http://dev.gentoo.org/~liquidx/communities.html">http://dev.gentoo.org/~liquidx/communities.html</a></td></tr>
219</tbody> 437</tbody>
220</table> 438</table>
221<table class="footnote" frame="void" id="id3" rules="none"> 439<table class="docutils footnote" frame="void" id="gdp" rules="none">
222<colgroup><col class="label" /><col /></colgroup> 440<colgroup><col class="label" /><col /></colgroup>
223<tbody valign="top"> 441<tbody valign="top">
224<tr><td class="label"><a class="fn-backref" href="#id4" name="id3">[2]</a></td><td><a class="reference" href="http://www.gentoo.org">http://www.gentoo.org</a></td></tr> 442<tr><td class="label"><a class="fn-backref" href="#id2" name="gdp">[2]</a></td><td><a class="reference" href="http://gdp.gentoo.org">http://gdp.gentoo.org</a></td></tr>
225</tbody> 443</tbody>
226</table> 444</table>
227<table class="footnote" frame="void" id="id5" rules="none">
228<colgroup><col class="label" /><col /></colgroup>
229<tbody valign="top">
230<tr><td class="label"><a class="fn-backref" href="#id6" name="id5">[3]</a></td><td><a class="reference" href="http://www.gentoo.org/proj/en/gdp">http://www.gentoo.org/proj/en/gdp</a></td></tr>
231</tbody>
232</table>
233<table class="footnote" frame="void" id="id7" rules="none">
234<colgroup><col class="label" /><col /></colgroup>
235<tbody valign="top">
236<tr><td class="label"><a class="fn-backref" href="#id8" name="id7">[4]</a></td><td><a class="reference" href="http://bugs.gentoo.org/show_bug.cgi?id=23199">http://bugs.gentoo.org/show_bug.cgi?id=23199</a></td></tr>
237</tbody>
238</table>
239<table class="footnote" frame="void" id="id9" rules="none">
240<colgroup><col class="label" /><col /></colgroup>
241<tbody valign="top">
242<tr><td class="label"><a class="fn-backref" href="#id10" name="id9">[5]</a></td><td><a class="reference" href="http://www.gentoo.org/main/en/docs.xml">http://www.gentoo.org/main/en/docs.xml</a></td></tr>
243</tbody>
244</table>
245</div> 445</div>
246<div class="section" id="copyright">
247<h1><a class="toc-backref" href="#id20" name="copyright">Copyright</a></h1>
248<p>This document has been placed in the public domain.</p>
249</div> 446</div>
250</div>
251 447
252<hr class="footer"/> 448</div>
253<div class="footer"> 449<div class="footer">
450<hr class="footer" />
254<a class="reference" href="glep-0010.txt">View document source</a>. 451<a class="reference" href="glep-0010.txt">View document source</a>.
255Generated on: 2003-08-04 18:18 UTC. 452Generated on: 2006-10-10 20:23 UTC.
256Generated by <a class="reference" href="http://docutils.sourceforge.net/">Docutils</a> from <a class="reference" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> source. 453Generated by <a class="reference" href="http://docutils.sourceforge.net/">Docutils</a> from <a class="reference" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> source.
454
257</div> 455</div>
258</body> 456</body>
259</html> 457</html>
260 458

Legend:
Removed from v.1.1  
changed lines
  Added in v.1.5

  ViewVC Help
Powered by ViewVC 1.1.20