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

Parent Directory Parent Directory | Revision Log Revision Log

Revision 1.7 - (show annotations) (download) (as text)
Sun Oct 14 17:00:15 2007 UTC (10 years, 8 months ago) by antarus
Branch: MAIN
Changes since 1.6: +4 -251 lines
File MIME type: text/html
the canary on 53 went well, changing the rest

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">
5 <head>
6 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
7 <meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" />
8 <title>GLEP 10 -- Localized Gentoo Sites</title>
9 <link rel="stylesheet" href="tools/glep.css" type="text/css" />
10 </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 [<b><a href="http://www.gentoo.org/proj/en/glep">GLEP Index</a></b>]
21 [<b><a href="http://www.gentoo.org/proj/en/glep/glep-0010.txt">GLEP Source</a></b>]
22 </td></tr></table>
23 <table class="rfc2822 docutils field-list" frame="void" rules="none">
24 <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 <tr class="field"><th class="field-name">Title:</th><td class="field-body">Localized Gentoo Sites</td>
30 </tr>
31 <tr class="field"><th class="field-name">Version:</th><td class="field-body">1.4</td>
32 </tr>
33 <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 </tr>
35 <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 </tr>
37 <tr class="field"><th class="field-name">Status:</th><td class="field-body">deferred</td>
38 </tr>
39 <tr class="field"><th class="field-name">Created:</th><td class="field-body">4-Aug-2003</td>
40 </tr>
41 <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 </tr>
43 </tbody>
44 </table>
45 <hr />
46 <div class="contents topic">
47 <p class="topic-title first"><a id="contents" name="contents">Contents</a></p>
48 <ul class="simple">
49 <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 </ul>
58 </li>
59 <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 </ul>
63 </li>
64 </ul>
65 </div>
66 <div class="section">
67 <h1><a class="toc-backref" href="#id4" id="status" name="status">Status</a></h1>
68 <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 <div class="section">
72 <h1><a class="toc-backref" href="#id5" id="abstract" name="abstract">Abstract:</a></h1>
73 <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 </div>
78 <div class="section">
79 <h1><a class="toc-backref" href="#id6" id="motivation" name="motivation">Motivation:</a></h1>
80 <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 </div>
94 <div class="section">
95 <h1><a class="toc-backref" href="#id7" id="rationale" name="rationale">Rationale:</a></h1>
96 <p>The current layout regarding documentation in the CVS is as follows:</p>
97 <blockquote>
98 [gentoo]/xml/htdocs/doc/en/*
99 [gentoo]/xml/htdocs/doc/nl/*
100 [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 [gentoo]/xml/htdocs/main/en/*
105 [gentoo]/xml/htdocs/main/nl/*
106 [gentoo]/xml/htdocs/main/fr/*</blockquote>
107 <p>This structure makes it very difficult for assigning permissions to the
108 individual translation teams, and even more difficult to really localize
109 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 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 <p>We want to restructure the current layout so that the Gentoo Website is
116 more easily internationalized.</p>
117 </div>
118 <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 <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 <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 <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 <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 <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 <div class="section">
157 <h2><a class="toc-backref" href="#id12" id="cvs-structure" name="cvs-structure">CVS Structure:</a></h2>
158 <p>Actual scheme, everything is relative to [gentoo]/xml/htdocs:</p>
159 <pre class="literal-block">
160 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 </pre>
169 <p>Proposed scheme, relative to [gentoo]/xml/htdocs:</p>
170 <pre class="literal-block">
171 $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 </pre>
176 </div>
177 <div class="section">
178 <h2><a class="toc-backref" href="#id13" id="mail" name="mail">Mail:</a></h2>
179 <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 <div class="section">
183 <h2><a class="toc-backref" href="#id14" id="xsl" name="xsl">XSL:</a></h2>
184 <p>We need to &quot;hack&quot; our guide.xsl to support something like inserts.xml for the
185 whole site.</p>
186 <table class="docutils footnote" frame="void" id="gentoo" rules="none">
187 <colgroup><col class="label" /><col /></colgroup>
188 <tbody valign="top">
189 <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 </tbody>
191 </table>
192 <table class="docutils footnote" frame="void" id="gdp" rules="none">
193 <colgroup><col class="label" /><col /></colgroup>
194 <tbody valign="top">
195 <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 </tbody>
197 </table>
198 </div>
199 </div>
201 </div>
202 <div class="footer">
203 <hr class="footer" />
204 <a class="reference" href="glep-0010.txt">View document source</a>.
205 Generated on: 2007-10-13 13:39 UTC.
206 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.
208 </div>
209 </body>
210 </html>

  ViewVC Help
Powered by ViewVC 1.1.20