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

Parent Directory Parent Directory | Revision Log Revision Log

Revision 1.4 - (show annotations) (download) (as text)
Sun Aug 22 13:57:40 2004 UTC (13 years, 10 months ago) by g2boojum
Branch: MAIN
Changes since 1.3: +35 -29 lines
File MIME type: text/html
glep 10 now deferred

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
8 -->
9 <head>
10 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
11 <meta name="generator" content="Docutils 0.3.3: http://docutils.sourceforge.net/" />
12 <title>GLEP 10 -- Localized Gentoo Sites</title>
13 <link rel="stylesheet" href="tools/glep.css" type="text/css" />
14 </head>
15 <body bgcolor="white">
16 <table class="navigation" cellpadding="0" cellspacing="0"
17 width="100%" border="0">
18 <tr><td class="navicon" width="150" height="35">
19 <a href="http://www.gentoo.org/" title="Gentoo Linux Home Page">
20 <img src="http://www.gentoo.org/images/gentoo-new.gif" alt="[Gentoo]"
21 border="0" width="150" height="35" /></a></td>
22 <td class="textlinks" align="left">
23 [<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>]
25 [<b><a href="./glep-0010.txt">GLEP Source</a></b>]
26 </td></tr></table>
27 <div class="document">
28 <table class="rfc2822 field-list" frame="void" rules="none">
29 <col class="field-name" />
30 <col class="field-body" />
31 <tbody valign="top">
32 <tr class="field"><th class="field-name">GLEP:</th><td class="field-body">10</td>
33 </tr>
34 <tr class="field"><th class="field-name">Title:</th><td class="field-body">Localized Gentoo Sites</td>
35 </tr>
36 <tr class="field"><th class="field-name">Version:</th><td class="field-body">1.4</td>
37 </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>
39 </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>
41 </tr>
42 <tr class="field"><th class="field-name">Status:</th><td class="field-body">deferred</td>
43 </tr>
44 <tr class="field"><th class="field-name">Created:</th><td class="field-body">4-Aug-2003</td>
45 </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>
47 </tr>
48 </tbody>
49 </table>
50 <hr />
51 <div class="contents topic" id="contents">
52 <p class="topic-title first"><a name="contents">Contents</a></p>
53 <ul class="simple">
54 <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>
56 <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>
58 <li><a class="reference" href="#implementation" id="id8" name="id8">Implementation:</a><ul>
59 <li><a class="reference" href="#website-pages" id="id9" name="id9">Website Pages:</a><ul>
60 <li><a class="reference" href="#requirements-for-small-localized-sites" id="id10" name="id10">Requirements for &quot;small&quot; localized sites:</a></li>
61 <li><a class="reference" href="#requirements-for-big-localized-sites" id="id11" name="id11">Requirements for &quot;big&quot; localized sites:</a></li>
62 </ul>
63 </li>
64 <li><a class="reference" href="#cvs-structure" id="id12" name="id12">CVS Structure:</a></li>
65 <li><a class="reference" href="#mail" id="id13" name="id13">Mail:</a></li>
66 <li><a class="reference" href="#xsl" id="id14" name="id14">XSL:</a></li>
67 </ul>
68 </li>
69 </ul>
70 </div>
71 <div class="section" id="status">
72 <h1><a class="toc-backref" href="#id4" name="status">Status</a></h1>
73 <p>Due to insufficient resources, the doc team is unable to implement
74 this GLEP at this time. It has therefore been marked &quot;deferred&quot;.</p>
75 </div>
76 <div class="section" id="abstract">
77 <h1><a class="toc-backref" href="#id5" 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
79 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
81 contains the GWN and its translations and several news items.</p>
82 </div>
83 <div class="section" id="motivation">
84 <h1><a class="toc-backref" href="#id6" name="motivation">Motivation:</a></h1>
85 <p>Lots of people have shown interest in the localization proposal, and
86 even the infrastructure team has given positive feedback. However, due
87 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
89 proposal and now some communities grown faster than others. Actually it
90 is obvious that we have big communities (lots of users, lots of
91 translators) and smaller communities (less users, less translators). If
92 we speak about localized Gentoo sites we need to find a capable
93 solution for small and even bigger communities. This leads us to a
94 point where the lead translator can decide between a small localized
95 site including necessarily translated documents and only some
96 additional pages and a bigger variant with lots of translated gdp
97 documents, translated news and gwn plus additional pages.</p>
98 </div>
99 <div class="section" id="rationale">
100 <h1><a class="toc-backref" href="#id7" name="rationale">Rationale:</a></h1>
101 <p>The current layout regarding documentation in the CVS is as follows:</p>
102 <blockquote>
103 [gentoo]/xml/htdocs/doc/en/*
104 [gentoo]/xml/htdocs/doc/nl/*
105 [gentoo]/xml/htdocs/doc/fr/*</blockquote>
106 <p>However, there are several other documents (about, policy, etc) in
107 main/$lang:</p>
108 <blockquote>
109 [gentoo]/xml/htdocs/main/en/*
110 [gentoo]/xml/htdocs/main/nl/*
111 [gentoo]/xml/htdocs/main/fr/*</blockquote>
112 <p>This structure makes it very difficult for assigning permissions to the
113 individual translation teams, and even more difficult to really localize
114 the Gentoo Website. At this very moment, the translation teams can edit
115 documents of other languages or even the master English documents. English
116 reviewers and editors can touch documents of languages they possibly don't
117 even know. Although we do trust every single documentation editor, a better
118 implementation is advisable. We also can't give access to well-known
119 but non-dev translators.</p>
120 <p>We want to restructure the current layout so that the Gentoo Website is
121 more easily internationalized.</p>
122 </div>
123 <div class="section" id="implementation">
124 <h1><a class="toc-backref" href="#id8" name="implementation">Implementation:</a></h1>
125 <div class="section" id="website-pages">
126 <h2><a class="toc-backref" href="#id9" name="website-pages">Website Pages:</a></h2>
127 <p>The Lead Translator can choose if he wants to maintain a &quot;small&quot; or a
128 &quot;big&quot; 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.
130 All localized sites must be implemented in GuideXML.</p>
131 <div class="section" id="requirements-for-small-localized-sites">
132 <h3><a class="toc-backref" href="#id10" name="requirements-for-small-localized-sites">Requirements for &quot;small&quot; localized sites:</a></h3>
133 <blockquote>
134 <ul class="simple">
135 <li>all documents marked as required in our Translators Howto</li>
136 <li>$lang/main/translators.xml, listing of all translators (including
137 GWN translators)</li>
138 <li>$lang/main/communities.xml, listing of all community sites available in $lang</li>
139 <li>index.xml &quot;welcome page&quot;, listing of available ressources on
140 $lang.gentoo.org (i.e. links to documentation, translators.xml and
141 communities.xml)</li>
142 </ul>
143 </blockquote>
144 </div>
145 <div class="section" id="requirements-for-big-localized-sites">
146 <h3><a class="toc-backref" href="#id11" name="requirements-for-big-localized-sites">Requirements for &quot;big&quot; localized sites:</a></h3>
147 <blockquote>
148 <ul class="simple">
149 <li>all documents marked as required in our Translators Howto</li>
150 <li>$lang/main/translators.xml, listing of all translators (including
151 GWN translators)</li>
152 <li>$lang/main/communities.xml, listing of all community sites available in $lang</li>
153 <li>translated $lang/main documents</li>
154 <li>translated $lang/news/gwn</li>
155 <li>translated news items ($lang/news) (only translated news items,
156 news items on a per-lang basis aren't allowed)</li>
157 </ul>
158 </blockquote>
159 </div>
160 </div>
161 <div class="section" id="cvs-structure">
162 <h2><a class="toc-backref" href="#id12" name="cvs-structure">CVS Structure:</a></h2>
163 <p>Actual scheme, everything is relative to [gentoo]/xml/htdocs:</p>
164 <pre class="literal-block">
165 main/en Contains the main Gentoo Website (about, policy, lists, etc.)
166 main/$lang Contains some translated Website pages
167 doc/en Contains the master English Documentation
168 doc/$lang Contains the translated Documentation
169 news Contains English news items
170 news/en/gwn Contains the master English GWNs
171 news/$lang/gwn Contains translated GWNs
172 proj/en Contains the project Webpages
173 </pre>
174 <p>Proposed scheme, relative to [gentoo]/xml/htdocs:</p>
175 <pre class="literal-block">
176 $lang/main Contains some translated Website pages
177 $lang/doc Contains the translated Documentation
178 $lang/news Contains translated news items
179 $lang/news/gwn Contains translated GWNs
180 </pre>
181 </div>
182 <div class="section" id="mail">
183 <h2><a class="toc-backref" href="#id13" name="mail">Mail:</a></h2>
184 <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
185 Translator and his Follow-Up.</p>
186 </div>
187 <div class="section" id="xsl">
188 <h2><a class="toc-backref" href="#id14" name="xsl">XSL:</a></h2>
189 <p>We need to &quot;hack&quot; our guide.xsl to support something like inserts.xml for the
190 whole site.</p>
191 <table class="footnote" frame="void" id="gentoo" rules="none">
192 <colgroup><col class="label" /><col /></colgroup>
193 <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>
195 </tbody>
196 </table>
197 <table class="footnote" frame="void" id="gdp" rules="none">
198 <colgroup><col class="label" /><col /></colgroup>
199 <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>
201 </tbody>
202 </table>
203 </div>
204 </div>
205 </div>
207 <hr class="footer" />
208 <div class="footer">
209 <a class="reference" href="glep-0010.txt">View document source</a>.
210 Generated on: 2004-08-22 13:42 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.
212 </div>
213 </body>
214 </html>

  ViewVC Help
Powered by ViewVC 1.1.20