/[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 - (hide annotations) (download) (as text)
Thu Jan 25 03:25:53 2007 UTC (7 years, 7 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 g2boojum 1.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 g2boojum 1.5 <meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" />
12 g2boojum 1.3 <title>GLEP 10 -- Localized Gentoo Sites</title>
13 g2boojum 1.5 <style type="text/css">
14    
15     /*
16     :Author: David Goodger
17     :Contact: goodger@users.sourceforge.net
18 antarus 1.6 :date: $Date: 2006/10/10 20:25:14 $
19     :version: $Revision: 1.5 $
20 g2boojum 1.5 :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 g2boojum 1.1 </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 antarus 1.6 [<b><a href="http://www.gentoo.org/proj/en/glep/">GLEP Index</a></b>]
268 g2boojum 1.5 [<b><a href="http://www.gentoo.org/proj/en/glep/glep-0010.txt">GLEP Source</a></b>]
269 g2boojum 1.1 </td></tr></table>
270 g2boojum 1.5 <table class="rfc2822 docutils field-list" frame="void" rules="none">
271 g2boojum 1.1 <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 g2boojum 1.3 <tr class="field"><th class="field-name">Title:</th><td class="field-body">Localized Gentoo Sites</td>
277 g2boojum 1.1 </tr>
278 g2boojum 1.4 <tr class="field"><th class="field-name">Version:</th><td class="field-body">1.4</td>
279 g2boojum 1.1 </tr>
280 g2boojum 1.5 <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 g2boojum 1.1 </tr>
282 g2boojum 1.3 <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 g2boojum 1.1 </tr>
284 g2boojum 1.4 <tr class="field"><th class="field-name">Status:</th><td class="field-body">deferred</td>
285 g2boojum 1.1 </tr>
286 g2boojum 1.3 <tr class="field"><th class="field-name">Created:</th><td class="field-body">4-Aug-2003</td>
287 g2boojum 1.1 </tr>
288 g2boojum 1.4 <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 g2boojum 1.1 </tr>
290     </tbody>
291     </table>
292     <hr />
293 g2boojum 1.5 <div class="contents topic">
294     <p class="topic-title first"><a id="contents" name="contents">Contents</a></p>
295 g2boojum 1.1 <ul class="simple">
296 g2boojum 1.4 <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 g2boojum 1.3 </ul>
305     </li>
306 g2boojum 1.4 <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 g2boojum 1.1 </ul>
310     </li>
311     </ul>
312     </div>
313 g2boojum 1.5 <div class="section">
314     <h1><a class="toc-backref" href="#id4" id="status" name="status">Status</a></h1>
315 g2boojum 1.4 <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 g2boojum 1.5 <div class="section">
319     <h1><a class="toc-backref" href="#id5" id="abstract" name="abstract">Abstract:</a></h1>
320 g2boojum 1.3 <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 g2boojum 1.1 </div>
325 g2boojum 1.5 <div class="section">
326     <h1><a class="toc-backref" href="#id6" id="motivation" name="motivation">Motivation:</a></h1>
327 g2boojum 1.3 <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 g2boojum 1.1 </div>
341 g2boojum 1.5 <div class="section">
342     <h1><a class="toc-backref" href="#id7" id="rationale" name="rationale">Rationale:</a></h1>
343 g2boojum 1.1 <p>The current layout regarding documentation in the CVS is as follows:</p>
344 g2boojum 1.3 <blockquote>
345 g2boojum 1.1 [gentoo]/xml/htdocs/doc/en/*
346     [gentoo]/xml/htdocs/doc/nl/*
347 g2boojum 1.3 [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 g2boojum 1.1 [gentoo]/xml/htdocs/main/en/*
352     [gentoo]/xml/htdocs/main/nl/*
353 g2boojum 1.3 [gentoo]/xml/htdocs/main/fr/*</blockquote>
354 g2boojum 1.1 <p>This structure makes it very difficult for assigning permissions to the
355 g2boojum 1.3 individual translation teams, and even more difficult to really localize
356 g2boojum 1.1 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 g2boojum 1.3 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 g2boojum 1.1 <p>We want to restructure the current layout so that the Gentoo Website is
363     more easily internationalized.</p>
364     </div>
365 g2boojum 1.5 <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 g2boojum 1.3 <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 g2boojum 1.5 <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 g2boojum 1.3 <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 g2boojum 1.5 <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 g2boojum 1.3 <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 g2boojum 1.5 <div class="section">
404     <h2><a class="toc-backref" href="#id12" id="cvs-structure" name="cvs-structure">CVS Structure:</a></h2>
405 g2boojum 1.3 <p>Actual scheme, everything is relative to [gentoo]/xml/htdocs:</p>
406 g2boojum 1.2 <pre class="literal-block">
407 g2boojum 1.3 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 g2boojum 1.1 </pre>
416 g2boojum 1.3 <p>Proposed scheme, relative to [gentoo]/xml/htdocs:</p>
417 g2boojum 1.1 <pre class="literal-block">
418 g2boojum 1.3 $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 g2boojum 1.1 </pre>
423     </div>
424 g2boojum 1.5 <div class="section">
425     <h2><a class="toc-backref" href="#id13" id="mail" name="mail">Mail:</a></h2>
426 g2boojum 1.3 <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 g2boojum 1.5 <div class="section">
430     <h2><a class="toc-backref" href="#id14" id="xsl" name="xsl">XSL:</a></h2>
431 g2boojum 1.3 <p>We need to &quot;hack&quot; our guide.xsl to support something like inserts.xml for the
432     whole site.</p>
433 g2boojum 1.5 <table class="docutils footnote" frame="void" id="gentoo" rules="none">
434 g2boojum 1.1 <colgroup><col class="label" /><col /></colgroup>
435     <tbody valign="top">
436 g2boojum 1.3 <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 g2boojum 1.1 </tbody>
438     </table>
439 g2boojum 1.5 <table class="docutils footnote" frame="void" id="gdp" rules="none">
440 g2boojum 1.1 <colgroup><col class="label" /><col /></colgroup>
441     <tbody valign="top">
442 g2boojum 1.3 <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 g2boojum 1.1 </tbody>
444     </table>
445     </div>
446     </div>
447 g2boojum 1.5
448 g2boojum 1.1 </div>
449 g2boojum 1.5 <div class="footer">
450 g2boojum 1.4 <hr class="footer" />
451 g2boojum 1.1 <a class="reference" href="glep-0010.txt">View document source</a>.
452 g2boojum 1.5 Generated on: 2006-10-10 20:23 UTC.
453 g2boojum 1.1 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 g2boojum 1.5
455 g2boojum 1.1 </div>
456     </body>
457     </html>

  ViewVC Help
Powered by ViewVC 1.1.20