/[gentoo]/xml/htdocs/proj/en/glep/glep-0010.txt
Gentoo

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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.3 - (show annotations) (download)
Sun May 2 21:15:23 2004 UTC (9 years, 11 months ago) by g2boojum
Branch: MAIN
Changes since 1.2: +101 -119 lines
File MIME type: text/plain
GLEP updates.

1 GLEP: 10
2 Title: Localized Gentoo Sites
3 Version: $Revision: $
4 Last-Modified: $Date: $
5 Author: Tobias Scherbaum <dertobi123@gentoo.org>, Sven Vermeulen <swift@gentoo.org>
6 Status: Draft
7 Created: 4-Aug-2003
8 Post-History: 4-Aug-2003, 22-Aug-2003, 14-Mar-2004, 2-May-2004
9
10
11 Abstract:
12 =========
13
14 The Gentoo Website [#gentoo]_ is the main source of documentation regarding
15 Gentoo itself. It hosts all documents that the Gentoo Documentation Project
16 [#gdp]_ delivers, including all made translations. In addition the website
17 contains the GWN and its translations and several news items.
18
19
20 Motivation:
21 ===========
22
23 Lots of people have shown interest in the localization proposal, and
24 even the infrastructure team has given positive feedback. However, due
25 to lack of a good roadmap and proposal this suggestion has never grown
26 beyond what it is now: a suggestion. Between the first draft of this
27 proposal and now some communities grown faster than others. Actually it
28 is obvious that we have big communities (lots of users, lots of
29 translators) and smaller communities (less users, less translators). If
30 we speak about localized Gentoo sites we need to find a capable
31 solution for small and even bigger communities. This leads us to a
32 point where the lead translator can decide between a small localized
33 site including necessarily translated documents and only some
34 additional pages and a bigger variant with lots of translated gdp
35 documents, translated news and gwn plus additional pages.
36
37
38 Rationale:
39 ==========
40
41 The current layout regarding documentation in the CVS is as follows:
42
43 [gentoo]/xml/htdocs/doc/en/*
44 [gentoo]/xml/htdocs/doc/nl/*
45 [gentoo]/xml/htdocs/doc/fr/*
46
47 However, there are several other documents (about, policy, etc) in
48 main/$lang:
49
50 [gentoo]/xml/htdocs/main/en/*
51 [gentoo]/xml/htdocs/main/nl/*
52 [gentoo]/xml/htdocs/main/fr/*
53
54 This structure makes it very difficult for assigning permissions to the
55 individual translation teams, and even more difficult to really localize
56 the Gentoo Website. At this very moment, the translation teams can edit
57 documents of other languages or even the master English documents. English
58 reviewers and editors can touch documents of languages they possibly don't
59 even know. Although we do trust every single documentation editor, a better
60 implementation is advisable. We also can't give access to well-known
61 but non-dev translators.
62
63 We want to restructure the current layout so that the Gentoo Website is
64 more easily internationalized.
65
66
67 Implementation:
68 ===============
69
70 Website Pages:
71 --------------
72
73 The Lead Translator can choose if he wants to maintain a "small" or a
74 "big" localized site. All localized sites will be accessible on
75 http://$lang.gentoo.org which will point to [gentoo]xml/htdocs/$lang.
76 All localized sites must be implemented in GuideXML.
77
78 Requirements for "small" localized sites:
79 .........................................
80
81 - all documents marked as required in our Translators Howto
82 - $lang/main/translators.xml, listing of all translators (including
83 GWN translators)
84 - $lang/main/communities.xml, listing of all community sites available in $lang
85 - index.xml "welcome page", listing of available ressources on
86 $lang.gentoo.org (i.e. links to documentation, translators.xml and
87 communities.xml)
88
89 Requirements for "big" localized sites:
90 .......................................
91
92 - all documents marked as required in our Translators Howto
93 - $lang/main/translators.xml, listing of all translators (including
94 GWN translators)
95 - $lang/main/communities.xml, listing of all community sites available in $lang
96 - translated $lang/main documents
97 - translated $lang/news/gwn
98 - translated news items ($lang/news) (only translated news items,
99 news items on a per-lang basis aren't allowed)
100
101
102 CVS Structure:
103 --------------
104
105 Actual scheme, everything is relative to [gentoo]/xml/htdocs::
106
107 main/en Contains the main Gentoo Website (about, policy, lists, etc.)
108 main/$lang Contains some translated Website pages
109 doc/en Contains the master English Documentation
110 doc/$lang Contains the translated Documentation
111 news Contains English news items
112 news/en/gwn Contains the master English GWNs
113 news/$lang/gwn Contains translated GWNs
114 proj/en Contains the project Webpages
115
116 Proposed scheme, relative to [gentoo]/xml/htdocs::
117
118 $lang/main Contains some translated Website pages
119 $lang/doc Contains the translated Documentation
120 $lang/news Contains translated news items
121 $lang/news/gwn Contains translated GWNs
122
123 Mail:
124 -----
125
126 All mails to www-$lang@gentoo.org should be forwarded to the Lead
127 Translator and his Follow-Up.
128
129
130 XSL:
131 ----
132
133 We need to "hack" our guide.xsl to support something like inserts.xml for the
134 whole site.
135
136
137
138 .. [#gentoo] http://www.gentoo.org
139 .. [#gdp] http://gdp.gentoo.org

  ViewVC Help
Powered by ViewVC 1.1.20