/[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.2 Revision 1.7
1<?xml version="1.0" encoding="utf-8" ?> 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"> 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"> 3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4<!-- 4
5This HTML is auto-generated. DO NOT EDIT THIS FILE! If you are writing a new
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!
8-->
9<head> 5<head>
10 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 6 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
11 <meta name="generator" content="Docutils 0.3.0: http://docutils.sourceforge.net/" /> 7 <meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" />
12 <title>GLEP 10 -- Localization for Gentoo Community</title> 8 <title>GLEP 10 -- Localized Gentoo Sites</title>
13 <link rel="stylesheet" href="tools/glep.css" type="text/css" /> 9 <link rel="stylesheet" href="tools/glep.css" type="text/css" />
14</head> 10</head>
15<body bgcolor="white"> 11<body bgcolor="white">
16<table class="navigation" cellpadding="0" cellspacing="0" 12<table class="navigation" cellpadding="0" cellspacing="0"
17 width="100%" border="0"> 13 width="100%" border="0">
22<td class="textlinks" align="left"> 18<td class="textlinks" align="left">
23[<b><a href="http://www.gentoo.org/">Gentoo Linux Home</a></b>] 19[<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>] 20[<b><a href="http://www.gentoo.org/proj/en/glep">GLEP Index</a></b>]
25[<b><a href="http://www.gentoo.org/proj/en/glep/glep-0010.txt">GLEP Source</a></b>] 21[<b><a href="http://www.gentoo.org/proj/en/glep/glep-0010.txt">GLEP Source</a></b>]
26</td></tr></table> 22</td></tr></table>
27<div class="document">
28<table class="rfc2822 field-list" frame="void" rules="none"> 23<table class="rfc2822 docutils field-list" frame="void" rules="none">
29<col class="field-name" /> 24<col class="field-name" />
30<col class="field-body" /> 25<col class="field-body" />
31<tbody valign="top"> 26<tbody valign="top">
32<tr class="field"><th class="field-name">GLEP:</th><td class="field-body">10</td> 27<tr class="field"><th class="field-name">GLEP:</th><td class="field-body">10</td>
33</tr> 28</tr>
34<tr class="field"><th class="field-name">Title:</th><td class="field-body">Localization for Gentoo Community</td> 29<tr class="field"><th class="field-name">Title:</th><td class="field-body">Localized Gentoo Sites</td>
35</tr> 30</tr>
36<tr class="field"><th class="field-name">Version:</th><td class="field-body">1.1</td> 31<tr class="field"><th class="field-name">Version:</th><td class="field-body">1.4</td>
37</tr> 32</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> 33<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> 34</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> 35<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> 36</tr>
42<tr class="field"><th class="field-name">Status:</th><td class="field-body">Draft</td> 37<tr class="field"><th class="field-name">Status:</th><td class="field-body">deferred</td>
43</tr> 38</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> 39<tr class="field"><th class="field-name">Created:</th><td class="field-body">4-Aug-2003</td>
49</tr> 40</tr>
50<tr class="field"><th class="field-name">Post-History:</th><td class="field-body">4-Aug-2003, 22-Aug-2003</td> 41<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> 42</tr>
52</tbody> 43</tbody>
53</table> 44</table>
54<hr /> 45<hr />
55<div class="contents topic" id="contents"> 46<div class="contents topic">
56<p class="topic-title"><a name="contents">Contents</a></p> 47<p class="topic-title first"><a id="contents" name="contents">Contents</a></p>
57<ul class="simple"> 48<ul class="simple">
49<li><a class="reference" href="#status" id="id4" name="id4">Status</a></li>
58<li><a class="reference" href="#abstract" id="id8" name="id8">Abstract</a></li> 50<li><a class="reference" href="#abstract" id="id5" name="id5">Abstract:</a></li>
59<li><a class="reference" href="#motivation" id="id9" name="id9">Motivation</a></li> 51<li><a class="reference" href="#motivation" id="id6" name="id6">Motivation:</a></li>
60<li><a class="reference" href="#rationale" id="id10" name="id10">Rationale</a></li> 52<li><a class="reference" href="#rationale" id="id7" name="id7">Rationale:</a></li>
61<li><a class="reference" href="#implementation" id="id11" name="id11">Implementation</a><ul> 53<li><a class="reference" href="#implementation" id="id8" name="id8">Implementation:</a><ul>
62<li><a class="reference" href="#cvs-structure" id="id12" name="id12">CVS Structure</a></li>
63<li><a class="reference" href="#website-pages" id="id13" name="id13">Website pages</a></li> 54<li><a class="reference" href="#website-pages" id="id9" name="id9">Website Pages:</a><ul>
64<li><a class="reference" href="#cvs-permissions" id="id14" name="id14">CVS Permissions</a></li> 55<li><a class="reference" href="#requirements-for-small-localized-sites" id="id10" name="id10">Requirements for &quot;small&quot; localized sites:</a></li>
56<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> 57</ul>
66</li> 58</li>
67<li><a class="reference" href="#references" id="id15" name="id15">References</a></li> 59<li><a class="reference" href="#cvs-structure" id="id12" name="id12">CVS Structure:</a></li>
68<li><a class="reference" href="#copyright" id="id16" name="id16">Copyright</a></li> 60<li><a class="reference" href="#mail" id="id13" name="id13">Mail:</a></li>
61<li><a class="reference" href="#xsl" id="id14" name="id14">XSL:</a></li>
62</ul>
69</ul> 63</li>
64</ul>
70</div> 65</div>
71<div class="section" id="abstract"> 66<div class="section">
67<h1><a class="toc-backref" href="#id4" id="status" name="status">Status</a></h1>
68<p>Due to insufficient resources, the doc team is unable to implement
69this GLEP at this time. It has therefore been marked &quot;deferred&quot;.</p>
70</div>
71<div class="section">
72<h1><a class="toc-backref" href="#id8" name="abstract">Abstract</a></h1> 72<h1><a class="toc-backref" href="#id5" id="abstract" name="abstract">Abstract:</a></h1>
73<p>The <a class="reference" href="http://www.gentoo.org">Gentoo web site</a> <a class="footnote-reference" href="#id2" id="id3" name="id3">[2]</a> is the main source of documentation regarding 73<p>The Gentoo Website <a class="footnote-reference" href="#gentoo" id="id1" name="id1">[1]</a> is the main source of documentation regarding
74Gentoo itself. It hosts all documents that the <a class="reference" href="http://www.gentoo.org/proj/en/gdp">Gentoo Documentation 74Gentoo itself. It hosts all documents that the Gentoo Documentation Project
75Project</a> <a class="footnote-reference" href="#id4" id="id5" name="id5">[3]</a> delivers, including all made translations.</p> 75<a class="footnote-reference" href="#gdp" id="id2" name="id2">[2]</a> delivers, including all made translations. In addition the website
76<p>This GLEP proposes some changes regarding the documentation 76contains the GWN and its translations and several news items.</p>
77so that we can provide our international users with information regarding
78Gentoo Communities, as proposed by <a class="reference" href="http://bugs.gentoo.org/show_bug.cgi?id=23199">Bug #23199</a> <a class="footnote-reference" href="#id6" id="id7" name="id7">[4]</a>.</p>
79</div> 77</div>
80<div class="section" id="motivation"> 78<div class="section">
81<h1><a class="toc-backref" href="#id9" name="motivation">Motivation</a></h1> 79<h1><a class="toc-backref" href="#id6" id="motivation" name="motivation">Motivation:</a></h1>
82<p>Lots of people have shown interest in the localization proposal, 80<p>Lots of people have shown interest in the localization proposal, and
83and even the infrastructure team has given positive feedback. However, 81even the infrastructure team has given positive feedback. However, due
84due to lack of a good roadmap and proposal this suggestion has never 82to lack of a good roadmap and proposal this suggestion has never grown
85grown beyond what it is now: a suggestion.</p> 83beyond what it is now: a suggestion. Between the first draft of this
86<p>The current CVS structure (and permissions) are insufficient to implement a 84proposal and now some communities grown faster than others. Actually it
87localized section for each possible country. The current permissions are to 85is obvious that we have big communities (lots of users, lots of
88broad while they should be very strict, the current layout is too fragmented 86translators) and smaller communities (less users, less translators). If
89while it should be grouped together.</p> 87we speak about localized Gentoo sites we need to find a capable
88solution for small and even bigger communities. This leads us to a
89point where the lead translator can decide between a small localized
90site including necessarily translated documents and only some
91additional pages and a bigger variant with lots of translated gdp
92documents, translated news and gwn plus additional pages.</p>
90</div> 93</div>
91<div class="section" id="rationale"> 94<div class="section">
92<h1><a class="toc-backref" href="#id10" name="rationale">Rationale</a></h1> 95<h1><a class="toc-backref" href="#id7" id="rationale" name="rationale">Rationale:</a></h1>
93<p>The current layout regarding documentation in the CVS is as follows:</p> 96<p>The current layout regarding documentation in the CVS is as follows:</p>
94<pre class="literal-block"> 97<blockquote>
95[gentoo]/xml/htdocs/doc/en/* 98[gentoo]/xml/htdocs/doc/en/*
96[gentoo]/xml/htdocs/doc/nl/* 99[gentoo]/xml/htdocs/doc/nl/*
97[gentoo]/xml/htdocs/doc/fr/* 100[gentoo]/xml/htdocs/doc/fr/*</blockquote>
98... 101<p>However, there are several other documents (about, policy, etc) in
99</pre> 102main/$lang:</p>
100<p>However, the documentation index page itself (and several other 103<blockquote>
101important parts of the Gentoo website) are structed like this:</p>
102<pre class="literal-block">
103[gentoo]/xml/htdocs/main/en/* 104[gentoo]/xml/htdocs/main/en/*
104[gentoo]/xml/htdocs/main/nl/* 105[gentoo]/xml/htdocs/main/nl/*
105[gentoo]/xml/htdocs/main/fr/* 106[gentoo]/xml/htdocs/main/fr/*</blockquote>
106...
107</pre>
108<p>This structure makes it very difficult for assigning permissions to the 107<p>This structure makes it very difficult for assigning permissions to the
109individual translation teams, and even more difficult to really localise 108individual translation teams, and even more difficult to really localize
110the Gentoo Website. At this very moment, the translation teams can edit 109the Gentoo Website. At this very moment, the translation teams can edit
111documents of other languages or even the master English documents. English 110documents of other languages or even the master English documents. English
112reviewers and editors can touch documents of languages they possibly don't 111reviewers and editors can touch documents of languages they possibly don't
113even know. Although we do trust every single documentation editor, a better 112even know. Although we do trust every single documentation editor, a better
114implementation is advisable.</p> 113implementation is advisable. We also can't give access to well-known
114but non-dev translators.</p>
115<p>We want to restructure the current layout so that the Gentoo Website is 115<p>We want to restructure the current layout so that the Gentoo Website is
116more easily internationalized.</p> 116more easily internationalized.</p>
117</div> 117</div>
118<div class="section" id="implementation"> 118<div class="section">
119<h1><a class="toc-backref" href="#id11" name="implementation">Implementation</a></h1> 119<h1><a class="toc-backref" href="#id8" id="implementation" name="implementation">Implementation:</a></h1>
120<div class="section" id="cvs-structure"> 120<div class="section">
121<h2><a class="toc-backref" href="#id9" id="website-pages" name="website-pages">Website Pages:</a></h2>
122<p>The Lead Translator can choose if he wants to maintain a &quot;small&quot; or a
123&quot;big&quot; localized site. All localized sites will be accessible on
124<a class="reference" href="http://$lang.gentoo.org">http://$lang.gentoo.org</a> which will point to [gentoo]xml/htdocs/$lang.
125All localized sites must be implemented in GuideXML.</p>
126<div class="section">
127<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>
128<blockquote>
129<ul class="simple">
130<li>all documents marked as required in our Translators Howto</li>
131<li>$lang/main/translators.xml, listing of all translators (including
132GWN translators)</li>
133<li>$lang/main/communities.xml, listing of all community sites available in $lang</li>
134<li>index.xml &quot;welcome page&quot;, listing of available ressources on
135$lang.gentoo.org (i.e. links to documentation, translators.xml and
136communities.xml)</li>
137</ul>
138</blockquote>
139</div>
140<div class="section">
141<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>
142<blockquote>
143<ul class="simple">
144<li>all documents marked as required in our Translators Howto</li>
145<li>$lang/main/translators.xml, listing of all translators (including
146GWN translators)</li>
147<li>$lang/main/communities.xml, listing of all community sites available in $lang</li>
148<li>translated $lang/main documents</li>
149<li>translated $lang/news/gwn</li>
150<li>translated news items ($lang/news) (only translated news items,
151news items on a per-lang basis aren't allowed)</li>
152</ul>
153</blockquote>
154</div>
155</div>
156<div class="section">
121<h2><a class="toc-backref" href="#id12" name="cvs-structure">CVS Structure</a></h2> 157<h2><a class="toc-backref" href="#id12" id="cvs-structure" name="cvs-structure">CVS Structure:</a></h2>
122<p>What is needed, is a clear distinction between documentation, newsletters,
123website and localization. This requires a directory structure in the CVS
124repository that reflects this distinction.</p>
125<p>In the following scheme, everything is relative to [gentoo]/xml/htdocs:</p> 158<p>Actual scheme, everything is relative to [gentoo]/xml/htdocs:</p>
126<pre class="literal-block"> 159<pre class="literal-block">
127main/en Contains the main Gentoo Website 160main/en Contains the main Gentoo Website (about, policy, lists, etc.)
128main/${LANGUAGE} Contains some translated website pages 161main/$lang Contains some translated Website pages
129main/lcl/${COUNTRYCODE} Contains the localized Gentoo page
130doc/en Contains the master English Documentation 162doc/en Contains the master English Documentation
131doc/${LANGUAGE} Contains the translated Documentation 163doc/$lang Contains the translated Documentation
164news Contains English news items
132news/en Contains the English GWNs 165news/en/gwn Contains the master English GWNs
133news/${LANGUAGE} Contains the translated GWNs 166news/$lang/gwn Contains translated GWNs
134proj/en Contains the project Webpages 167proj/en Contains the project Webpages
135</pre> 168</pre>
136<p>In comparison with what is currently the case, there are no big changes. 169<p>Proposed scheme, relative to [gentoo]/xml/htdocs:</p>
137I've explicitly left out <cite>proj/${LANGUAGE}</cite> since there is no direct
138need to translate project websites. If it is desired, then creating a
139language-specific directory is sufficient.</p>
140</div>
141<div class="section" id="website-pages">
142<h2><a class="toc-backref" href="#id13" name="website-pages">Website pages</a></h2>
143<p>Currently, the main documentation page is <cite>main/en/docs.xml</cite>. A better
144implementation would be to have it as <cite>doc/en/index.xml</cite>. This keeps
145everything documentation-related together. It also provides us with
146seperate index pages for each language (<cite>doc/${LANGUAGE}/index.xml</cite>).</p>
147<p>The documentation indexes should mention the other indexes (for other
148languages), but shouldn't have seperate links for each language per
149document.</p>
150<p>The localization page resides in <cite>main/${COUNTRYCODE}/index.xml</cite>. This
151page, which is formatted the same way as the whole Gentoo website,
152<strong>only</strong> contains the following information:</p>
153<pre class="literal-block"> 170<pre class="literal-block">
154- A list of community websites [1]_ 171$lang/main Contains some translated Website pages
155 172$lang/doc Contains the translated Documentation
156- A link to the translated documentation index 173$lang/news Contains translated news items
157 174$lang/news/gwn Contains translated GWNs
158- A link to translated Gentoo-webpages::
159
160 * About
161
162 * Social Contract
163
164 * Gentoo Weekly News
165</pre> 175</pre>
166<p>If the localization team wants, this can be extended to also provide
167news-items (such as with the main Gentoo website). In this case, the
168news items also reside in <cite>main/lcl/${COUNTRYCODE}</cite>.</p>
169<p>Also, <cite>http://${COUNTRYCODE}.gentoo.org</cite> should point to
170<cite>main/lcl/${COUNTRYCODE}/index.xml</cite>.</p>
171</div> 176</div>
172<div class="section" id="cvs-permissions"> 177<div class="section">
173<h2><a class="toc-backref" href="#id14" name="cvs-permissions">CVS Permissions</a></h2> 178<h2><a class="toc-backref" href="#id13" id="mail" name="mail">Mail:</a></h2>
174<p>The permissions are now clear and distinct:</p> 179<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
175<pre class="literal-block"> 180Translator and his Follow-Up.</p>
176- Documentation Developers cannot touch the Gentoo website,
177 except for the Index page, which now resides in `doc/en`.
178
179- Translators can only touch files in `doc/${LANGUAGE}` and
180 `main/${LANGUAGE}`.
181
182- The localized pages, which are rather static (since they only
183 contain a list of community sites), are maintained by a
184 single group for all countrycodes, unless the localization
185 pages also contain newsitems, in which case seperate groups
186 for each country can exist.
187</pre>
188</div> 181</div>
189</div> 182<div class="section">
190<div class="section" id="references"> 183<h2><a class="toc-backref" href="#id14" id="xsl" name="xsl">XSL:</a></h2>
191<h1><a class="toc-backref" href="#id15" name="references">References</a></h1> 184<p>We need to &quot;hack&quot; our guide.xsl to support something like inserts.xml for the
185whole site.</p>
192<table class="footnote" frame="void" id="id1" rules="none"> 186<table class="docutils footnote" frame="void" id="gentoo" rules="none">
193<colgroup><col class="label" /><col /></colgroup> 187<colgroup><col class="label" /><col /></colgroup>
194<tbody valign="top"> 188<tbody valign="top">
195<tr><td class="label"><a name="id1">[1]</a></td><td>A sum of such community sites can be found at 189<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>
196<a class="reference" href="http://dev.gentoo.org/~liquidx/communities.html">http://dev.gentoo.org/~liquidx/communities.html</a></td></tr>
197</tbody> 190</tbody>
198</table> 191</table>
199<table class="footnote" frame="void" id="id2" rules="none"> 192<table class="docutils footnote" frame="void" id="gdp" rules="none">
200<colgroup><col class="label" /><col /></colgroup> 193<colgroup><col class="label" /><col /></colgroup>
201<tbody valign="top"> 194<tbody valign="top">
202<tr><td class="label"><a class="fn-backref" href="#id3" name="id2">[2]</a></td><td><a class="reference" href="http://www.gentoo.org">http://www.gentoo.org</a></td></tr> 195<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>
203</tbody> 196</tbody>
204</table> 197</table>
205<table class="footnote" frame="void" id="id4" rules="none">
206<colgroup><col class="label" /><col /></colgroup>
207<tbody valign="top">
208<tr><td class="label"><a class="fn-backref" href="#id5" name="id4">[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>
209</tbody>
210</table>
211<table class="footnote" frame="void" id="id6" rules="none">
212<colgroup><col class="label" /><col /></colgroup>
213<tbody valign="top">
214<tr><td class="label"><a class="fn-backref" href="#id7" name="id6">[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>
215</tbody>
216</table>
217</div> 198</div>
218<div class="section" id="copyright">
219<h1><a class="toc-backref" href="#id16" name="copyright">Copyright</a></h1>
220<p>This document has been placed in the public domain.</p>
221</div> 199</div>
222</div>
223 200
224<hr class="footer"/> 201</div>
225<div class="footer"> 202<div class="footer">
203<hr class="footer" />
226<a class="reference" href="glep-0010.txt">View document source</a>. 204<a class="reference" href="glep-0010.txt">View document source</a>.
227Generated on: 2003-08-24 22:07 UTC. 205Generated on: 2007-10-13 13:39 UTC.
228Generated 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. 206Generated 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.
207
229</div> 208</div>
230</body> 209</body>
231</html> 210</html>
232 211

Legend:
Removed from v.1.2  
changed lines
  Added in v.1.7

  ViewVC Help
Powered by ViewVC 1.1.20