/[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.3 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 -- Localized Gentoo Sites</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"
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">Localized Gentoo Sites</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">$Revision: 1.3 $</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">$Date: 2004/05/02 21:15:23 $</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">Tobias Scherbaum &lt;dertobi123&#32;&#97;t&#32;gentoo.org&gt;, 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">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>
45</tr> 40</tr>
46<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</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>
47</tr> 42</tr>
48</tbody> 43</tbody>
49</table> 44</table>
50<hr /> 45<hr />
51<div class="contents topic" id="contents"> 46<div class="contents topic">
52<p class="topic-title"><a name="contents">Contents</a></p> 47<p class="topic-title first"><a id="contents" name="contents">Contents</a></p>
53<ul class="simple"> 48<ul class="simple">
49<li><a class="reference" href="#status" id="id4" name="id4">Status</a></li>
54<li><a class="reference" href="#abstract" id="id4" name="id4">Abstract:</a></li> 50<li><a class="reference" href="#abstract" id="id5" name="id5">Abstract:</a></li>
55<li><a class="reference" href="#motivation" id="id5" name="id5">Motivation:</a></li> 51<li><a class="reference" href="#motivation" id="id6" name="id6">Motivation:</a></li>
56<li><a class="reference" href="#rationale" id="id6" name="id6">Rationale:</a></li> 52<li><a class="reference" href="#rationale" id="id7" name="id7">Rationale:</a></li>
57<li><a class="reference" href="#implementation" id="id7" name="id7">Implementation:</a><ul> 53<li><a class="reference" href="#implementation" id="id8" name="id8">Implementation:</a><ul>
58<li><a class="reference" href="#website-pages" id="id8" name="id8">Website Pages:</a><ul> 54<li><a class="reference" href="#website-pages" id="id9" name="id9">Website Pages:</a><ul>
59<li><a class="reference" href="#requirements-for-small-localized-sites" id="id9" name="id9">Requirements for &quot;small&quot; localized sites:</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>
60<li><a class="reference" href="#requirements-for-big-localized-sites" id="id10" name="id10">Requirements for &quot;big&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>
61</ul> 57</ul>
62</li> 58</li>
63<li><a class="reference" href="#cvs-structure" id="id11" name="id11">CVS Structure:</a></li> 59<li><a class="reference" href="#cvs-structure" id="id12" name="id12">CVS Structure:</a></li>
64<li><a class="reference" href="#mail" id="id12" name="id12">Mail:</a></li> 60<li><a class="reference" href="#mail" id="id13" name="id13">Mail:</a></li>
65<li><a class="reference" href="#xsl" id="id13" name="id13">XSL:</a></li> 61<li><a class="reference" href="#xsl" id="id14" name="id14">XSL:</a></li>
66</ul> 62</ul>
67</li> 63</li>
68</ul> 64</ul>
69</div> 65</div>
70<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">
71<h1><a class="toc-backref" href="#id4" name="abstract">Abstract:</a></h1> 72<h1><a class="toc-backref" href="#id5" id="abstract" name="abstract">Abstract:</a></h1>
72<p>The Gentoo Website <a class="footnote-reference" href="#gentoo" id="id1" name="id1">[1]</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
73Gentoo itself. It hosts all documents that the Gentoo Documentation Project 74Gentoo itself. It hosts all documents that the Gentoo Documentation Project
74<a class="footnote-reference" href="#gdp" id="id2" name="id2">[2]</a> delivers, including all made translations. In addition the website 75<a class="footnote-reference" href="#gdp" id="id2" name="id2">[2]</a> delivers, including all made translations. In addition the website
75contains the GWN and its translations and several news items.</p> 76contains the GWN and its translations and several news items.</p>
76</div> 77</div>
77<div class="section" id="motivation"> 78<div class="section">
78<h1><a class="toc-backref" href="#id5" name="motivation">Motivation:</a></h1> 79<h1><a class="toc-backref" href="#id6" id="motivation" name="motivation">Motivation:</a></h1>
79<p>Lots of people have shown interest in the localization proposal, and 80<p>Lots of people have shown interest in the localization proposal, and
80even the infrastructure team has given positive feedback. However, due 81even the infrastructure team has given positive feedback. However, due
81to lack of a good roadmap and proposal this suggestion has never grown 82to lack of a good roadmap and proposal this suggestion has never grown
82beyond what it is now: a suggestion. Between the first draft of this 83beyond what it is now: a suggestion. Between the first draft of this
83proposal and now some communities grown faster than others. Actually it 84proposal and now some communities grown faster than others. Actually it
88point where the lead translator can decide between a small localized 89point where the lead translator can decide between a small localized
89site including necessarily translated documents and only some 90site including necessarily translated documents and only some
90additional pages and a bigger variant with lots of translated gdp 91additional pages and a bigger variant with lots of translated gdp
91documents, translated news and gwn plus additional pages.</p> 92documents, translated news and gwn plus additional pages.</p>
92</div> 93</div>
93<div class="section" id="rationale"> 94<div class="section">
94<h1><a class="toc-backref" href="#id6" name="rationale">Rationale:</a></h1> 95<h1><a class="toc-backref" href="#id7" id="rationale" name="rationale">Rationale:</a></h1>
95<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>
96<blockquote> 97<blockquote>
97[gentoo]/xml/htdocs/doc/en/* 98[gentoo]/xml/htdocs/doc/en/*
98[gentoo]/xml/htdocs/doc/nl/* 99[gentoo]/xml/htdocs/doc/nl/*
99[gentoo]/xml/htdocs/doc/fr/*</blockquote> 100[gentoo]/xml/htdocs/doc/fr/*</blockquote>
112implementation is advisable. We also can't give access to well-known 113implementation is advisable. We also can't give access to well-known
113but non-dev translators.</p> 114but non-dev translators.</p>
114<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
115more easily internationalized.</p> 116more easily internationalized.</p>
116</div> 117</div>
117<div class="section" id="implementation"> 118<div class="section">
118<h1><a class="toc-backref" href="#id7" name="implementation">Implementation:</a></h1> 119<h1><a class="toc-backref" href="#id8" id="implementation" name="implementation">Implementation:</a></h1>
119<div class="section" id="website-pages"> 120<div class="section">
120<h2><a class="toc-backref" href="#id8" name="website-pages">Website Pages:</a></h2> 121<h2><a class="toc-backref" href="#id9" id="website-pages" name="website-pages">Website Pages:</a></h2>
121<p>The Lead Translator can choose if he wants to maintain a &quot;small&quot; or a 122<p>The Lead Translator can choose if he wants to maintain a &quot;small&quot; or a
122&quot;big&quot; localized site. All localized sites will be accessible on 123&quot;big&quot; localized site. All localized sites will be accessible on
123<a class="reference" href="http://$lang.gentoo.org">http://$lang.gentoo.org</a> which will point to [gentoo]xml/htdocs/$lang. 124<a class="reference" href="http://$lang.gentoo.org">http://$lang.gentoo.org</a> which will point to [gentoo]xml/htdocs/$lang.
124All localized sites must be implemented in GuideXML.</p> 125All localized sites must be implemented in GuideXML.</p>
125<div class="section" id="requirements-for-small-localized-sites"> 126<div class="section">
126<h3><a class="toc-backref" href="#id9" name="requirements-for-small-localized-sites">Requirements for &quot;small&quot; localized sites:</a></h3> 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>
127<blockquote> 128<blockquote>
128<ul class="simple"> 129<ul class="simple">
129<li>all documents marked as required in our Translators Howto</li> 130<li>all documents marked as required in our Translators Howto</li>
130<li>$lang/main/translators.xml, listing of all translators (including 131<li>$lang/main/translators.xml, listing of all translators (including
131GWN translators)</li> 132GWN translators)</li>
134$lang.gentoo.org (i.e. links to documentation, translators.xml and 135$lang.gentoo.org (i.e. links to documentation, translators.xml and
135communities.xml)</li> 136communities.xml)</li>
136</ul> 137</ul>
137</blockquote> 138</blockquote>
138</div> 139</div>
139<div class="section" id="requirements-for-big-localized-sites"> 140<div class="section">
140<h3><a class="toc-backref" href="#id10" name="requirements-for-big-localized-sites">Requirements for &quot;big&quot; localized sites:</a></h3> 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>
141<blockquote> 142<blockquote>
142<ul class="simple"> 143<ul class="simple">
143<li>all documents marked as required in our Translators Howto</li> 144<li>all documents marked as required in our Translators Howto</li>
144<li>$lang/main/translators.xml, listing of all translators (including 145<li>$lang/main/translators.xml, listing of all translators (including
145GWN translators)</li> 146GWN translators)</li>
150news items on a per-lang basis aren't allowed)</li> 151news items on a per-lang basis aren't allowed)</li>
151</ul> 152</ul>
152</blockquote> 153</blockquote>
153</div> 154</div>
154</div> 155</div>
155<div class="section" id="cvs-structure"> 156<div class="section">
156<h2><a class="toc-backref" href="#id11" 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>
157<p>Actual scheme, everything is relative to [gentoo]/xml/htdocs:</p> 158<p>Actual scheme, everything is relative to [gentoo]/xml/htdocs:</p>
158<pre class="literal-block"> 159<pre class="literal-block">
159main/en Contains the main Gentoo Website (about, policy, lists, etc.) 160main/en Contains the main Gentoo Website (about, policy, lists, etc.)
160main/$lang Contains some translated Website pages 161main/$lang Contains some translated Website pages
161doc/en Contains the master English Documentation 162doc/en Contains the master English Documentation
171$lang/doc Contains the translated Documentation 172$lang/doc Contains the translated Documentation
172$lang/news Contains translated news items 173$lang/news Contains translated news items
173$lang/news/gwn Contains translated GWNs 174$lang/news/gwn Contains translated GWNs
174</pre> 175</pre>
175</div> 176</div>
176<div class="section" id="mail"> 177<div class="section">
177<h2><a class="toc-backref" href="#id12" name="mail">Mail:</a></h2> 178<h2><a class="toc-backref" href="#id13" id="mail" name="mail">Mail:</a></h2>
178<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 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
179Translator and his Follow-Up.</p> 180Translator and his Follow-Up.</p>
180</div> 181</div>
181<div class="section" id="xsl"> 182<div class="section">
182<h2><a class="toc-backref" href="#id13" name="xsl">XSL:</a></h2> 183<h2><a class="toc-backref" href="#id14" id="xsl" name="xsl">XSL:</a></h2>
183<p>We need to &quot;hack&quot; our guide.xsl to support something like inserts.xml for the 184<p>We need to &quot;hack&quot; our guide.xsl to support something like inserts.xml for the
184whole site.</p> 185whole site.</p>
185<table class="footnote" frame="void" id="gentoo" rules="none"> 186<table class="docutils footnote" frame="void" id="gentoo" rules="none">
186<colgroup><col class="label" /><col /></colgroup> 187<colgroup><col class="label" /><col /></colgroup>
187<tbody valign="top"> 188<tbody valign="top">
188<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> 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>
189</tbody> 190</tbody>
190</table> 191</table>
191<table class="footnote" frame="void" id="gdp" rules="none"> 192<table class="docutils footnote" frame="void" id="gdp" rules="none">
192<colgroup><col class="label" /><col /></colgroup> 193<colgroup><col class="label" /><col /></colgroup>
193<tbody valign="top"> 194<tbody valign="top">
194<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> 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>
195</tbody> 196</tbody>
196</table> 197</table>
197</div> 198</div>
198</div> 199</div>
199</div>
200 200
201<hr class="footer"/> 201</div>
202<div class="footer"> 202<div class="footer">
203<hr class="footer" />
203<a class="reference" href="glep-0010.txt">View document source</a>. 204<a class="reference" href="glep-0010.txt">View document source</a>.
204Generated on: 2004-05-02 21:14 UTC. 205Generated on: 2007-10-13 13:39 UTC.
205Generated 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
206</div> 208</div>
207</body> 209</body>
208</html> 210</html>
209 211

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

  ViewVC Help
Powered by ViewVC 1.1.20