Gentoo手册

1.  Gentoo手册的成果

已有的语言

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

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

介绍

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

2.  查看手册

过去发行的版本

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

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安装。

我不同意……

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

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

本文档的内容遵循知识共享-署名-相同方式共享许可协议