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

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 <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="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 <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">$Revision: $</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.cgi/xml/htdocs/proj/en/glep/glep-0010.txt?cvsroot=gentoo">$Date: $</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">Draft</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</td>
47 </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 <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 </ul>
67 </li>
68 </ul>
69 </div>
70 <div class="section" id="abstract">
71 <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 </div>
77 <div class="section" id="motivation">
78 <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 </div>
93 <div class="section" id="rationale">
94 <h1><a class="toc-backref" href="#id6" name="rationale">Rationale:</a></h1>
95 <p>The current layout regarding documentation in the CVS is as follows:</p>
96 <blockquote>
97 [gentoo]/xml/htdocs/doc/en/*
98 [gentoo]/xml/htdocs/doc/nl/*
99 [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 [gentoo]/xml/htdocs/main/en/*
104 [gentoo]/xml/htdocs/main/nl/*
105 [gentoo]/xml/htdocs/main/fr/*</blockquote>
106 <p>This structure makes it very difficult for assigning permissions to the
107 individual translation teams, and even more difficult to really localize
108 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 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 <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 <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 <div class="section" id="cvs-structure">
156 <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 <pre class="literal-block">
159 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 </pre>
168 <p>Proposed scheme, relative to [gentoo]/xml/htdocs:</p>
169 <pre class="literal-block">
170 $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 </pre>
175 </div>
176 <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 <colgroup><col class="label" /><col /></colgroup>
187 <tbody valign="top">
188 <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 </tbody>
190 </table>
191 <table class="footnote" frame="void" id="gdp" rules="none">
192 <colgroup><col class="label" /><col /></colgroup>
193 <tbody valign="top">
194 <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 </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 Generated on: 2004-05-02 21:14 UTC.
205 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