Gentoo Archives: gentoo-commits

From: "Le Zhang (r0bertz)" <r0bertz@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] gentoo commit in xml/htdocs/doc/zh_cn/handbook: index.xml
Date: Mon, 10 Mar 2008 19:32:12
Message-Id: E1JYnjF-0005SE-1G@stork.gentoo.org
1 r0bertz 08/03/10 19:32:09
2
3 Modified: index.xml
4 Log:
5 [zh_cn] restore handbook index
6
7 Revision Changes Path
8 1.7 xml/htdocs/doc/zh_cn/handbook/index.xml
9
10 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/zh_cn/handbook/index.xml?rev=1.7&view=markup
11 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/zh_cn/handbook/index.xml?rev=1.7&content-type=text/plain
12 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/zh_cn/handbook/index.xml?r1=1.6&r2=1.7
13
14 Index: index.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/zh_cn/handbook/index.xml,v
17 retrieving revision 1.6
18 retrieving revision 1.7
19 diff -u -r1.6 -r1.7
20 --- index.xml 10 Mar 2008 18:11:56 -0000 1.6
21 +++ index.xml 10 Mar 2008 19:32:08 -0000 1.7
22 @@ -1,61 +1,70 @@
23 <?xml version='1.0' encoding="UTF-8"?>
24 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
25
26 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/zh_cn/handbook/index.xml,v 1.6 2008/03/10 18:11:56 r0bertz Exp $ -->
27 -<!-- English CVS version: 1.13 -->
28 -<guide link="/doc/zh_cn/handbook/2007.0/index.xml" lang="zh_cn">
29 -<title>Gentoo 2007.0无网络安装手册</title>
30 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/zh_cn/handbook/index.xml,v 1.7 2008/03/10 19:32:08 r0bertz Exp $ -->
31 +<!-- English CVS version: 1.72 -->
32 +
33 +<guide link="/doc/zh_cn/handbook/index.xml" lang="zh_cn">
34 +<title>Gentoo手册</title>
35
36 <author title="作者">
37 - <mail link="swift"></mail>
38 + <mail link="swift"/>
39 +</author>
40 +
41 +<author title="译者">
42 + <mail link="joanphan@×××××.com">Hans Joanphan</mail>
43 </author>
44 +
45 <author title="译者">
46 - <mail link="chenjun.shen@×××××.com">沈辰俊</mail>
47 + <mail link="wcw8410@×××××.com">吴传文</mail>
48 </author>
49 +
50 <author title="译者">
51 <mail link="r0bertz@g.o">张乐</mail>
52 </author>
53
54 <abstract>
55 -Gentoo 2007.0无网络安装手册的目的是将文档集中在一个条理分明的手册中。它包括了2007.0发行版本的无网络安装操作指南以及讲述如何使用Gentoo和Portage的章节。
56 +Gentoo手册的目的是将文档集中在一个条理分明的手册中。这份手册包含了基于网络的系统安装指南以及讲述如何使用Gentoo和Portage的章节。
57 </abstract>
58
59 <license/>
60
61 -<version>8.7</version>
62 -<date>2007-06-06</date>
63 +<version>0.47</version>
64 +<date>2007-06-07</date>
65
66 <chapter>
67 -<title>Gentoo Linux 2007.0无网络安装手册</title>
68 -
69 +<title>Gentoo手册的成果</title>
70 <section>
71 -<title>可用语言</title>
72 +<title>已有的语言</title>
73 <body>
74
75 -<p>
76 -Gentoo Linux 2007.0无网络安装手册提供了以下几种语言版本:
77 -</p>
78 +<p>Gentoo手册目前有如下语言版本:</p>
79
80 <p>
81 -<uri link="/doc/en/handbook/2007.0/">英文</uri> |
82 -<uri link="/doc/id/handbook/2007.0/">印度尼西亚文</uri> |
83 -<uri link="/doc/it/handbook/2007.0/">意大利文</uri> |
84 -<uri link="/doc/pl/handbook/2007.0">波兰文</uri> |
85 -<uri link="/doc/zh_cn/handbook/2007.0">简体中文</uri>
86 +<!--<uri link="/doc/pt_br/handbook/">巴西葡萄牙文</uri> |
87 +<uri link="/doc/cs/handbook/">捷克文</uri> |
88 +<uri link="/doc/da/handbook/">Danish </uri> |-->
89 +<uri link="/doc/de/handbook/">德文</uri> |
90 +<uri link="/doc/en/handbook/">英文</uri> |
91 +<uri link="/doc/fr/handbook/">法文</uri> |
92 +<!--<uri link="/doc/id/handbook/">Indonesian</uri> |-->
93 +<uri link="/doc/it/handbook/">意大利文</uri> |
94 +<!--<uri link="/doc/ja/handbook/">日文</uri> |-->
95 +<uri link="/doc/pl/handbook/">波兰文</uri> |
96 +<!--<uri link="/doc/ro/handbook/">罗马尼亚文</uri> |-->
97 +<!--<uri link="/doc/ru/handbook/">俄文</uri> |-->
98 +<uri link="/doc/zh_cn/handbook">简体中文</uri> |
99 +<uri link="/doc/es/handbook/">西班牙文</uri>
100 </p>
101
102 </body>
103 </section>
104 <section>
105 -<title>序言</title>
106 +<title>介绍</title>
107 <body>
108
109 <p>
110 -欢迎您阅读Gentoo Linux 2007.0无网络安装手册。本手册是同Gentoo Linux版本一起发行的,包含了<brite>无网络条件下</brite>安装Gentoo Linux 2007.0所必需的安装操作指南。
111 -</p>
112 -
113 -<p>
114 -而且,如果你想使用最新版本的软件包安装Gentoo Linux,请参考<uri link="/doc/zh_cn/handbook/">Gentoo Linux 手册</uri>中符合你的机器架构的安装操作指南进行安装。
115 +欢迎来到Gentoo手册的主页。这个页面将会告诉你一些Gentoo手册的相关解释,将会回答你绝大多数有关这个手册的问题。我们将谈到手册背后的、当前的状态、以后的打算以及怎样处理报告等。
116 </p>
117
118 </body>
119 @@ -68,48 +77,204 @@
120
121 <table>
122 <tr>
123 - <th>格式</th>
124 + <th>格式 </th>
125 <th>描述</th>
126 <th>链接</th>
127 </tr>
128 <tr>
129 <ti>HTML</ti>
130 - <ti>一页一个章节,适合在线阅读</ti>
131 + <ti>最新版本,每章一页,最适合于在线浏览</ti>
132 <ti>
133 - <uri link="handbook-x86.xml">x86</uri>,
134 + <uri link="handbook-x86.xml">x86</uri>,
135 <uri link="handbook-sparc.xml">sparc</uri>,
136 - <uri link="handbook-amd64.xml">amd64</uri>,
137 - <uri link="handbook-ppc.xml">ppc</uri>,
138 - <uri link="handbook-ppc64.xml">ppc64</uri>,
139 - <uri link="handbook-hppa.xml">hppa</uri>
140 + <uri link="handbook-amd64.xml">amd64</uri>,
141 + <uri link="handbook-ppc.xml">ppc</uri>,
142 + <uri link="handbook-ppc64.xml">ppc64</uri>,
143 + <uri link="handbook-alpha.xml">alpha</uri>,
144 + <uri link="handbook-hppa.xml">hppa</uri>,
145 + <uri link="handbook-mips.xml">mips</uri>,
146 + <uri link="handbook-ia64.xml">ia64</uri>,
147 + <uri link="handbook-arm.xml">arm</uri>
148 </ti>
149 </tr>
150 <tr>
151 <ti>HTML</ti>
152 - <ti>全部在一个页面</ti>
153 + <ti>最新版本,所有内容集中于一页</ti>
154 <ti>
155 - <uri link="handbook-x86.xml?full=1">x86</uri>,
156 - <uri link="handbook-sparc.xml?full=1">sparc</uri>,
157 - <uri link="handbook-amd64.xml?full=1">amd64</uri>,
158 - <uri link="handbook-ppc.xml?full=1">ppc</uri>,
159 - <uri link="handbook-ppc64.xml?full=1">ppc64</uri>,
160 - <uri link="handbook-hppa.xml?full=1">hppa</uri>
161 + <uri link="handbook-x86.xml?full=1">x86</uri>,
162 + <uri link="handbook-sparc.xml?full=1">sparc</uri>,
163 + <uri link="handbook-amd64.xml?full=1">amd64</uri>,
164 + <uri link="handbook-ppc.xml?full=1">ppc</uri>,
165 + <uri link="handbook-ppc64.xml?full=1">ppc64</uri>,
166 + <uri link="handbook-alpha.xml?full=1">alpha</uri>,
167 + <uri link="handbook-hppa.xml?full=1">hppa</uri>,
168 + <uri link="handbook-mips.xml?full=1">mips</uri>,
169 + <uri link="handbook-ia64.xml?full=1">ia64</uri>,
170 + <uri link="handbook-arm.xml?full=1">arm</uri>
171 </ti>
172 </tr>
173 <tr>
174 <ti>HTML</ti>
175 - <ti>全部在一个页面,可打印版本</ti>
176 + <ti>最新版本,所有内容集中于一页,适合打印</ti>
177 <ti>
178 - <uri link="handbook-x86.xml?style=printable&amp;full=1">x86</uri>,
179 - <uri link="handbook-sparc.xml?style=printable&amp;full=1">sparc</uri>,
180 - <uri link="handbook-amd64.xml?style=printable&amp;full=1">amd64</uri>,
181 + <uri link="handbook-x86.xml?style=printable&amp;full=1">x86</uri>,
182 + <uri link="handbook-sparc.xml?style=printable&amp;full=1">sparc</uri>,
183 + <uri link="handbook-amd64.xml?style=printable&amp;full=1">amd64</uri>,
184 <uri link="handbook-ppc.xml?style=printable&amp;full=1">ppc</uri>,
185 - <uri link="handbook-ppc64.xml?style=printable&amp;full=1">ppc64</uri>,
186 - <uri link="handbook-hppa.xml?style=printable&amp;full=1">hppa</uri>
187 + <uri link="handbook-ppc64.xml?style=printable&amp;full=1">ppc64</uri>,
188 + <uri link="handbook-alpha.xml?style=printable&amp;full=1">alpha</uri>,
189 + <uri link="handbook-hppa.xml?style=printable&amp;full=1">hppa</uri>,
190 + <uri link="handbook-mips.xml?style=printable&amp;full=1">mips</uri>,
191 + <uri link="handbook-ia64.xml?style=printable&amp;full=1">ia64</uri>,
192 + <uri link="handbook-arm.xml?style=printable&amp;full=1">arm</uri>
193 + </ti>
194 +</tr>
195 +<tr>
196 + <ti>HTML</ti>
197 + <ti>2007.0无网络安装指南</ti>
198 + <ti>
199 + <uri link="/doc/zh_cn/handbook/2007.0/index.xml">2007.0 Gentoo手册</uri>
200 </ti>
201 </tr>
202 </table>
203
204 +<p>
205 +我们也有基于特定发行版本的手册,它们包含了使用光盘进行<b>无网络</b>安装的安装指南。如果你对无网络安装感兴趣,请参阅<uri link="/doc/zh_cn/handbook/2007.0/index.xml">Gentoo Linux 2007.0手册</uri>。
206 +</p>
207 +
208 +</body>
209 +</section>
210 +<section>
211 +<title>过去发行的版本</title>
212 +<body>
213 +
214 +<p>
215 +由于历史原因,我们也保留了过去版本的手册(自从2006.1以来)。要查看可打印的分页版本请点击右上方的“打印”按钮。如果要看整页模式,在URL后加上<path>?full=1</path>。
216 +</p>
217 +
218 +<warn>
219 +这些手册<e>不</e>再被维护。
220 +</warn>
221 +
222 +<table>
223 +<tr>
224 + <th>发行版本</th>
225 + <th>架构</th>
226 +</tr>
227 +<tr>
228 + <ti>2006.1</ti>
229 + <ti>
230 + <uri link="2006.1/handbook-alpha.xml">alpha</uri>,
231 + <uri link="2006.1/handbook-amd64.xml">amd64</uri>,
232 + <uri link="2006.1/handbook-hppa.xml">hppa</uri>,
233 + <uri link="2006.1/handbook-ppc.xml">ppc</uri>,
234 + <uri link="2006.1/handbook-ppc64.xml">ppc64</uri>,
235 + <uri link="2006.1/handbook-sparc.xml">sparc</uri>,
236 + <uri link="2006.1/handbook-x86.xml">x86</uri>
237 + </ti>
238 +</tr>
239 +</table>
240 +
241 +</body>
242 +</section>
243 +</chapter>
244 +
245 +<chapter>
246 +<title>关于手册的信息</title>
247 +<section>
248 +<title>目标</title>
249 +<body>
250 +
251 +<p>
252 +Gentoo手册的目标是创建一份描述Gentoo Linux各方各面的有条有理的文档。它将已有的几篇指南组合为一篇相连的手册,所以同样的这样一份手册可以用于每一种可能的架构、每一种安装过程和每个用户。这不仅有利于我们的维护,也可以让用户看到这其中的区别是很小的,而其他架构也不会成为一个单独的文档列出来。
253 +</p>
254 +
255 +<p>
256 +这也允许我们对难点进行详细解释并且给出更多的例子。我们再也不会被迫将所有的文档写入一个单独显示的页面,这样读者阅读文档会更加流畅。
257 +</p>
258 +
259 +</body>
260 +</section>
261 +<section>
262 +<title>状态</title>
263 +<body>
264 +
265 +<p>
266 +目前,手册的第四部分<uri link="handbook-x86.xml?part=4">Gentoo网络配置</uri>已经完成并正式发布了。这个部分包含了深入全面的网络配置选项,适合目前稳定的baselayout。
267 +
268 +</p>
269 +
270 +<p>
271 +如果你对手册的开发感兴趣,请使用<mail link="gentoo-doc@g.o">gentoo文档邮件列表</mail>来发布所有的回馈。
272 +</p>
273 +
274 +</body>
275 +</section>
276 +<section>
277 +<title>报告bug和请求改进</title>
278 +<body>
279 +
280 +<p>
281 +如果你发现手册中的一个bug,请访问我们的<uri link="http://bugs.gentoo.org">Gentoo Linux Bugzilla</uri>并给<e>Documentation</e>项目的<e>Installation Handbook</e>模块提交bug报告。
282 +</p>
283 +
284 +</body>
285 +</section>
286 +</chapter>
287 +<chapter id="faq">
288 +<title>常见问题</title>
289 +<section>
290 +<title>难道不能动态地为每个选择创建手册吗?</title>
291 +<body>
292 +
293 +<p>
294 +任何事情都是可能的,但是我们不这样做是基于以下这些原因的。
295 +</p>
296 +
297 +<p>
298 +<b>维护</b>这样的指南将会更困难。不光是因为我们要将bug报告映射到特定的决定(比所有bug报告告诉我们的他们曾经做过的选择更进一步),而且我们将更难顺利地编写这篇指南:我们将不得不更仔细的检查手册中的每一行,以及前后的一致性等等。
299 +</p>
300 +
301 +<p>
302 +虽然我们目前只有在线版本,但<b>其他的格式</b>也将会开发出来,如PDF版本。如果我们要给每个架构、每个选项都创建PDF文件,我们将必须提供大量的PDF文件,但它们之间只有小部分的章节不同。这是对资源的一种浪费 :)。
303 +</p>
304 +
305 +<p>
306 +每个用户作出的决定地方可能<b>彼此不同</b>。这会让用户连打印出这篇手册都很困难——我们首先必须在开始之前告诉用户所有可能的选择,这时很可能他们就已经被吓跑了。
307 +</p>
308 +
309 +<p>
310 +“安装Gentoo”这一部分<b>不是</b>Gentoo手册的唯一部分。它只是手册的第一部分,而接下来的部分不受用户选择的影响。只是为安装指南而动态地创建手册有些杀鸡用牛刀了。
311 +</p>
312 +
313 +<p>
314 +不把每个可能选项的说明分开,用户可以非常方便的看到其他选项的结果。这使得用户可以<b>更好地浏览安装指南</b>。
315 +</p>
316 +
317 +</body>
318 +</section>
319 +<section>
320 +<title>我在Gentoo手册中找不到关于stage1的信息</title>
321 +<body>
322 +
323 +<p>
324 +使用stage1或stage2 tarball的安装指南可以在<uri link="/doc/zh_cn/faq.xml#stage12">Gentoo FAQ</uri>中找到。现在只支持stage3安装。
325 +</p>
326 +
327 +</body>
328 +</section>
329 +<section>
330 +<title>我不同意……</title>
331 +<body>
332 +
333 +<p>
334 +请<uri link="http://bugs.gentoo.org">提交</uri>您的意见;反对但未提出有建设性的反馈并不能解决任何问题。文档是为了整个社区而写的,所以我们很感激大家提出反馈意见。
335 +</p>
336 +
337 +<p>
338 +但是,你必须知道开发文档时所做的大多数决定都是基于大家同意的模型上。编写/组织一个所有人都感到满意的文档是<e>不可能</e>的。我们认为当前的文档实施办法对绝大多数人有益,因此你也应该能够接受。
339 +</p>
340 +
341 </body>
342 </section>
343 </chapter>
344
345
346
347 --
348 gentoo-commits@l.g.o mailing list