/[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.7 - (hide annotations) (download) (as text)
Sun Oct 14 17:00:15 2007 UTC (6 years, 11 months ago) by antarus
Branch: MAIN
CVS Tags: HEAD
Changes since 1.6: +4 -251 lines
File MIME type: text/html
the canary on 53 went well, changing the rest

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

  ViewVC Help
Powered by ViewVC 1.1.20