/[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.3 - (hide annotations) (download) (as text)
Sun May 2 21:15:23 2004 UTC (10 years, 6 months ago) by g2boojum
Branch: MAIN
Changes since 1.2: +115 -138 lines
File MIME type: text/html
GLEP updates.

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     <meta name="generator" content="Docutils 0.3.0: 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     [<b><a href="http://www.gentoo.org/proj/en/glep/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 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.3 <tr class="field"><th class="field-name">Version:</th><td class="field-body">$Revision: $</td>
37 g2boojum 1.1 </tr>
38 g2boojum 1.3 <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: $</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     <tr class="field"><th class="field-name">Status:</th><td class="field-body">Draft</td>
43     </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.3 <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>
47 g2boojum 1.1 </tr>
48     </tbody>
49     </table>
50     <hr />
51     <div class="contents topic" id="contents">
52     <p class="topic-title"><a name="contents">Contents</a></p>
53     <ul class="simple">
54 g2boojum 1.3 <li><a class="reference" href="#abstract" id="id4" name="id4">Abstract:</a></li>
55     <li><a class="reference" href="#motivation" id="id5" name="id5">Motivation:</a></li>
56     <li><a class="reference" href="#rationale" id="id6" name="id6">Rationale:</a></li>
57     <li><a class="reference" href="#implementation" id="id7" name="id7">Implementation:</a><ul>
58     <li><a class="reference" href="#website-pages" id="id8" name="id8">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>
60     <li><a class="reference" href="#requirements-for-big-localized-sites" id="id10" name="id10">Requirements for &quot;big&quot; localized sites:</a></li>
61     </ul>
62     </li>
63     <li><a class="reference" href="#cvs-structure" id="id11" name="id11">CVS Structure:</a></li>
64     <li><a class="reference" href="#mail" id="id12" name="id12">Mail:</a></li>
65     <li><a class="reference" href="#xsl" id="id13" name="id13">XSL:</a></li>
66 g2boojum 1.1 </ul>
67     </li>
68     </ul>
69     </div>
70     <div class="section" id="abstract">
71 g2boojum 1.3 <h1><a class="toc-backref" href="#id4" 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     Gentoo 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     contains the GWN and its translations and several news items.</p>
76 g2boojum 1.1 </div>
77     <div class="section" id="motivation">
78 g2boojum 1.3 <h1><a class="toc-backref" href="#id5" name="motivation">Motivation:</a></h1>
79     <p>Lots of people have shown interest in the localization proposal, and
80     even the infrastructure team has given positive feedback. However, due
81     to lack of a good roadmap and proposal this suggestion has never grown
82     beyond what it is now: a suggestion. Between the first draft of this
83     proposal and now some communities grown faster than others. Actually it
84     is obvious that we have big communities (lots of users, lots of
85     translators) and smaller communities (less users, less translators). If
86     we speak about localized Gentoo sites we need to find a capable
87     solution for small and even bigger communities. This leads us to a
88     point where the lead translator can decide between a small localized
89     site including necessarily translated documents and only some
90     additional pages and a bigger variant with lots of translated gdp
91     documents, translated news and gwn plus additional pages.</p>
92 g2boojum 1.1 </div>
93     <div class="section" id="rationale">
94 g2boojum 1.3 <h1><a class="toc-backref" href="#id6" name="rationale">Rationale:</a></h1>
95 g2boojum 1.1 <p>The current layout regarding documentation in the CVS is as follows:</p>
96 g2boojum 1.3 <blockquote>
97 g2boojum 1.1 [gentoo]/xml/htdocs/doc/en/*
98     [gentoo]/xml/htdocs/doc/nl/*
99 g2boojum 1.3 [gentoo]/xml/htdocs/doc/fr/*</blockquote>
100     <p>However, there are several other documents (about, policy, etc) in
101     main/$lang:</p>
102     <blockquote>
103 g2boojum 1.1 [gentoo]/xml/htdocs/main/en/*
104     [gentoo]/xml/htdocs/main/nl/*
105 g2boojum 1.3 [gentoo]/xml/htdocs/main/fr/*</blockquote>
106 g2boojum 1.1 <p>This structure makes it very difficult for assigning permissions to the
107 g2boojum 1.3 individual translation teams, and even more difficult to really localize
108 g2boojum 1.1 the Gentoo Website. At this very moment, the translation teams can edit
109     documents of other languages or even the master English documents. English
110     reviewers and editors can touch documents of languages they possibly don't
111 g2boojum 1.3 even know. Although we do trust every single documentation editor, a better
112     implementation is advisable. We also can't give access to well-known
113     but non-dev translators.</p>
114 g2boojum 1.1 <p>We want to restructure the current layout so that the Gentoo Website is
115     more easily internationalized.</p>
116     </div>
117     <div class="section" id="implementation">
118 g2boojum 1.3 <h1><a class="toc-backref" href="#id7" name="implementation">Implementation:</a></h1>
119     <div class="section" id="website-pages">
120     <h2><a class="toc-backref" href="#id8" 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     &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     All localized sites must be implemented in GuideXML.</p>
125     <div class="section" id="requirements-for-small-localized-sites">
126     <h3><a class="toc-backref" href="#id9" name="requirements-for-small-localized-sites">Requirements for &quot;small&quot; localized sites:</a></h3>
127     <blockquote>
128     <ul class="simple">
129     <li>all documents marked as required in our Translators Howto</li>
130     <li>$lang/main/translators.xml, listing of all translators (including
131     GWN translators)</li>
132     <li>$lang/main/communities.xml, listing of all community sites available in $lang</li>
133     <li>index.xml &quot;welcome page&quot;, listing of available ressources on
134     $lang.gentoo.org (i.e. links to documentation, translators.xml and
135     communities.xml)</li>
136     </ul>
137     </blockquote>
138     </div>
139     <div class="section" id="requirements-for-big-localized-sites">
140     <h3><a class="toc-backref" href="#id10" name="requirements-for-big-localized-sites">Requirements for &quot;big&quot; localized sites:</a></h3>
141     <blockquote>
142     <ul class="simple">
143     <li>all documents marked as required in our Translators Howto</li>
144     <li>$lang/main/translators.xml, listing of all translators (including
145     GWN translators)</li>
146     <li>$lang/main/communities.xml, listing of all community sites available in $lang</li>
147     <li>translated $lang/main documents</li>
148     <li>translated $lang/news/gwn</li>
149     <li>translated news items ($lang/news) (only translated news items,
150     news items on a per-lang basis aren't allowed)</li>
151     </ul>
152     </blockquote>
153     </div>
154     </div>
155 g2boojum 1.1 <div class="section" id="cvs-structure">
156 g2boojum 1.3 <h2><a class="toc-backref" href="#id11" name="cvs-structure">CVS Structure:</a></h2>
157     <p>Actual scheme, everything is relative to [gentoo]/xml/htdocs:</p>
158 g2boojum 1.2 <pre class="literal-block">
159 g2boojum 1.3 main/en Contains the main Gentoo Website (about, policy, lists, etc.)
160     main/$lang Contains some translated Website pages
161     doc/en Contains the master English Documentation
162     doc/$lang Contains the translated Documentation
163     news Contains English news items
164     news/en/gwn Contains the master English GWNs
165     news/$lang/gwn Contains translated GWNs
166     proj/en Contains the project Webpages
167 g2boojum 1.1 </pre>
168 g2boojum 1.3 <p>Proposed scheme, relative to [gentoo]/xml/htdocs:</p>
169 g2boojum 1.1 <pre class="literal-block">
170 g2boojum 1.3 $lang/main Contains some translated Website pages
171     $lang/doc Contains the translated Documentation
172     $lang/news Contains translated news items
173     $lang/news/gwn Contains translated GWNs
174 g2boojum 1.1 </pre>
175     </div>
176 g2boojum 1.3 <div class="section" id="mail">
177     <h2><a class="toc-backref" href="#id12" 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     Translator and his Follow-Up.</p>
180     </div>
181     <div class="section" id="xsl">
182     <h2><a class="toc-backref" href="#id13" 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     whole site.</p>
185     <table class="footnote" frame="void" id="gentoo" rules="none">
186 g2boojum 1.1 <colgroup><col class="label" /><col /></colgroup>
187     <tbody valign="top">
188 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>
189 g2boojum 1.1 </tbody>
190     </table>
191 g2boojum 1.3 <table class="footnote" frame="void" id="gdp" 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="#id2" name="gdp">[2]</a></td><td><a class="reference" href="http://gdp.gentoo.org">http://gdp.gentoo.org</a></td></tr>
195 g2boojum 1.1 </tbody>
196     </table>
197     </div>
198     </div>
199     </div>
200    
201     <hr class="footer"/>
202     <div class="footer">
203     <a class="reference" href="glep-0010.txt">View document source</a>.
204 g2boojum 1.3 Generated on: 2004-05-02 21:14 UTC.
205 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.
206     </div>
207     </body>
208     </html>

  ViewVC Help
Powered by ViewVC 1.1.20