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

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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.6 - (show annotations) (download) (as text)
Thu Jan 25 03:25:53 2007 UTC (7 years, 2 months ago) by antarus
Branch: MAIN
Changes since 1.5: +3 -3 lines
File MIME type: text/html
Fix headers in all current gleps

1 <?xml version="1.0" encoding="utf-8" ?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4 <!--
5 This HTML is auto-generated. DO NOT EDIT THIS FILE! If you are writing a new
6 PEP, see http://www.python.org/peps/pep-0001.html for instructions and links
7 to templates. DO NOT USE THIS HTML FILE AS YOUR TEMPLATE!
8 -->
9 <head>
10 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
11 <meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" />
12 <title>GLEP 10 -- Localized Gentoo Sites</title>
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
22 Default 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
66 a.toc-backref {
67 text-decoration: none ;
68 color: black }
69
70 body {
71 margin: 0px ;
72 margin-bottom: 1em ;
73 padding: 0px }
74
75 dd {
76 margin-bottom: 0.5em }
77
78 div.section {
79 margin-left: 1em ;
80 margin-right: 1em ;
81 margin-bottom: 1.5em }
82
83 div.section div.section {
84 margin-left: 0em ;
85 margin-right: 0em ;
86 margin-top: 1.5em }
87
88 div.abstract {
89 margin: 2em 5em }
90
91 div.abstract p.topic-title {
92 font-weight: bold ;
93 text-align: center }
94
95 div.attention, div.caution, div.danger, div.error, div.hint,
96 div.important, div.note, div.tip, div.warning {
97 margin: 2em ;
98 border: medium outset ;
99 padding: 1em }
100
101 div.attention p.admonition-title, div.caution p.admonition-title,
102 div.danger p.admonition-title, div.error p.admonition-title,
103 div.warning p.admonition-title {
104 color: red ;
105 font-weight: bold ;
106 font-family: sans-serif }
107
108 div.hint p.admonition-title, div.important p.admonition-title,
109 div.note p.admonition-title, div.tip p.admonition-title {
110 font-weight: bold ;
111 font-family: sans-serif }
112
113 div.figure {
114 margin-left: 2em }
115
116 div.footer, div.header {
117 font-size: smaller }
118
119 div.footer {
120 margin-left: 1em ;
121 margin-right: 1em }
122
123 div.system-messages {
124 margin: 5em }
125
126 div.system-messages h1 {
127 color: red }
128
129 div.system-message {
130 border: medium outset ;
131 padding: 1em }
132
133 div.system-message p.system-message-title {
134 color: red ;
135 font-weight: bold }
136
137 div.topic {
138 margin: 2em }
139
140 h1 {
141 font-family: sans-serif ;
142 font-size: large }
143
144 h2 {
145 font-family: sans-serif ;
146 font-size: medium }
147
148 h3 {
149 font-family: sans-serif ;
150 font-size: small }
151
152 h4 {
153 font-family: sans-serif ;
154 font-style: italic ;
155 font-size: small }
156
157 h5 {
158 font-family: sans-serif;
159 font-size: x-small }
160
161 h6 {
162 font-family: sans-serif;
163 font-style: italic ;
164 font-size: x-small }
165
166 .section hr {
167 width: 75% }
168
169 ol.simple, ul.simple {
170 margin-bottom: 1em }
171
172 ol.arabic {
173 list-style: decimal }
174
175 ol.loweralpha {
176 list-style: lower-alpha }
177
178 ol.upperalpha {
179 list-style: upper-alpha }
180
181 ol.lowerroman {
182 list-style: lower-roman }
183
184 ol.upperroman {
185 list-style: upper-roman }
186
187 p.caption {
188 font-style: italic }
189
190 p.credits {
191 font-style: italic ;
192 font-size: smaller }
193
194 p.label {
195 white-space: nowrap }
196
197 p.topic-title {
198 font-family: sans-serif ;
199 font-weight: bold }
200
201 pre.line-block {
202 font-family: serif ;
203 font-size: 100% }
204
205 pre.literal-block, pre.doctest-block {
206 margin-left: 2em ;
207 margin-right: 2em ;
208 background-color: #eeeeee }
209
210 span.classifier {
211 font-family: sans-serif ;
212 font-style: oblique }
213
214 span.classifier-delimiter {
215 font-family: sans-serif ;
216 font-weight: bold }
217
218 span.interpreted {
219 font-family: sans-serif }
220
221 span.option-argument {
222 font-style: italic }
223
224 span.pre {
225 white-space: pre }
226
227 span.problematic {
228 color: red }
229
230 table {
231 margin-top: 0.5em ;
232 margin-bottom: 0.5em }
233
234 td, th {
235 padding-left: 0.5em ;
236 padding-right: 0.5em ;
237 vertical-align: top }
238
239 td.num {
240 text-align: right }
241
242 th.field-name {
243 font-weight: bold ;
244 text-align: left ;
245 white-space: nowrap }
246
247 h1 tt, h2 tt, h3 tt, h4 tt, h5 tt, h6 tt {
248 font-size: 100% }
249
250 tt {
251 background-color: #eeeeee }
252
253 ul.auto-toc {
254 list-style-type: none }
255
256 </style>
257 </head>
258 <body bgcolor="white">
259 <table class="navigation" cellpadding="0" cellspacing="0"
260 width="100%" border="0">
261 <tr><td class="navicon" width="150" height="35">
262 <a href="http://www.gentoo.org/" title="Gentoo Linux Home Page">
263 <img src="http://www.gentoo.org/images/gentoo-new.gif" alt="[Gentoo]"
264 border="0" width="150" height="35" /></a></td>
265 <td class="textlinks" align="left">
266 [<b><a href="http://www.gentoo.org/">Gentoo Linux Home</a></b>]
267 [<b><a href="http://www.gentoo.org/proj/en/glep/">GLEP Index</a></b>]
268 [<b><a href="http://www.gentoo.org/proj/en/glep/glep-0010.txt">GLEP Source</a></b>]
269 </td></tr></table>
270 <table class="rfc2822 docutils field-list" frame="void" rules="none">
271 <col class="field-name" />
272 <col class="field-body" />
273 <tbody valign="top">
274 <tr class="field"><th class="field-name">GLEP:</th><td class="field-body">10</td>
275 </tr>
276 <tr class="field"><th class="field-name">Title:</th><td class="field-body">Localized Gentoo Sites</td>
277 </tr>
278 <tr class="field"><th class="field-name">Version:</th><td class="field-body">1.4</td>
279 </tr>
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>
281 </tr>
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>
283 </tr>
284 <tr class="field"><th class="field-name">Status:</th><td class="field-body">deferred</td>
285 </tr>
286 <tr class="field"><th class="field-name">Created:</th><td class="field-body">4-Aug-2003</td>
287 </tr>
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>
289 </tr>
290 </tbody>
291 </table>
292 <hr />
293 <div class="contents topic">
294 <p class="topic-title first"><a id="contents" name="contents">Contents</a></p>
295 <ul class="simple">
296 <li><a class="reference" href="#status" id="id4" name="id4">Status</a></li>
297 <li><a class="reference" href="#abstract" id="id5" name="id5">Abstract:</a></li>
298 <li><a class="reference" href="#motivation" id="id6" name="id6">Motivation:</a></li>
299 <li><a class="reference" href="#rationale" id="id7" name="id7">Rationale:</a></li>
300 <li><a class="reference" href="#implementation" id="id8" name="id8">Implementation:</a><ul>
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>
304 </ul>
305 </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>
308 <li><a class="reference" href="#xsl" id="id14" name="id14">XSL:</a></li>
309 </ul>
310 </li>
311 </ul>
312 </div>
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
316 this GLEP at this time. It has therefore been marked &quot;deferred&quot;.</p>
317 </div>
318 <div class="section">
319 <h1><a class="toc-backref" href="#id5" id="abstract" name="abstract">Abstract:</a></h1>
320 <p>The Gentoo Website <a class="footnote-reference" href="#gentoo" id="id1" name="id1">[1]</a> is the main source of documentation regarding
321 Gentoo itself. It hosts all documents that the Gentoo Documentation Project
322 <a class="footnote-reference" href="#gdp" id="id2" name="id2">[2]</a> delivers, including all made translations. In addition the website
323 contains the GWN and its translations and several news items.</p>
324 </div>
325 <div class="section">
326 <h1><a class="toc-backref" href="#id6" id="motivation" name="motivation">Motivation:</a></h1>
327 <p>Lots of people have shown interest in the localization proposal, and
328 even the infrastructure team has given positive feedback. However, due
329 to lack of a good roadmap and proposal this suggestion has never grown
330 beyond what it is now: a suggestion. Between the first draft of this
331 proposal and now some communities grown faster than others. Actually it
332 is obvious that we have big communities (lots of users, lots of
333 translators) and smaller communities (less users, less translators). If
334 we speak about localized Gentoo sites we need to find a capable
335 solution for small and even bigger communities. This leads us to a
336 point where the lead translator can decide between a small localized
337 site including necessarily translated documents and only some
338 additional pages and a bigger variant with lots of translated gdp
339 documents, translated news and gwn plus additional pages.</p>
340 </div>
341 <div class="section">
342 <h1><a class="toc-backref" href="#id7" id="rationale" name="rationale">Rationale:</a></h1>
343 <p>The current layout regarding documentation in the CVS is as follows:</p>
344 <blockquote>
345 [gentoo]/xml/htdocs/doc/en/*
346 [gentoo]/xml/htdocs/doc/nl/*
347 [gentoo]/xml/htdocs/doc/fr/*</blockquote>
348 <p>However, there are several other documents (about, policy, etc) in
349 main/$lang:</p>
350 <blockquote>
351 [gentoo]/xml/htdocs/main/en/*
352 [gentoo]/xml/htdocs/main/nl/*
353 [gentoo]/xml/htdocs/main/fr/*</blockquote>
354 <p>This structure makes it very difficult for assigning permissions to the
355 individual translation teams, and even more difficult to really localize
356 the Gentoo Website. At this very moment, the translation teams can edit
357 documents of other languages or even the master English documents. English
358 reviewers and editors can touch documents of languages they possibly don't
359 even know. Although we do trust every single documentation editor, a better
360 implementation is advisable. We also can't give access to well-known
361 but non-dev translators.</p>
362 <p>We want to restructure the current layout so that the Gentoo Website is
363 more easily internationalized.</p>
364 </div>
365 <div class="section">
366 <h1><a class="toc-backref" href="#id8" id="implementation" name="implementation">Implementation:</a></h1>
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.
372 All 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
379 GWN 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
383 communities.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
393 GWN 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,
398 news items on a per-lang basis aren't allowed)</li>
399 </ul>
400 </blockquote>
401 </div>
402 </div>
403 <div class="section">
404 <h2><a class="toc-backref" href="#id12" id="cvs-structure" name="cvs-structure">CVS Structure:</a></h2>
405 <p>Actual scheme, everything is relative to [gentoo]/xml/htdocs:</p>
406 <pre class="literal-block">
407 main/en Contains the main Gentoo Website (about, policy, lists, etc.)
408 main/$lang Contains some translated Website pages
409 doc/en Contains the master English Documentation
410 doc/$lang Contains the translated Documentation
411 news Contains English news items
412 news/en/gwn Contains the master English GWNs
413 news/$lang/gwn Contains translated GWNs
414 proj/en Contains the project Webpages
415 </pre>
416 <p>Proposed scheme, relative to [gentoo]/xml/htdocs:</p>
417 <pre class="literal-block">
418 $lang/main Contains some translated Website pages
419 $lang/doc Contains the translated Documentation
420 $lang/news Contains translated news items
421 $lang/news/gwn Contains translated GWNs
422 </pre>
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
427 Translator and his Follow-Up.</p>
428 </div>
429 <div class="section">
430 <h2><a class="toc-backref" href="#id14" id="xsl" name="xsl">XSL:</a></h2>
431 <p>We need to &quot;hack&quot; our guide.xsl to support something like inserts.xml for the
432 whole site.</p>
433 <table class="docutils footnote" frame="void" id="gentoo" rules="none">
434 <colgroup><col class="label" /><col /></colgroup>
435 <tbody valign="top">
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>
437 </tbody>
438 </table>
439 <table class="docutils footnote" frame="void" id="gdp" rules="none">
440 <colgroup><col class="label" /><col /></colgroup>
441 <tbody valign="top">
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>
443 </tbody>
444 </table>
445 </div>
446 </div>
447
448 </div>
449 <div class="footer">
450 <hr class="footer" />
451 <a class="reference" href="glep-0010.txt">View document source</a>.
452 Generated on: 2006-10-10 20:23 UTC.
453 Generated 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
455 </div>
456 </body>
457 </html>

  ViewVC Help
Powered by ViewVC 1.1.20