/[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.4 - (hide annotations) (download) (as text)
Sun Aug 22 13:57:40 2004 UTC (9 years, 11 months ago) by g2boojum
Branch: MAIN
Changes since 1.3: +35 -29 lines
File MIME type: text/html
glep 10 now deferred

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.4 <meta name="generator" content="Docutils 0.3.3: http://docutils.sourceforge.net/" />
12 g2boojum 1.3 <title>GLEP 10 -- Localized Gentoo Sites</title>
13 g2boojum 1.1 <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 g2boojum 1.4 [<b><a href="./glep-0010.txt">GLEP Source</a></b>]
26 g2boojum 1.1 </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 g2boojum 1.3 <tr class="field"><th class="field-name">Title:</th><td class="field-body">Localized Gentoo Sites</td>
35 g2boojum 1.1 </tr>
36 g2boojum 1.4 <tr class="field"><th class="field-name">Version:</th><td class="field-body">1.4</td>
37 g2boojum 1.1 </tr>
38 g2boojum 1.4 <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 g2boojum 1.1 </tr>
40 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>
41 g2boojum 1.1 </tr>
42 g2boojum 1.4 <tr class="field"><th class="field-name">Status:</th><td class="field-body">deferred</td>
43 g2boojum 1.1 </tr>
44 g2boojum 1.3 <tr class="field"><th class="field-name">Created:</th><td class="field-body">4-Aug-2003</td>
45 g2boojum 1.1 </tr>
46 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>
47 g2boojum 1.1 </tr>
48     </tbody>
49     </table>
50     <hr />
51     <div class="contents topic" id="contents">
52 g2boojum 1.4 <p class="topic-title first"><a name="contents">Contents</a></p>
53 g2boojum 1.1 <ul class="simple">
54 g2boojum 1.4 <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 g2boojum 1.3 </ul>
63     </li>
64 g2boojum 1.4 <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 g2boojum 1.1 </ul>
68     </li>
69     </ul>
70     </div>
71 g2boojum 1.4 <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 g2boojum 1.1 <div class="section" id="abstract">
77 g2boojum 1.4 <h1><a class="toc-backref" href="#id5" name="abstract">Abstract:</a></h1>
78 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
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 g2boojum 1.1 </div>
83     <div class="section" id="motivation">
84 g2boojum 1.4 <h1><a class="toc-backref" href="#id6" name="motivation">Motivation:</a></h1>
85 g2boojum 1.3 <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 g2boojum 1.1 </div>
99     <div class="section" id="rationale">
100 g2boojum 1.4 <h1><a class="toc-backref" href="#id7" name="rationale">Rationale:</a></h1>
101 g2boojum 1.1 <p>The current layout regarding documentation in the CVS is as follows:</p>
102 g2boojum 1.3 <blockquote>
103 g2boojum 1.1 [gentoo]/xml/htdocs/doc/en/*
104     [gentoo]/xml/htdocs/doc/nl/*
105 g2boojum 1.3 [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 g2boojum 1.1 [gentoo]/xml/htdocs/main/en/*
110     [gentoo]/xml/htdocs/main/nl/*
111 g2boojum 1.3 [gentoo]/xml/htdocs/main/fr/*</blockquote>
112 g2boojum 1.1 <p>This structure makes it very difficult for assigning permissions to the
113 g2boojum 1.3 individual translation teams, and even more difficult to really localize
114 g2boojum 1.1 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 g2boojum 1.3 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 g2boojum 1.1 <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 g2boojum 1.4 <h1><a class="toc-backref" href="#id8" name="implementation">Implementation:</a></h1>
125 g2boojum 1.3 <div class="section" id="website-pages">
126 g2boojum 1.4 <h2><a class="toc-backref" href="#id9" name="website-pages">Website Pages:</a></h2>
127 g2boojum 1.3 <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 g2boojum 1.4 <h3><a class="toc-backref" href="#id10" name="requirements-for-small-localized-sites">Requirements for &quot;small&quot; localized sites:</a></h3>
133 g2boojum 1.3 <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 g2boojum 1.4 <h3><a class="toc-backref" href="#id11" name="requirements-for-big-localized-sites">Requirements for &quot;big&quot; localized sites:</a></h3>
147 g2boojum 1.3 <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 g2boojum 1.1 <div class="section" id="cvs-structure">
162 g2boojum 1.4 <h2><a class="toc-backref" href="#id12" name="cvs-structure">CVS Structure:</a></h2>
163 g2boojum 1.3 <p>Actual scheme, everything is relative to [gentoo]/xml/htdocs:</p>
164 g2boojum 1.2 <pre class="literal-block">
165 g2boojum 1.3 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 g2boojum 1.1 </pre>
174 g2boojum 1.3 <p>Proposed scheme, relative to [gentoo]/xml/htdocs:</p>
175 g2boojum 1.1 <pre class="literal-block">
176 g2boojum 1.3 $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 g2boojum 1.1 </pre>
181     </div>
182 g2boojum 1.3 <div class="section" id="mail">
183 g2boojum 1.4 <h2><a class="toc-backref" href="#id13" name="mail">Mail:</a></h2>
184 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
185     Translator and his Follow-Up.</p>
186     </div>
187     <div class="section" id="xsl">
188 g2boojum 1.4 <h2><a class="toc-backref" href="#id14" name="xsl">XSL:</a></h2>
189 g2boojum 1.3 <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 g2boojum 1.1 <colgroup><col class="label" /><col /></colgroup>
193     <tbody valign="top">
194 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>
195 g2boojum 1.1 </tbody>
196     </table>
197 g2boojum 1.3 <table class="footnote" frame="void" id="gdp" rules="none">
198 g2boojum 1.1 <colgroup><col class="label" /><col /></colgroup>
199     <tbody valign="top">
200 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>
201 g2boojum 1.1 </tbody>
202     </table>
203     </div>
204     </div>
205     </div>
206    
207 g2boojum 1.4 <hr class="footer" />
208 g2boojum 1.1 <div class="footer">
209     <a class="reference" href="glep-0010.txt">View document source</a>.
210 g2boojum 1.4 Generated on: 2004-08-22 13:42 UTC.
211 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.
212     </div>
213     </body>
214     </html>

  ViewVC Help
Powered by ViewVC 1.1.20