Gentoo Logo

Gentoo手册

内容:

1.  Gentoo手册的成果

已有的语言

Gentoo手册目前有如下语言版本:

德文 | 英文 | 法文 | 意大利文 | 日文 | 波兰文 | 简体中文 西班牙文

介绍

欢迎来到Gentoo手册的主页。这个页面将会告诉你一些Gentoo手册的相关解释,将会回答你绝大多数有关这个手册的问题。我们将谈到手册背后的、当前的状态、以后的打算以及怎样处理报告等。

2.  查看手册

格式 描述 链接
HTML 最新版本,每章一页,最适合于在线浏览 x86, sparc, amd64, ppc, ppc64, alpha, hppa, mips, ia64, arm
HTML 最新版本,所有内容集中于一页 x86, sparc, amd64, ppc, ppc64, alpha, hppa, mips, ia64, arm
HTML 最新版本,所有内容集中于一页,适合打印 x86, sparc, amd64, ppc, ppc64, alpha, hppa, mips, ia64, arm

过去发行的版本

由于历史原因,我们也保留了过去版本的手册(自从2006.1以来)。要查看可打印的分页版本请点击右上方的“打印”按钮。如果要看整页模式,在URL后加上?full=1

警告: 这些手册再被维护。

发行版本 架构
2006.1 alpha, amd64, hppa, ppc, ppc64, sparc, x86
2007.0 amd64, hppa, ppc, ppc64, sparc, x86
2008.0 amd64, hppa, ppc, ppc64, sparc, x86

3.  关于手册的信息

目标

Gentoo手册的目标是创建一份描述Gentoo Linux各方各面的有条有理的文档。它将已有的几篇指南组合为一篇相连的手册,所以同样的这样一份手册可以用于每一种可能的架构、每一种安装过程和每个用户。这不仅有利于我们的维护,也可以让用户看到这其中的区别是很小的,而其他架构也不会成为一个单独的文档列出来。

这也允许我们对难点进行详细解释并且给出更多的例子。我们再也不会被迫将所有的文档写入一个单独显示的页面,这样读者阅读文档会更加流畅。

状态

目前,手册的第四部分Gentoo网络配置已经完成并正式发布了。这个部分包含了深入全面的网络配置选项,适合目前稳定的baselayout。

如果你对手册的开发感兴趣,请使用gentoo文档邮件列表来发布所有的回馈。

报告bug和请求改进

如果你发现手册中的一个bug,请访问我们的Gentoo Linux Bugzilla并给Documentation项目的Installation Handbook模块提交bug报告。

4.  常见问题

难道不能动态地为每个选择创建手册吗?

任何事情都是可能的,但是我们不这样做是基于以下这些原因的。

维护这样的指南将会更困难。不光是因为我们要将bug报告映射到特定的决定(比所有bug报告告诉我们的他们曾经做过的选择更进一步),而且我们将更难顺利地编写这篇指南:我们将不得不更仔细的检查手册中的每一行,以及前后的一致性等等。

虽然我们目前只有在线版本,但其他的格式也将会开发出来,如PDF版本。如果我们要给每个架构、每个选项都创建PDF文件,我们将必须提供大量的PDF文件,但它们之间只有小部分的章节不同。这是对资源的一种浪费 :)。

每个用户作出的决定地方可能彼此不同。这会让用户连打印出这篇手册都很困难——我们首先必须在开始之前告诉用户所有可能的选择,这时很可能他们就已经被吓跑了。

“安装Gentoo”这一部分不是Gentoo手册的唯一部分。它只是手册的第一部分,而接下来的部分不受用户选择的影响。只是为安装指南而动态地创建手册有些杀鸡用牛刀了。

不把每个可能选项的说明分开,用户可以非常方便的看到其他选项的结果。这使得用户可以更好地浏览安装指南

我在Gentoo手册中找不到关于stage1的信息

使用stage1或stage2 tarball的安装指南可以在Gentoo FAQ中找到。现在只支持stage3安装。

我不同意……

提交您的意见;反对但未提出有建设性的反馈并不能解决任何问题。文档是为了整个社区而写的,所以我们很感激大家提出反馈意见。

但是,你必须知道开发文档时所做的大多数决定都是基于大家同意的模型上。编写/组织一个所有人都感到满意的文档是不可能的。我们认为当前的文档实施办法对绝大多数人有益,因此你也应该能够接受。



打印

更新于2009年 7月 11日

总结: Gentoo手册的目的是将文档集中在一个条理分明的手册中。这份手册包含了基于网络的系统安装指南以及讲述如何使用Gentoo和Portage的章节。

Sven Vermeulen
作者

Hans Joanphan
译者

吴传文
译者

张乐
译者

Donate to support our development efforts.

Support OSL
Gentoo Centric Hosting: vr.org
Tek Alchemy
SevenL.net
Global Netoptex Inc.
Bytemark
Edurium
Copyright 2001-2010 Gentoo Foundation, Inc. Questions, Comments? Contact us.