| 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 | |
| 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> |
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.3: 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" |
| … | |
… | |
| 20 | <img src="http://www.gentoo.org/images/gentoo-new.gif" alt="[Gentoo]" |
16 | <img src="http://www.gentoo.org/images/gentoo-new.gif" alt="[Gentoo]" |
| 21 | border="0" width="150" height="35" /></a></td> |
17 | border="0" width="150" height="35" /></a></td> |
| 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="./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">1.4</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/xml/htdocs/proj/en/glep/glep-0010.txt?cvsroot=gentoo">2004/08/22 13:57:11</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 <dertobi123 at gentoo.org>, Sven Vermeulen <swift at gentoo.org></td> |
35 | <tr class="field"><th class="field-name">Author:</th><td class="field-body">Tobias Scherbaum <dertobi123 at gentoo.org>, Sven Vermeulen <swift at gentoo.org></td> |
| 41 | </tr> |
36 | </tr> |
| 42 | <tr class="field"><th class="field-name">Status:</th><td class="field-body">deferred</td> |
37 | <tr class="field"><th class="field-name">Status:</th><td class="field-body">deferred</td> |
| 43 | </tr> |
38 | </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, 22-Aug-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 first"><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"> |
| 54 | <li><a class="reference" href="#status" id="id4" name="id4">Status</a></li> |
49 | <li><a class="reference" href="#status" id="id4" name="id4">Status</a></li> |
| 55 | <li><a class="reference" href="#abstract" id="id5" name="id5">Abstract:</a></li> |
50 | <li><a class="reference" href="#abstract" id="id5" name="id5">Abstract:</a></li> |
| 56 | <li><a class="reference" href="#motivation" id="id6" name="id6">Motivation:</a></li> |
51 | <li><a class="reference" href="#motivation" id="id6" name="id6">Motivation:</a></li> |
| 57 | <li><a class="reference" href="#rationale" id="id7" name="id7">Rationale:</a></li> |
52 | <li><a class="reference" href="#rationale" id="id7" name="id7">Rationale:</a></li> |
| … | |
… | |
| 66 | <li><a class="reference" href="#xsl" id="id14" name="id14">XSL:</a></li> |
61 | <li><a class="reference" href="#xsl" id="id14" name="id14">XSL:</a></li> |
| 67 | </ul> |
62 | </ul> |
| 68 | </li> |
63 | </li> |
| 69 | </ul> |
64 | </ul> |
| 70 | </div> |
65 | </div> |
| 71 | <div class="section" id="status"> |
66 | <div class="section"> |
| 72 | <h1><a class="toc-backref" href="#id4" name="status">Status</a></h1> |
67 | <h1><a class="toc-backref" href="#id4" id="status" name="status">Status</a></h1> |
| 73 | <p>Due to insufficient resources, the doc team is unable to implement |
68 | <p>Due to insufficient resources, the doc team is unable to implement |
| 74 | this GLEP at this time. It has therefore been marked "deferred".</p> |
69 | this GLEP at this time. It has therefore been marked "deferred".</p> |
| 75 | </div> |
70 | </div> |
| 76 | <div class="section" id="abstract"> |
71 | <div class="section"> |
| 77 | <h1><a class="toc-backref" href="#id5" name="abstract">Abstract:</a></h1> |
72 | <h1><a class="toc-backref" href="#id5" id="abstract" name="abstract">Abstract:</a></h1> |
| 78 | <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 |
| 79 | Gentoo itself. It hosts all documents that the Gentoo Documentation Project |
74 | Gentoo itself. It hosts all documents that the Gentoo Documentation Project |
| 80 | <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 |
| 81 | contains the GWN and its translations and several news items.</p> |
76 | contains the GWN and its translations and several news items.</p> |
| 82 | </div> |
77 | </div> |
| 83 | <div class="section" id="motivation"> |
78 | <div class="section"> |
| 84 | <h1><a class="toc-backref" href="#id6" name="motivation">Motivation:</a></h1> |
79 | <h1><a class="toc-backref" href="#id6" id="motivation" name="motivation">Motivation:</a></h1> |
| 85 | <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 |
| 86 | even the infrastructure team has given positive feedback. However, due |
81 | even the infrastructure team has given positive feedback. However, due |
| 87 | to lack of a good roadmap and proposal this suggestion has never grown |
82 | to lack of a good roadmap and proposal this suggestion has never grown |
| 88 | beyond what it is now: a suggestion. Between the first draft of this |
83 | beyond what it is now: a suggestion. Between the first draft of this |
| 89 | proposal and now some communities grown faster than others. Actually it |
84 | proposal and now some communities grown faster than others. Actually it |
| … | |
… | |
| 94 | point where the lead translator can decide between a small localized |
89 | point where the lead translator can decide between a small localized |
| 95 | site including necessarily translated documents and only some |
90 | site including necessarily translated documents and only some |
| 96 | additional pages and a bigger variant with lots of translated gdp |
91 | additional pages and a bigger variant with lots of translated gdp |
| 97 | documents, translated news and gwn plus additional pages.</p> |
92 | documents, translated news and gwn plus additional pages.</p> |
| 98 | </div> |
93 | </div> |
| 99 | <div class="section" id="rationale"> |
94 | <div class="section"> |
| 100 | <h1><a class="toc-backref" href="#id7" name="rationale">Rationale:</a></h1> |
95 | <h1><a class="toc-backref" href="#id7" id="rationale" name="rationale">Rationale:</a></h1> |
| 101 | <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> |
| 102 | <blockquote> |
97 | <blockquote> |
| 103 | [gentoo]/xml/htdocs/doc/en/* |
98 | [gentoo]/xml/htdocs/doc/en/* |
| 104 | [gentoo]/xml/htdocs/doc/nl/* |
99 | [gentoo]/xml/htdocs/doc/nl/* |
| 105 | [gentoo]/xml/htdocs/doc/fr/*</blockquote> |
100 | [gentoo]/xml/htdocs/doc/fr/*</blockquote> |
| … | |
… | |
| 118 | implementation is advisable. We also can't give access to well-known |
113 | implementation is advisable. We also can't give access to well-known |
| 119 | but non-dev translators.</p> |
114 | but non-dev translators.</p> |
| 120 | <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 |
| 121 | more easily internationalized.</p> |
116 | more easily internationalized.</p> |
| 122 | </div> |
117 | </div> |
| 123 | <div class="section" id="implementation"> |
118 | <div class="section"> |
| 124 | <h1><a class="toc-backref" href="#id8" name="implementation">Implementation:</a></h1> |
119 | <h1><a class="toc-backref" href="#id8" id="implementation" name="implementation">Implementation:</a></h1> |
| 125 | <div class="section" id="website-pages"> |
120 | <div class="section"> |
| 126 | <h2><a class="toc-backref" href="#id9" 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> |
| 127 | <p>The Lead Translator can choose if he wants to maintain a "small" or a |
122 | <p>The Lead Translator can choose if he wants to maintain a "small" or a |
| 128 | "big" localized site. All localized sites will be accessible on |
123 | "big" localized site. All localized sites will be accessible on |
| 129 | <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. |
| 130 | All localized sites must be implemented in GuideXML.</p> |
125 | All localized sites must be implemented in GuideXML.</p> |
| 131 | <div class="section" id="requirements-for-small-localized-sites"> |
126 | <div class="section"> |
| 132 | <h3><a class="toc-backref" href="#id10" name="requirements-for-small-localized-sites">Requirements for "small" 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 "small" localized sites:</a></h3> |
| 133 | <blockquote> |
128 | <blockquote> |
| 134 | <ul class="simple"> |
129 | <ul class="simple"> |
| 135 | <li>all documents marked as required in our Translators Howto</li> |
130 | <li>all documents marked as required in our Translators Howto</li> |
| 136 | <li>$lang/main/translators.xml, listing of all translators (including |
131 | <li>$lang/main/translators.xml, listing of all translators (including |
| 137 | GWN translators)</li> |
132 | GWN translators)</li> |
| … | |
… | |
| 140 | $lang.gentoo.org (i.e. links to documentation, translators.xml and |
135 | $lang.gentoo.org (i.e. links to documentation, translators.xml and |
| 141 | communities.xml)</li> |
136 | communities.xml)</li> |
| 142 | </ul> |
137 | </ul> |
| 143 | </blockquote> |
138 | </blockquote> |
| 144 | </div> |
139 | </div> |
| 145 | <div class="section" id="requirements-for-big-localized-sites"> |
140 | <div class="section"> |
| 146 | <h3><a class="toc-backref" href="#id11" name="requirements-for-big-localized-sites">Requirements for "big" 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 "big" localized sites:</a></h3> |
| 147 | <blockquote> |
142 | <blockquote> |
| 148 | <ul class="simple"> |
143 | <ul class="simple"> |
| 149 | <li>all documents marked as required in our Translators Howto</li> |
144 | <li>all documents marked as required in our Translators Howto</li> |
| 150 | <li>$lang/main/translators.xml, listing of all translators (including |
145 | <li>$lang/main/translators.xml, listing of all translators (including |
| 151 | GWN translators)</li> |
146 | GWN translators)</li> |
| … | |
… | |
| 156 | news items on a per-lang basis aren't allowed)</li> |
151 | news items on a per-lang basis aren't allowed)</li> |
| 157 | </ul> |
152 | </ul> |
| 158 | </blockquote> |
153 | </blockquote> |
| 159 | </div> |
154 | </div> |
| 160 | </div> |
155 | </div> |
| 161 | <div class="section" id="cvs-structure"> |
156 | <div class="section"> |
| 162 | <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> |
| 163 | <p>Actual scheme, everything is relative to [gentoo]/xml/htdocs:</p> |
158 | <p>Actual scheme, everything is relative to [gentoo]/xml/htdocs:</p> |
| 164 | <pre class="literal-block"> |
159 | <pre class="literal-block"> |
| 165 | main/en Contains the main Gentoo Website (about, policy, lists, etc.) |
160 | main/en Contains the main Gentoo Website (about, policy, lists, etc.) |
| 166 | main/$lang Contains some translated Website pages |
161 | main/$lang Contains some translated Website pages |
| 167 | doc/en Contains the master English Documentation |
162 | doc/en Contains the master English Documentation |
| … | |
… | |
| 177 | $lang/doc Contains the translated Documentation |
172 | $lang/doc Contains the translated Documentation |
| 178 | $lang/news Contains translated news items |
173 | $lang/news Contains translated news items |
| 179 | $lang/news/gwn Contains translated GWNs |
174 | $lang/news/gwn Contains translated GWNs |
| 180 | </pre> |
175 | </pre> |
| 181 | </div> |
176 | </div> |
| 182 | <div class="section" id="mail"> |
177 | <div class="section"> |
| 183 | <h2><a class="toc-backref" href="#id13" name="mail">Mail:</a></h2> |
178 | <h2><a class="toc-backref" href="#id13" id="mail" name="mail">Mail:</a></h2> |
| 184 | <p>All mails to <a class="reference" href="mailto:www-$lang@gentoo.org">www-$lang@gentoo.org</a> should be forwarded to the Lead |
179 | <p>All mails to <a class="reference" href="mailto:www-$lang@gentoo.org">www-$lang@gentoo.org</a> should be forwarded to the Lead |
| 185 | Translator and his Follow-Up.</p> |
180 | Translator and his Follow-Up.</p> |
| 186 | </div> |
181 | </div> |
| 187 | <div class="section" id="xsl"> |
182 | <div class="section"> |
| 188 | <h2><a class="toc-backref" href="#id14" name="xsl">XSL:</a></h2> |
183 | <h2><a class="toc-backref" href="#id14" id="xsl" name="xsl">XSL:</a></h2> |
| 189 | <p>We need to "hack" our guide.xsl to support something like inserts.xml for the |
184 | <p>We need to "hack" our guide.xsl to support something like inserts.xml for the |
| 190 | whole site.</p> |
185 | whole site.</p> |
| 191 | <table class="footnote" frame="void" id="gentoo" rules="none"> |
186 | <table class="docutils footnote" frame="void" id="gentoo" rules="none"> |
| 192 | <colgroup><col class="label" /><col /></colgroup> |
187 | <colgroup><col class="label" /><col /></colgroup> |
| 193 | <tbody valign="top"> |
188 | <tbody valign="top"> |
| 194 | <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> |
| 195 | </tbody> |
190 | </tbody> |
| 196 | </table> |
191 | </table> |
| 197 | <table class="footnote" frame="void" id="gdp" rules="none"> |
192 | <table class="docutils footnote" frame="void" id="gdp" rules="none"> |
| 198 | <colgroup><col class="label" /><col /></colgroup> |
193 | <colgroup><col class="label" /><col /></colgroup> |
| 199 | <tbody valign="top"> |
194 | <tbody valign="top"> |
| 200 | <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> |
| 201 | </tbody> |
196 | </tbody> |
| 202 | </table> |
197 | </table> |
| 203 | </div> |
198 | </div> |
| 204 | </div> |
199 | </div> |
| 205 | </div> |
|
|
| 206 | |
200 | |
|
|
201 | </div> |
|
|
202 | <div class="footer"> |
| 207 | <hr class="footer" /> |
203 | <hr class="footer" /> |
| 208 | <div class="footer"> |
|
|
| 209 | <a class="reference" href="glep-0010.txt">View document source</a>. |
204 | <a class="reference" href="glep-0010.txt">View document source</a>. |
| 210 | Generated on: 2004-08-22 13:42 UTC. |
205 | Generated on: 2007-10-13 13:39 UTC. |
| 211 | 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. |
206 | 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. |
|
|
207 | |
| 212 | </div> |
208 | </div> |
| 213 | </body> |
209 | </body> |
| 214 | </html> |
210 | </html> |
| 215 | |
211 | |