[gentoo-commits] gentoo commit in xml/htdocs/doc/zh_cn: alsa-guide.xml gentoo-x86-quickinstall.xml gnome-config.xml gpm.xml grub-error-guide.xml lvm2.xml metadoc.xml mysql-upgrading.xml nano-basics-guide.xml nano-guide.xml portage-utils.xml vdr-guide.xml xfce-config.xml

[Le Zhang (r0bertz)]

r0bertz     07/09/17 17:54:10

  Modified:             metadoc.xml
  Added:                alsa-guide.xml gentoo-x86-quickinstall.xml
                        gnome-config.xml gpm.xml grub-error-guide.xml
                        lvm2.xml mysql-upgrading.xml nano-basics-guide.xml
                        portage-utils.xml vdr-guide.xml xfce-config.xml
  Removed:              nano-guide.xml
  Log:
  add alsa-guide.xml gentoo-x86-quickinstall.xml gnome-config.xml gpm.xml grub-error-guide.xml lvm2.xml mysql-upgrading.xml nano-basics-guide.xml portage-utils.xml vdr-guide.xml xfce-config.xml

Revision  Changes    Path
1.5                  xml/htdocs/doc/zh_cn/metadoc.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/zh_cn/metadoc.xml?rev=1.5&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/zh_cn/metadoc.xml?rev=1.5&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/zh_cn/metadoc.xml?r1=1.4&r2=1.5

Index: metadoc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/zh_cn/metadoc.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- metadoc.xml	16 Sep 2007 18:21:32 -0000	1.4
+++ metadoc.xml	17 Sep 2007 17:54:10 -0000	1.5
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE metadoc SYSTEM "/dtd/metadoc.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/zh_cn/metadoc.xml,v 1.4 2007/09/16 18:21:32 r0bertz Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/zh_cn/metadoc.xml,v 1.5 2007/09/17 17:54:10 r0bertz Exp $ -->
 <!-- English CVS version: 1.192 -->
 
 <metadoc lang="zh_cn" parent="/doc/en/metadoc.xml">
@@ -226,10 +226,10 @@
     <file id="2007.0-hb-install-gli-medium">/doc/zh_cn/handbook/2007.0/hb-install-gli-medium.xml</file>
     <file id="2007.0-hb-install-gtkfe">/doc/zh_cn/handbook/2007.0/hb-install-gtkfe.xml</file>
     <file id="2007.0-index">/doc/zh_cn/handbook/2007.0/index.xml</file>
-    <file id="lvm2">/doc/en/lvm2.xml</file>
+    <file id="lvm2">/doc/zh_cn/lvm2.xml</file>
     <file id="gentoo-kernel">/doc/en/gentoo-kernel.xml</file>
     <file id="gentoo-ppc-faq">/doc/en/gentoo-ppc-faq.xml</file>
-    <file id="alsa-guide">/doc/en/alsa-guide.xml</file>
+    <file id="alsa-guide">/doc/zh_cn/alsa-guide.xml</file>
     <file id="xorg-config">/doc/en/xorg-config.xml</file>
     <file id="quick-samba-howto">/doc/en/quick-samba-howto.xml</file>
     <file id="ltsp">/doc/en/ltsp.xml</file>
@@ -243,9 +243,9 @@
     <file id="java">/doc/en/java.xml</file>
     <file id="openafs">/doc/en/openafs.xml</file>
     <file id="kde-config">/doc/en/kde-config.xml</file>
-    <file id="nano-basics-guide">/doc/en/nano-basics-guide.xml</file>
+    <file id="nano-basics-guide">/doc/zh_cn/nano-basics-guide.xml</file>
     <file id="shoutcast-config">/doc/en/shoutcast-config.xml</file>
-    <file id="vdr-guide">/doc/en/vdr-guide.xml</file>
+    <file id="vdr-guide">/doc/zh_cn/vdr-guide.xml</file>
     <file id="xml-guide">/doc/en/xml-guide.xml</file>
     <file id="diskless-howto">/doc/en/diskless-howto.xml</file>
     <file id="prelink-howto">/doc/en/prelink-howto.xml</file>
@@ -254,7 +254,7 @@
     <file id="qmail-howto">/doc/en/qmail-howto.xml</file>
     <file id="source_mirrors">/doc/en/source_mirrors.xml</file>
     <file id="gentoo-ppc-install">/doc/en/gentoo-ppc-install.xml</file>
-    <file id="gentoo-x86-quickinstall">/doc/en/gentoo-x86-quickinstall.xml</file>
+    <file id="gentoo-x86-quickinstall">/doc/zh_cn/gentoo-x86-quickinstall.xml</file>
     <file id="gentoo-x86-quickinstall+raid">/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml</file>
     <file id="vi-guide">/doc/en/vi-guide.xml</file>
     <file id="virt-mail-howto">/doc/en/virt-mail-howto.xml</file>
@@ -271,15 +271,15 @@
     <file id="gentoo-x86-tipsntricks">/doc/en/gentoo-x86-tipsntricks.xml</file>
     <file id="gentoo-sparc-netboot-howto">/doc/en/gentoo-sparc-netboot-howto.xml</file>
     <file id="gentoo-sparc-obpreference">/doc/en/gentoo-sparc-obpreference.xml</file>
-    <file id="gnome-config">/doc/en/gnome-config.xml</file>
+    <file id="gnome-config">/doc/zh_cn/gnome-config.xml</file>
     <file id="gnome-upgrade">/proj/en/desktop/gnome/howtos/gnome-2.18-upgrade.xml</file>
-    <file id="gpm">/doc/en/gpm.xml</file>
+    <file id="gpm">/doc/zh_cn/gpm.xml</file>
     <file id="gentoo-security">/doc/en/gentoo-security.xml</file>
     <file id="home-router-howto">/doc/en/home-router-howto.xml</file>
     <file id="arm-requirements">/doc/en/arm-requirements.xml</file>
     <file id="power-management-guide">/doc/en/power-management-guide.xml</file>
     <file id="new-upgrade-to-gentoo-1.4">/doc/en/new-upgrade-to-gentoo-1.4.xml</file>
-    <file id="portage-utils">/doc/en/portage-utils.xml</file>
+    <file id="portage-utils">/doc/zh_cn/portage-utils.xml</file>
     <file id="amd64-howtos">/proj/en/base/amd64/howtos/index.xml</file>
     <file id="amd64-howtos-bugs">/proj/en/base/amd64/howtos/bugs.xml</file>
     <file id="amd64-howtos-chroot">/proj/en/base/amd64/howtos/chroot-old.xml</file>
@@ -343,7 +343,7 @@
     <file id="hpc-howto">/doc/en/hpc-howto.xml</file>
     <file id="gnap-userguide">/proj/en/base/embedded/gnap-userguide.xml</file>
     <file id="kde-split-ebuilds">/doc/en/kde-split-ebuilds.xml</file>
-    <file id="grub-error-guide">/doc/en/grub-error-guide.xml</file>
+    <file id="grub-error-guide">/doc/zh_cn/grub-error-guide.xml</file>
     <file id="usb-guide">/doc/en/usb-guide.xml</file>
     <file id="liveusb">/doc/en/liveusb.xml</file>
     <file id="fluxbox-config">/doc/en/fluxbox-config.xml</file>
@@ -370,7 +370,7 @@
     <file id="sudo-guide">/doc/en/sudo-guide.xml</file>
     <file id="freebsd-guide">/doc/en/gentoo-freebsd.xml</file>
     <file id="mips-faq">/doc/en/gentoo-mips-faq.xml</file>
-    <file id="mysql-upgrading">/doc/en/mysql-upgrading.xml</file>
+    <file id="mysql-upgrading">/doc/zh_cn/mysql-upgrading.xml</file>
     <file id="mysql-upgrade-slotted">/doc/en/mysql-upgrade-slotted.xml</file>
     <file id="gcc-upgrading">/doc/en/gcc-upgrading.xml</file>
     <file id="x86-at-faq">/proj/en/base/x86/arch-testers-faq.xml</file>
@@ -384,7 +384,7 @@
     <file id="kernel-config">/doc/en/kernel-config.xml</file>
     <file id="zsh">/doc/en/zsh.xml</file>
     <file id="change-chost">/doc/en/change-chost.xml</file>
-    <file id="xfce-config">/doc/en/xfce-config.xml</file>
+    <file id="xfce-config">/doc/zh_cn/xfce-config.xml</file>
     <file id="gcc-optimization">/doc/en/gcc-optimization.xml</file>
     <file id="vpnc-howto">/doc/en/vpnc-howto.xml</file>
     <file id="qa-autofailure">/proj/en/qa/autofailure.xml</file>



1.1                  xml/htdocs/doc/zh_cn/alsa-guide.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/zh_cn/alsa-guide.xml?rev=1.1&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/zh_cn/alsa-guide.xml?rev=1.1&content-type=text/plain

Index: alsa-guide.xml
===================================================================
<?xml version='1.0' encoding="utf-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">

<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/zh_cn/alsa-guide.xml,v 1.1 2007/09/17 17:54:10 r0bertz Exp $ -->
<!-- English CVS version: 1.80 -->

<guide link="/doc/zh_cn/alsa-guide.xml" lang="zh_cn">
<title>Gentoo Linux ALSA指南</title>

<author title="作者">
  <mail link="fox2mike@g.o">Shyam Mani</mail>
</author>
<author title="作者">
  <mail link="nightmorph@g.o">Joshua Saddler</mail>
</author>
<author title="贡献者">
  <mail link="flameeyes@g.o">Diego Pettenò</mail>
</author>
<author title="译者">
  <mail link="kunxi@×××××.org">奚焜</mail>
</author>

<abstract>
本文档可以帮助用户在Gentoo Linux上设置ALSA
</abstract>

<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>

<version>2.22</version>
<date>2007-05-07</date>

<chapter>
<title>简介</title>
<section>
<title>什么是ALSA?</title>
<body>

<p>
ALSA是<e>Advanced Linux Sound Architecture，高级Linux声音架构</e>的简称,它在Linux操作系统上提供了音频和MIDI（<e>Musical Instrument Digital Interface</e>，音乐设备数字化接口）的支持。在2.6系列内核中，ALSA已经成为默认的声音子系统，用来替换2.4系列内核中的OSS（<e>Open Sound System</e>，开放声音系统）。
</p>

<p>
ALSA的主要特性包括：高效地支持从消费类入门级声卡到专业级音频设备所有类型的音频接口，完全模块化的设计， 支持对称多处理（SMP）和线程安全，对OSS的向后兼容，以及提供了用户空间的<c>alsa-lib</c>库来简化应用程序的开发。
</p>

</body>
</section>
<section>
<title>Gentoo上的ALSA</title>
<body>

<p>
Gentoo的一个主要优势在于用户可以最大限度的控制如何安装和配置系统。Gentoo上的ALSA秉承了同样的原则。有两种方法可以使ALSA运行在您的系统上。我们将在下一章分别予以详细讨论。
</p>

</body>
</section>
</chapter>

<chapter>
<title>安装ALSA</title>
<section>
<title>可选</title>
<body>

<warn>
下述方法是互斥的，您不能够将ALSA编入内核，同时使用<c>media-sound/alsa-driver</c>，
</warn>

<p>
两个选项是:
</p>

<ol>
  <li>
    采用内核提供的ALSA。这也是我们推荐的方法。
  </li>
  <li>采用Gentoo的<c>media-sound/alsa-driver</c>软件包。</li>
</ol>

<p>
内核自带的驱动和<c>alsa-driver</c>软件包可能有细微的差别；一方出现的特性和修复可能并没有加入到另一方。上游的开发者也意识到这一点，但是这两个驱动事实上是ALSA项目完全不同的开发分支；它们不完全一样。您应该知道它们有细微的不同，所以如果一个无法正常工作，就试试另一个吧！在我们作选择之前，让我们先看看各自的特点。
</p>

<p>
如果您打算采用内核提供的ALSA，以下是优点和缺点：
</p>

<table>
<tr>
  <th>内核自带的ALSA</th>
  <th>优点和缺点</th>
</tr>
<tr>
  <th>+</th>
  <ti>
    不需要安装其他的软件包；内核已经集成了驱动。
  </ti>
</tr>
<tr>
  <th>+</th>
  <ti>一揽子解决方案，不需要反复的emerge。</ti>
</tr>
<tr>
  <th>-</th>
  <ti>也许和<c>alsa-driver</c>使用的版本有些许不同。</ti>
</tr>
</table>

<p>
如果您采用<c>alsa-driver</c>，
</p>

<table>
<tr>
  <th>alsa-driver</th>
  <th>优点和缺点</th>
</tr>
<tr>
  <th>+</th>
  <ti>也许是ALSA项目最新的驱动</ti>
</tr>
<tr>
  <th>+</th>
  <ti>对开发音频驱动会有帮助。</ti>
</tr>
<tr>
  <th>-</th>
  <ti>每一次重编内核都需要重新emerge <c>alsa-driver</c>。</ti>
</tr>
<tr>
  <th>-</th>
  <ti>需要关闭某些内核选性使其能正常工作。</ti>
</tr>
</table>

</body>
</section>
<section>
<title>所以……</title>
<body>

<p>
如上所述，<c>alsa-driver</c>和内核自带的ALSA驱动的差别非常细微；考虑到易用性，我们建议您<e>首先</e>采用内核自带的驱动。在您向 <uri link="https://bugs.gentoo.org">Gentoo Bugzilla</uri> 提交任何和声音相关的问题之前，请先试着用<c>alsa-driver</c>重现它们，再提交缺陷报告。
</p>

</body>
</section>
<section id="lspci">
<title>在您开始之前</title>
<body>

<p>
无论您采用哪种方式，您必须要知道您的声卡用什么驱动。大多数情况下，声卡（板载和独立声卡）基于PCI总线，<c>lspci</c>将帮助您获取所需的信息。如果您没有安装<c>lspci</c>，请<c>emerge sys-apps/pciutils</c>。如果您使用的是USB声卡，<c>sys-apps/usbutils</c>的<c>lsusb</c><e>或许</e>有用。ISA声卡的用户，请试一下<c>sys-apps/isapnptools</c>。下列页面对使用ISA声卡的用户<e>也许</e>有所帮助：
</p>

<ul>
  <li>
  <uri link="http://www.roestock.demon.co.uk/isapnptools/">The ISAPNPTOOLS Page</uri>
  </li>
  <li>
  <uri link="http://www2.linuxjournal.com/article/3269">LinuxJournal PnP Article</uri>
  </li>
  <li>
  <uri link="http://www.tldp.org/HOWTO/Sound-HOWTO/x320.html">TLDP Sound HowTo</uri>
  </li>
</ul>

<note>
为了便于解释，我们在下文中假设用户使用的是基于PCI总线的声卡。
</note>

<p>
下一步，我们将找出声卡的详细信息。
</p>

<pre caption="声卡的详细信息">
# <i>lspci -v | grep -i audio</i>
0000:00:0a.0 Multimedia audio controller: Creative Labs SB Live! EMU10k1 (rev 06)
</pre>

<p>
现在我们知道机器里的声卡是Sound Blaster Live!，而且声卡的制造商是Creative Labs。看一下<uri link="http://bugtrack.alsa-project.org/main/index.php/Matrix:Main">ALSA声卡支持表</uri>，选择Creative Labs。您将会跳转到Creative Labs支持设备表的页面，您可以看到SB Live!采用<c>emu10k1</c>模块。这正是我们所需要的信息。如果您对技术细节有兴趣，您可以点击"详细信息"旁边的的链接，访问<c>emu10k1</c>的相关页面。
</p>

<p>
如果您想使用MIDI, 在emerge任何ALSA软件包之前，您必须在<path>/etc/make.conf</path>里，把<c>midi</c>加入到您的USE标记中。我们在下文中将会介绍如何<uri link="#midi">设置MIDI支持</uri>。
</p>

</body>
</section>
<section id="kernel">
<title>采用内核提供的ALSA</title>
<body>

<p>
如果您喜欢简洁，就选择这个方法。
</p>

<note>
自从2005.0版，Gentoo Linux使用2.6系列作为默认的内核。请确认您的内核是2.6系列。以下方法并<e>不适用</e>于2.4内核。
</note>

<p>
让我们配置内核来启用ALSA选项
</p>

<impo>
<c>genkernel</c>的用户请先运行<c>genkernel --menuconfig all</c>，然后参考<uri link="#doc_chap2_pre3">ALSA内核配置</uri>。
</impo>

<pre caption="编译内核">
# <i>cd /usr/src/linux</i>
# <i>make menuconfig</i>
</pre>

<note>
上述例子假设<path>/usr/src/linux</path>符号链接指向您想使用的内核源代码。在下一步之前，请确定上述条件。
</note>

<p>
现在我们要看一下在2.6内核下要打开哪些选项使得ALSA能够支持我们的声卡。
</p>

<p>
请注意：由于考虑到易用性，下面的例子中ALSA都被编译成模块。我们建议您采用相同的步骤，从而可以使用<c>alsaconf</c>来配置您的声卡。请<e>不要</e>跳过本文的<uri link="#alsa-config">配置</uri>部分。如果您还是希望将其编入内核，请作相应的调整。
</p>

<pre caption="ALSA内核配置">
Device Drivers  ---&gt;
   Sound  ---&gt;
   
<comment>（这个选项需要打开）</comment>
&lt;M&gt; Sound card support

<comment>（确保OSS被禁用）</comment>
Open Sound System   ---&gt;
   &lt; &gt; Open Sound System (DEPRECATED)

<comment>（回到上一步进入ALSA）</comment>
Advanced Linux Sound Architecture  ---&gt;
   &lt;M&gt; Advanced Linux Sound Architecture
   <comment>（如果您需要MIDI序列化或者路由，请选择此选项）</comment>
   &lt;M&gt; Sequencer support
   <comment>（老式的/dev/mixer*和/dev/dsp*支持。推荐。）</comment>
   &lt;M&gt; OSS Mixer API
   &lt;M&gt; OSS PCM (digital audio) API 

<comment>（您现在可以要支持的设备。通常您只有一种设备，如果您有多块声卡，请在这里激活全部设备。</comment>

<comment>（主要用于测试和开发，除非您知道自己在作什么，一般用户不需要启用此选项。）</comment>
Generic devices  ---&gt;
   
<comment>（ISA声卡需要此选项）</comment>
ISA devices   ---&gt;
<comment>（如果您有Gravis设备，请选择此选项）</comment>
   &lt;M&gt; Gravis UltraSound Extreme

<comment>（回到上一级进入PCI设备，现在大多数声卡是PCI设备）</comment>
PCI devices   ---&gt;
   <comment>（我们现在为我们的声卡选择emu10k1驱动）</comment>
   &lt;M&gt; Emu10k1 (SB Live!, Audigy, E-mu APS)
   <comment>（或者是Intel的声卡）</comment>
   &lt;M&gt; Intel/SiS/nVidia/AMD/ALi AC97 Controller
   <comment>（或者您使用的是VIA的声卡）</comment>
   &lt;M&gt; VIA 82C686A/B, 8233/8235 AC97 Controller

<comment>（如果您的声卡是USB接口，回到上一级，选择</comment>
USB Devices   ---&gt;
</pre>

<p>
现在所有的选项都配置好了，您可以（重新）编译内核，声卡的ALSA支持应该在重启后使用新内核时生效。不要忘了更新您的GRUB配置并使用新编译的内核。您可以前进到<uri link="#alsa-utilities">ALSA实用工具</uri>查看是否一切都工作正常。 
 
</p>

</body>
</section>
<section id="alsa-driver">
<title>采用ALSA驱动软件包</title>
<body>

<p>
所以您决定采用<c>alsa-driver</c>的方法。让我们开始吧。为了保证只编译您的声卡驱动，我们要作一些小的调整。这并非必要，但是可以避免编译不需要的设备驱动。
</p>

<p>
如果您不清楚您的声卡需要什么样的驱动，请参看本文的<uri link="#lspci">lspci</uri>部分。如果您知道驱动的名字（在此以<c>emu10k1</c>为例），编辑<path>/etc/make.conf</path>，加入变量<c>ALSA_CARDS</c>。
</p>

<pre caption="编辑/etc/make.conf，加入ALSA_CARDS">
<comment>（对于一块声卡）</comment>
ALSA_CARDS="emu10k1"
<comment>（对于多块声卡，用空格分隔名字）</comment>
ALSA_CARDS="emu10k1 via82xx"
</pre>

<p>
如果您已经编译了内核，又希望使用<c>alsa-driver</c>，请在执行下一步之前确定下列条件，否则<c>alsa-driver</c>很有可能无法正常工作。下述代码提供了一种检查的方法。
</p>

<note>
<c>genkernel</c> 可以前进至<uri link="#doc_chap2_pre6">安装alsa-driver</uri>, 他们的默认配置符合下列条件。
</note>

<ol>
  <li>
  <c>CONFIG_SOUND</c>被启用。（启用基本的声音支持）
  </li>
  <li>
  <c>CONFIG_SOUND_PRIME</c>没有被启用。（内置的OSS支持被禁用）
  </li>
  <li>
  <c>CONFIG_SND</c>没有被启用。（内置的ALSA支持被禁用）
  </li>
  <li>
  <path>/usr/src/linux</path>指向使用ALSA的内核源代码。
  </li>
</ol>

<pre caption=".config检查">
<comment>（假设linux符号链接指向正确的内核源代码）</comment>
# <i>cd /usr/src/linux</i>
# <i>grep SOUND .config</i>
<comment>（1.为真）</comment>
CONFIG_SOUND=y
<comment>（2.为真）</comment>
CONFIG_SOUND_PRIME is not set
# <i>grep SND .config</i>
<comment>（并且3.为真）</comment>
CONFIG_SND is not set
</pre>

<p>
下一步就是键入魔咒……哦，不，不是abracadabra。
</p>

<pre caption="安装alsa-driver">
# <i>emerge alsa-driver</i>
</pre>

<impo>
请注意，由于先前的驱动会被删除，您必须在（重新）编译内核以后，运行<c>emerge alsa-driver</c>。您可以安装<c>module-rebuild</c>软件包来简化这个步骤。它会跟踪模块包，并为您重新编译它们。首先运行<c>module-rebuild populate</c>来产生列表，然后在每一次（重新）编译内核后，运行<c>module-rebuild rebuild</c>, 所有外置的模块都会重新编译。
</impo>

</body>
</section>
</chapter>

<chapter>
<title>配置／测试ALSA</title>
<section id="alsa-utilities">
<title>ALSA实用工具</title>
<body>

<p>
<c>alsa-utils</c>是ALSA不可或缺的一部分，它集成了一些非常有用的应用程序，包括ALSA启动脚本。所以我们强烈建议您安装<c>alsa-utils</c>。
</p>

<pre caption="安装alsa-utils">
# <i>emerge alsa-utils</i>
</pre>

<note>
如果您在<uri link="#kernel">内核</uri>里激活了ALSA,<e>并且</e>没有将其编译成模块，请前进至<uri link="#initscript">ALSA启动脚本</uri>部分。否则您需要配置ALSA。由<c>alsa-utils</c>提供的<c>alsaconf</c>使得这个过程相当容易。
</note>

</body>
</section>
<section id="alsa-config">
<title>配置</title>
<body>

<p>
最新版本的<c>udev</c> （<c>>=udev-103</c>）为您的声卡提供了某种程度上的内核级自动配置。如果可能的话，让内核自动来设置您的声卡。否则如下所示，用<c>alsaconf</c>来配置您的声卡。
</p>

<note>
在运行时<c>alsaconf</c>，请关闭所有<e>可能</e>访问声卡的程序。
</note>

<p>
要配置您的声卡，请以root身份登录控制台，键入<c>alsaconf</c>。 
 
</p>

<pre caption="启动alsaconf">
# <i>alsaconf</i>
</pre>

<p>
您会看到一个由菜单引导的干净界面，它将自动探测您的设备，发现您的声卡。您会被要求从一个列表中选择您的声卡。然后它会请求修改<path>/etc/modules.d/alsa</path>，自动调整音量到合适的位置，运行<c>update-modules</c>并启动<path>/etc/init.d/alsasound</path>服务。<c>alsaconf</c>退出后，您可以进一步设置ALSA启动脚本。 
</p>

</body>
</section>
<section id="initscript">
<title>ALSA启动脚本</title>
<body>

<p>
我们几乎完成了所有的配置。无论您采用何种方法来安装ALSA，您都需要在系统启动的时候，加载模块，初始化ALSA，恢复您的音量设定。ALSA启动脚本可以为您处理所有的这一切，它就是<c>alsasound</c>。 我们将它加入到启动运行级。
</p>

<pre caption="将ALSA加入到启动运行级">
# <i>rc-update add alsasound boot</i>
 * alsasound added to runlevel boot
 * rc-update complete.
</pre>

<p>
下一步，检查<path>/etc/conf.d/alsasound</path>文件，确保SAVE_ON_STOP变量设置为yes。这将在您关闭系统时保存您的声音设置。
</p>

</body>
</section>
<section>
<title>Audio组</title>
<body>

<p>
在我们开始测试之前，最后还有一个<e>重要</e>设定。类Unix操作系统的经验——除非必要，不要运行在root权限，也适用于此;)。怎么做呢？大多数时间，您以普通用户的身份登录系统听音乐或者访问您的声卡。因此，您需要在""audio" 组中。在此，我们将用户加入到audio组中，当他们需要访问声卡的时候就不会有任何问题。我们需要以root的身份登录，运行<c>gpasswd</c>。
</p>

<pre caption="将用户加入audio组">
<comment>（用您的用户替换 &lt;username&gt; ）</comment>
# <i>gpasswd -a &lt;username&gt; audio </i>
将用户 &lt;username&gt; 加入audio组
</pre>

</body>
</section>
<section>
<title>音量检查！</title>
<body>

<p>
我们完成了所有的设置和前期工作，让我们启动ALSA吧。如果您已经运行了<c>alsaconf</c>，您可以跳过这一步，因为<c>alsaconf</c>已经完成了下述工作。
</p>

<pre caption="启动服务">
# <i>/etc/init.d/alsasound start</i>
</pre>

<p>
所有的问题都得到了解决，我们要检查一下音量。多数情况下，系统是静音的。我们用<c>alsamixer</c>来调整音量。
</p>

<pre caption="启动alsamixer">
<comment>（开启一个控制台程序。仅显示需要的配置）</comment>
# <i>alsamixer</i>
</pre>

<impo>
如果您无法启动<c>alsamixer</c>，且收到这样的错误alsamixer: function snd_ctl_open failed for default: No such file or directory，这通常是因为udev无法设置设备。运行<c>killall udevd; udevstart</c>来重新加载<path>/dev</path>下的相关设备文件，然后启动<c>alsamixer</c>。这应该能够解决问题。
</impo>

<p>
这<e>也许</e>是ALSA Mixer在您首次打开时的界面。请注意Master和PCM声道，它们下面都有MM的标记。这意味着它们都被静音了。如果在此状态下，您试图播放任何音频文件，您将无法从您的扬声器里听到任何声音。
</p>

<figure link="/images/docs/alsa-mixermuted.png" short="AlsaMixer静音" caption="Alsa Mixer主窗口，静音"/>

<p>
现在，我们要禁止静音，并根据需要设置音量。
</p>

<warn>
如果您想从您的扬声器里听到任何声音，Master和PCM声道不能设置为静音模式，并且音量必须调整到听得见的水平。
</warn>

<ul>
  <li>
  使用您的左右箭头键（&lt;- &amp; -&gt;）来转换声道。
  </li>
  <li>
  要静音／禁止静音，移动到该声道，比如说Master，按键盘上的m键。
  </li>
  <li>
  用上下箭头键来增加／减小音量。
  </li>
</ul>

<note>
设置低音和颤音的时候请注意，50通常是一个合适的值。除非特制的低音音箱，过强的低音会导致扬声器发出刺耳的杂音。
</note>

<p>
作完了这些以后，您的ALSA Mixer应该看起来如下。请注意00标记，而非MM标记；而且音量也作了调整。
</p>

<figure link="/images/docs/alsa-mixerunmuted.png" short="AlsaMixer禁止静音" caption="Alsa Mixer蓄势待发"/>

</body>
</section>
<section>
<title>声音测试！</title>
<body>

<p>
终于可以来点音乐了。如果上述一切工作正常，您可以听些不错的音乐了。一个快捷的测试方法是运行像<c>media-sound/madplay</c>这样的命令行工具。您也可以用一些更有名的工具，比如<c>mpg123</c>。如果您青睐ogg, 您可以使用由<c>media-sound/vorbis-tools</c>提供的<c>ogg123</c>。选一个您用着舒服的程序。一直如此，emerge您想要的。
</p>

<pre caption="获取软件">
<comment>（安装您所需的应用程序）</comment>
# <i>emerge madplay mpg123</i>
<comment>（播放.ogg文件）</comment>
# <i>emerge vorbis-tools</i>
</pre>

<p>
播放您喜爱的音乐……
</p>

<pre caption="播放音乐">
# <i>madplay -v /mnt/shyam/Music/Paul\ Oakenfold\ -\ Dread\ Rock.mp3</i>
MPEG Audio Decoder 0.15.2 (beta) - Copyright (C) 2000-2004 Robert Leslie et al.
          Title: Dread Rock
         Artist: Paul Oakenfold
          Album: Matrix Reloaded
           Year: 2003
          Genre: Soundtrack
                 Soundtrack
 00:04:19 Layer III, 160 kbps, 44100 Hz, joint stereo (MS), no CRC

# <i>ogg123 Paul\ Oakenfold\ -\ Dread\ Rock.ogg</i>
Audio Device:   Advanced Linux Sound Architecture (ALSA) output

Playing: Paul Oakenfold - Dread Rock.ogg
Ogg Vorbis stream: 2 channel, 44100 Hz
Genre: Soundtrack
Transcoded: mp3;160
Title: Dread Rock
Artist: Paul Oakenfold
Date: 2003
Album: Matrix Reloaded
Time: 00:11.31 [04:28.75] of 04:40.06  (200.6 kbps)  Output Buffer  96.9%
</pre>

</body>
</section>
<section>
<title>ALSA和USE标记</title>
<body>

<p>
现在您可以把<c>alsa</c> use标记加入到<path>/etc/make.conf</path>使得您的应用程序如果支持ALSA，就在编译时加入这个特性。某些架构，比如x86和amd64默认加入了这个标记。
</p>

</body>
</section>
<section>
<title>问题？</title>
<body>

<p>
如果由于某些原因，您无法听到声音，请您首先查看<uri link="#doc_chap3_pre6">alsamixer</uri> 设置，80%的问题源于声道被静音或者音量过低。您也可以查看您的窗口管理器的声音小程序以确保音量被调整到听得见的水平。
</p>

<p>
<path>/proc</path>是您的朋友。在此<path>/proc/asound</path>是您最好的朋友。我们将简单的看一下它能提供多少有用的信息。
</p>

<pre caption="有趣的/proc/asound">
<comment>（首先，如果/proc/asound/cards显示了您的声卡，ALSA
在所选的声卡上工作正常。）</comment>
# <i>cat /proc/asound/cards</i>
0 [Live           ]: EMU10K1 - Sound Blaster Live!
                     Sound Blaster Live! (rev.6, serial:0x80271102) at 0xb800, irq 11

<comment>（这显示了现在运行的ALSA的版本）</comment>
# <i>cat /proc/asound/version</i>
Advanced Linux Sound Architecture Driver Version 1.0.8 (Thu Jan 13 09:39:32 2005 UTC).

<comment>（ALSA OSS模拟层详解）</comment>
# <i>cat /proc/asound/oss/sndstat</i>
Sound Driver:3.8.1a-980706 (ALSA v1.0.8 emulation code)
Kernel: Linux airwolf.zion 2.6.11ac1 #2 Wed May 4 00:35:08 IST 2005 i686
Config options: 0

Installed drivers:
Type 10: ALSA emulation

Card config:
Sound Blaster Live! (rev.6, serial:0x80271102) at 0xb800, irq 11

Audio devices:
0: EMU10K1 (DUPLEX)

Synth devices: NOT ENABLED IN CONFIG

Midi devices:
0: EMU10K1 MPU-401 (UART)

Timers:
7: system timer

Mixers:
0: SigmaTel STAC9721/23
</pre>

<p>
其他用户碰到的常见问题是可怖的"Unknown symbol in module"错误。举例如下。
</p>

<pre caption="Unknown Symbol in module错误">
# <i>/etc/init.d/alsasound start</i>
 * Loading ALSA modules ...
 *   Loading: snd-card-0 ...                                              [ ok ]
 *   Loading: snd-pcm-oss ...
WARNING: Error inserting snd_mixer_oss
(/lib/modules/2.6.12-gentoo-r6/kernel/sound/core/oss/snd-mixer-oss.ko): Unknown
symbol in module, or unknown parameter (see dmesg) FATAL: Error inserting
snd_pcm_oss
(/lib/modules/2.6.12-gentoo-r6/kernel/sound/core/oss/snd-pcm-oss.ko): Unknown
symbol in module, or unknown parameter (see dmesg)                             
                                                                          [ !! ]
 *   Loading: snd-mixer-oss ...
FATAL: Error inserting snd_mixer_oss
(/lib/modules/2.6.12-gentoo-r6/kernel/sound/core/oss/snd-mixer-oss.ko): Unknown
symbol in module, or unknown parameter (see dmesg)                             
                                                                          [ !! ]
 *   Loading: snd-seq ...                                                 [ ok ]
 *   Loading: snd-emu10k1-synth ...                                       [ ok ]
 *   Loading: snd-seq-midi ...                                            [ ok ]
 * Restoring Mixer Levels ...                                             [ ok ]
</pre>

<p>
建议您看一下dmesg的输出，您很有可能会看到类似的结果：
</p>

<pre caption="dmesg输出">
<comment>（仅显示相关部分）</comment>
# <i>dmesg | less</i>
ACPI: PCI Interrupt 0000:02:06.0[A] -> Link [APC3] -> GSI 18 (level, low) -> IRQ 209
snd_mixer_oss: Unknown symbol snd_unregister_oss_device
snd_mixer_oss: Unknown symbol snd_register_oss_device
snd_mixer_oss: Unknown symbol snd_mixer_oss_notify_callback
snd_mixer_oss: Unknown symbol snd_oss_info_register
snd_pcm_oss: Unknown symbol snd_unregister_oss_device
snd_pcm_oss: Unknown symbol snd_register_oss_device
snd_pcm_oss: Unknown symbol snd_mixer_oss_ioctl_card
snd_pcm_oss: Unknown symbol snd_oss_info_register
snd_mixer_oss: Unknown symbol snd_unregister_oss_device
snd_mixer_oss: Unknown symbol snd_register_oss_device
snd_mixer_oss: Unknown symbol snd_mixer_oss_notify_callback
snd_mixer_oss: Unknown symbol snd_oss_info_register
</pre>

<p>
上述问题是由于您从<c>alsa-driver</c>转换到内核自带的ALSA而造成的, 在您卸载<c>alsa-driver</c>时，内核模块由于受保护而没有移除。所以当您使用内核自带的ALSA，运行<c>modprobe</c>时, <c>alsa-driver</c>和内核自带的驱动混在一起，造成了上述的错误。
</p>

<p>
解决方案相当简单。我们只需要在unmerge <c>alsa-driver</c>后手动删除出问题的目录。请确定您删除的是正确的内核版本而非当前的版本！
</p>

<pre caption="删除alsa-driver模块">
# <i>rm -rf /lib/modules/$(uname -r)/alsa-driver</i>
</pre>

<p>
另一个引起类似错误的可能是在<path>/etc/modules.d</path>中的某个文件错误地输出了 <c>device_mode</c>参数。请确认这是问题所在，并且找出这个捣蛋鬼。 
 
</p>

<pre caption="确认并查找device_mode">
<comment>（查看dmesg以确认）</comment>
# <i>dmesg | grep device_mode</i>
snd: Unknown parameter `device_mode'
<comment>（现在，找到问题的根源）</comment>
# <i>grep device_mode /etc/modules.d/*</i>
</pre>

<p>
通常是一个叫<path>alsa</path>的文件包含了一行: <c>options snd device_mode=0666</c>。删除此行，重启alsasound服务应该能够解决问题。
</p>

</body>
</section>
</chapter>

<chapter>
<title>其他</title>
<section id="midi">
<title>设置MIDI支持</title>
<body>

<p>
首先请确定<path>/etc/make.conf</path>有<c>midi</c> USE标记。如果没有，请加上它。您需要重新emerge任何使用了<c>midi</c>标记的ALSA软件包，比如<c>alsa-lib</c>，<c>alsa-utils</c>和<c>alsa-driver</c>。
</p>

<p>
如果您的声卡有板载的MIDI合成器并且您希望听一些.mid文件，您需要安装<c>awesfx</c>，它基本上是一组实用工具来控制AWE32驱动。我们首先要安装它。如果没有硬件合成器，您可以使用虚拟合成器，更多信息，请查看<uri link="#vsynth">虚拟合成器</uri>一节。
</p>

<pre caption="安装awesfx">
# <i>emerge awesfx</i>
</pre>

<note>
然后您需要从声卡驱动光盘或者Windows安装文件中复制SoundFont （SF2）文件到<path>/usr/share/sounds/sf2/</path>。举例来说，SBLive!的SoundFont文件可以是8MBGMSFX.SF2.
</note>

<p>
复制了Soundfont文件以后，我们可以如下所示播放midi文件。您也可以把<c>asfxload</c>命令加入到<path>/etc/conf.d/local.start</path>，从而在每次系统启动时加载SoundFont。
</p>

<note>
下述代码列表中的<path>/mnt</path>路径也许和您的机器上的路径<e>不同</e>。它们只是例子而已，您需要根据您的机器改变路径。
</note>

<pre caption="加载Soundfonts">
<comment>（首先，复制Soundfont）</comment>
# <i>cp /mnt/win2k/Program\ Files/CreativeSBLive2k/SFBank/8MBGMSFX.SF2 /usr/share/sounds/sf2/</i> 
<comment>（或者从SoundBlaster的光盘里复制文件）</comment>
# <i>cp /mnt/cdrom/AUDIO/ENGLISH/SFBANK/8MBGMSFX.SF2 /usr/share/sounds/sf2/</i>
<comment>（加载特定的Soundfont）</comment>
# <i>asfxload /usr/share/sounds/sf2/8MBGMSFX.SF2</i>
</pre>

<p>
您现在可以用<c>aplaymidi</c>这样的程序来播放midi文件。运行<c>aplaymidi -l</c>来获取端口列表，然后选择一个端口来播放。
</p>

<pre caption="播放MIDI">
<comment>（查看可用的端口）</comment>
# <i>aplaymidi -l</i>
 Port    Client name                      Port name
 64:0    EMU10K1 MPU-401 (UART)           EMU10K1 MPU-401 (UART)
 65:0    Emu10k1 WaveTable                Emu10k1 Port 0
 65:1    Emu10k1 WaveTable                Emu10k1 Port 1
 65:2    Emu10k1 WaveTable                Emu10k1 Port 2
 65:3    Emu10k1 WaveTable                Emu10k1 Port 3
<comment>（选择一个端口，播放mid文件）</comment>
# <i> aplaymidi --port=65:0 /mnt/shyam/music/midi/mi2.mid</i>
</pre>

</body>
</section>
<section id="vsynth">
<title>虚拟合成器</title>
<body>

<p>
如果您的声卡不支持硬件合成器，您可以使用虚拟合成器，比如<c>timidity++</c>。安装是小菜一碟。
</p>

<pre caption="安装timidity++">
# <i>emerge timidity++</i>
</pre>

<p>
timidity需要一个SoundFont来播放声音。幸运的是ebuild会为您安装一些SoundFont。Portage里还有一些可用的SountFont包，比如<c>timidity-freepats</c>和<c>timidity-eawpatches</c>。您可以安装多个SountFont包，而且可以在<path>/usr/share/timidity/</path>安装您自己的SoundFont文件。要在多个timidity的配置中选择，您需要<c>eselect</c>。
</p>

<pre caption="改变配置">
# <i>eselect timidity list</i>
# <i>eselect timidity set eawpatches</i>
</pre>

<p>
不要忘了把<c>timidity</c>加入默认运行级。
</p>

<pre caption="把timidity加入默认运行级。">
# <i>rc-update add timidity default</i>
# <i>/etc/init.d/timidity start</i>
</pre>

<p>
您现在可以试着<uri link="#doc_chap4_pre3">播放MIDI</uri>文件。
</p>

</body>
</section>
<section>
<title>工具和固件</title>
<body>

<p>
某些特定声卡可以从<c>alsa-tools</c>和<c>alsa-firmware</c>包中获得性能的提升。您只需要简单的<c>emerge</c>。
</p>

<pre caption="安装ALSA工具">
# <i>emerge alsa-tools</i>
</pre>

</body>
</section>
<section>
<title>多块声卡的支持</title>
<body>

<p>
如果ALSA被编译为内核模块（或者您安装了<c>alsa-driver</c>），您可以同时在您的系统中使用多块声卡。您仅需要在<path>/etc/modules.d/alsa</path>里指定启动的顺序。此文件用驱动名来标记您的声卡。0是第一块卡，1是第二块卡，以此类推。这是一个有两块声卡系统的例子。 
 
</p>

<pre caption="两块声卡的/etc/modules.d/alsa配置">
options snd-emu10k1 index=0
options snd-via82xx index=1
</pre>

<p>
如果您有两块声卡使用相同的驱动，您在同一行里用逗号分隔的数字来配置它们。这是一个有三块声卡的系统，其中的两块是Intel高保真声卡。
</p>

<pre caption="多块声卡的/etc/modules.d/alsa配置">
options snd-ymfpci index=0
options snd-hda-intel index=1,2
</pre>

</body>
</section>
<section>
<title>插件</title>
<body>

<p>
您也许想安装一些插件来获得额外的功能。<c>alsa-plugins</c>打包提供了一些有用的插件，包括: PulseAudio输出，采样率转换器；jack（一个低延迟的音频服务器）和一个可以通过数字S/PDIF接口（光线或同轴电缆）输出6声道音频的编码器。您可以通过USE标记来选择安装什么插件
</p>

<pre caption="安装alsa-plugins">
# <i>emerge -avt alsa-plugins</i>
</pre>

</body>
</section>
<section>
<title>感谢</title>
<body>

<p>
所有Gentoo ALSA指南的贡献者: Vincent Verleye, Grant Goodyear, Arcady Genkin, Jeremy Huddleston, John P. Davis, Sven Vermeulen, Benny Chuang, Tiemo Kieft and Erwin。
</p>

</body>
</section>
<section>
<title>资源</title>
<body>

<ul>
  <li><uri link="http://www.alsa-project.org/">The ALSA Project</uri></li>
  <li><uri link="http://linux-sound.org">Linux Sound/MIDI Software</uri></li>
</ul>

</body>
</section>
</chapter>
</guide>



1.1                  xml/htdocs/doc/zh_cn/gentoo-x86-quickinstall.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/zh_cn/gentoo-x86-quickinstall.xml?rev=1.1&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/zh_cn/gentoo-x86-quickinstall.xml?rev=1.1&content-type=text/plain

Index: gentoo-x86-quickinstall.xml
===================================================================
<?xml version='1.0' encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">

<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/zh_cn/gentoo-x86-quickinstall.xml,v 1.1 2007/09/17 17:54:10 r0bertz Exp $ -->
<!-- English CVS version: 1.78 -->

<guide link="/doc/zh_cn/gentoo-x86-quickinstall.xml" lang="zh_cn">
<title>Gentoo Linux x86快速安装指南</title>

<author title="作者">
  <mail link="neysx@g.o">Xavier Neys</mail>
</author>
<author title="作者">
  <mail link="swift@g.o">Sven Vermeulen</mail>
</author>
<author title="作者">Steven Wagner</author>
<author title="译者">
  <mail link="tysnoo@×××××.com">叶宝泰</mail>
</author>

<abstract>
这篇快速安装指南以一种相对简略的方式介绍Gentoo安装过程。目的是让没有太多时间的用户完成基于stage3的安装。想遵循本指南的用户须已有安装Gentoo Linux的经验。
</abstract>

<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>

<version>19</version>
<date>2007-06-02</date>

<chapter>
<title>介绍</title>
<section>
<body>

<p>
本指南包含了完成一次从stage3开始安装Gentoo要用到的所有命令。你需要连接到Internet以下载stage3包和Portage快照。
</p>

<p>
所有费时超过两秒的命令都会跟随着在屏幕上打印时间输出。这些命令的耗时是在一台AMD 2000 1.66 Ghz的PC上测试的，拥有512 MB内存和两个SATA硬盘。
</p>

<pre caption="测试机器的规格">
<comment>（下述配置和耗时情况帮你粗略估计完成整个安装过程大概需要的时间）</comment>

# <i>grep bogo /proc/cpuinfo</i>
bogomips       : 3337.81

# <i>hdparm -tT /dev/sda</i>
/dev/sda:
 Timing cached reads:   1100 MB in  2.00 seconds = 549.97 MB/sec
 Timing buffered disk reads:  224 MB in  3.01 seconds =  74.36 MB/sec

# <i>grep MemTotal /proc/meminfo</i>
MemTotal:       509248 kB
</pre>

</body>
</section>
</chapter>

<chapter>
<title>快速安装指南</title>
<section>
<title>安装介质</title>
<body>

<p>
从我们的<uri link="/main/en/mirrors.xml">镜像</uri>下载一张光盘。可以在<path>releases/x86/&lt;release&gt;/installcd</path>中找到minimal CD的ISO文件，或者在<path>releases/x86/&lt;release&gt;/livecd</path>中找到LiveCD的ISO文件。<e>minimal</e>安装盘只适用于有网络环境的安装。<e>LiveCD</e>适用于无网络环境的安装，参考文档<uri link="/doc/zh_cn/handbook/2007.0/handbook-x86.xml">2007.0 x86安装手册</uri>。本指南推荐使用minimal CD。
</p>

<p>
<uri link="/doc/en/faq.xml#isoburning">刻制</uri>光盘，用它引导机器。
</p>

</body>
</section>
<section>
<title>从光盘启动</title>
<body>

<p>
启动时按下<c>F2</c>查看有哪些引导选项。你可以启动<c>gentoo</c>或者<c>gentoo-nofb</c>，后者禁用帧缓冲。如果你用LiveCD引导，别忘了添上<c>nox</c>选项以防止启动X图形环境。有好几个选项可用于启用或禁用一些特性。正常情况下会检测出你的硬件并装载所有模块。如果内核无法正确引导或是在引导过程中挂机，你可能不得不尝试不同的配置。最安全的办法大概是使用<c>nodetect</c>选项，然后显式地载入需要的模块。
</p>

<pre caption="从minimal CD启动">
Gentoo Linux Installation LiveCD                     http://www.gentoo.org
Enter to Boot; F1 for kernels  F2 for options.
boot: <i>gentoo-nofb</i>
<comment>（或在有问题的情况下）</comment>
boot: <i>gentoo-nofb nodetect</i>
</pre>

</body>
</section>
<section>
<title>可选：装载模块</title>
<body>

<p>
如果使用了<c>nodetect</c>选项，就要在启动后载入必要的模块。你还要配置好网络并拥有访问磁盘的权限。<c>lspci</c>命令能帮助你确认硬件信息。
</p>

<pre caption="载入必要的模块">
livecd root # <i>lspci</i>
<comment>（根据lspci的输出查看需要哪些模块）</comment>

<comment>（以下只是个例子，实际以具体硬件为准）</comment>
livecd root # <i>modprobe 3w-9xxx</i>
livecd root # <i>modprobe r8169</i>
</pre>

</body>
</section>
<section>
<title>网络配置</title>
<body>

<p>
如果还没开启网络，可以用<c>net-setup</c>来配置网络。配置之前可能要先用<c>modprobe</c>为网卡载入支持模块。如果你有ADSL，请使用<c>pppoe-setup</c>和<c>pppoe-start</c>。要支持PPTP，首先编辑<path>/etc/ppp/chap-secrets</path>和<path>/etc/ppp/options.pptp</path>，然后使用<c>pptp &lt;server&nbsp;ip&gt;</c>。
</p>

<p>
如果是无线连接，用<c>iwconfig</c>设置无线连接参数，然后再次执行<c>net-setup</c>或者手动运行<c>ifconfig</c>、<c>dhcpcd</c>和/或<c>route</c>。
</p>

<p>
如果你用代理，不要忘了使用<c>export http_proxy</c>、<c>ftp_proxy</c>和<c>RSYNC_PROXY</c>初始化系统环境。
</p>

<pre caption="通过向导配置网络">
livecd root # <i>net-setup eth0</i>
</pre>

<p>
或者，你也可以手动打开网络。下面的例子把你电脑的IP地址配置为192.168.1.10，并把网关和域名服务器设为192.168.1.1。
</p>

<pre caption="手动配置网络">
livecd root # <i>ifconfig eth0 192.168.1.10/24</i>
livecd root # <i>route add default gw 192.168.1.1</i>
livecd root # <i>echo nameserver 192.168.1.1 &gt; /etc/resolv.conf</i>
</pre>

<p>
安装盘允许你启动一个<c>sshd</c>服务，添加用户，运行<c>irssi</c>（一个命令行的客户端聊天工具），还可以使用<c>lynx</c>或<c>links</c>进行网上冲浪。
</p>

</body>
</section>
<section>
<title>可选：通过ssh连接到你的新机器</title>
<body>

<p>
最有趣的功能当然是<c>sshd</c>。启动这个服务，从另一台机器连过来，然后从本指南复制/粘贴命令。
</p>

<pre caption="启动sshd">
livecd root # <i>time /etc/init.d/sshd start</i>
 * Generating hostkey ...
<comment>（sshd生成密钥并显示更多输出）</comment>
 * starting sshd ...                            [ok]

real   0m13.688s
user   0m9.420s
sys    0m0.090s
</pre>

<p>
现在设置一下安装盘的root密码，使你能通过另一台电脑连接。请注意正常情况下不推荐你允许root通过ssh连接。如果你的本地网络不太可靠，请设一个又长又复杂的密码。它只能使用一次，因为机器重启后就没掉了。
</p>

<pre caption="设置root密码">
livecd root # <i>passwd</i>
New UNIX password: <comment>输入密码</comment>
Retype new UNIX password: <comment>输入密码</comment>
passwd: password updated successfully
</pre>

<p>
现在就可以在另一台电脑上打开一个终端并连接到你的新机器，在新的窗口中继续本指南接下去的内容，复制/粘贴文中的命令。
</p>

<pre caption="从另一台电脑连到你的新机器">
<comment>#-#-#-#-#  choice  #-#-#-#-#
（用你新机器的IP地址）
#-#-#-#-#  choice  #-#-#-#-#
（使用你新机器的IP地址）</comment>
$ <i>ssh root@192.168.1.10</i>
The authenticity of host '192.168.1.10 (192.168.1.10)' can't be established.
RSA key fingerprint is 96:e7:2d:12:ac:9c:b0:94:90:9f:40:89:b0:45:26:8f.
Are you sure you want to continue connecting (yes/no)? <i>yes</i>
Warning: Permanently added '192.168.1.10' (RSA) to the list of known hosts.
Password: <comment>输入密码</comment>
</pre>

</body>
</section>
<section>
<title>准备磁盘</title>
<body>

<p>
使用<c>fdisk</c>或者<c>cfdisk</c>创建分区规划。至少需要一个交换分区（类别为82）和一个Linux分区（类别为83）。下面是我们的手册选用的方案，创建包括一个<path>/boot</path>分区，一个交换分区和一个主分区。设备名可能是<path>/dev/sda</path>或者<path>/dev/hda</path>，前者为SATA或SCSI硬盘，后者为IDE硬盘。
</p>

<pre caption="创建分区">
livecd ~ # <i>fdisk /dev/sda</i>

<comment>（本手册接下去使用以下分区规划）</comment>
livecd ~ # <i>fdisk -l /dev/sda</i>

Disk /dev/sda: 599.9 GB, 599978409984 bytes
255 heads, 63 sectors/track, 72943 cylinders
Units = cylinders of 16065 * 512 = 8225280 bytes

   Device Boot      Start         End      Blocks   Id  System
/dev/sda1               1          12       96358+  83  Linux
/dev/sda2              13         110      787185   82  Linux swap / Solaris
/dev/sda3             111       72943   585031072+  83  Linux
</pre>

<p>
使用<c>mke2fs</c>，<c>mke2fs -j</c>，<c>mkreiserfs</c>，<c>mkfs.xfs</c>和<c>mkfs.jfs</c>建立Linux分区的文件系统。使用<c>mkswap</c>和<c>swapon</c>初始化交换分区。
</p>

<pre caption="创建文件系统并激活交换分区">
<comment>（ext2完全满足/boot分区的需要）</comment>
livecd ~ # <i>mke2fs /dev/sda1</i>

<comment>（主分区就用ext3吧）</comment>
livecd ~ # <i>mke2fs -j /dev/sda3</i>

<comment>（创建并激活交换分区）</comment>
livecd ~ # <i>mkswap /dev/sda2 &amp;&amp; swapon /dev/sda2</i>
</pre>

<p>
把新建的文件系统挂载到<path>/mnt/gentoo</path>。如果需要其他挂载点（如<path>/mnt/gentoo/boot</path>），也要为它们创建目录并挂载好。
</p>

<pre caption="挂载文件系统">
livecd ~ # <i>mount /dev/sda3 /mnt/gentoo</i>
livecd ~ # <i>mkdir /mnt/gentoo/boot</i>
livecd ~ # <i>mount /dev/sda1 /mnt/gentoo/boot</i>
</pre>

</body>
</section>
<section>
<title>安装Stage</title>
<body>

<p>
首先确保正确设置了日期和时间。执行<c>date MMDDhhmmYYYY</c>，使用UTC时间。
</p>

<pre caption="设定日期和UTC时间">
<comment>（查看时钟）</comment>
livecd ~ # <i>date</i>
Mon Mar  6 00:14:13 UTC 2006

<comment>（设置当前日期和时间，如果需要的话）</comment>
livecd ~ # <i>date 030600162006</i> <comment>（格式为MMDDhhmmYYYY）</comment>
Mon Mar  6 00:16:00 UTC 2006
</pre>

<p>
接下来，从我们的<uri link="/main/en/mirrors.xml">镜像</uri>下载一份stage包。进入<path>/mnt/gentoo</path>，执行<c>tar xjpf &lt;stage3 tarball&gt;</c>解压stage包。
</p>

<pre caption="下载一份stage3压缩包">
livecd ~ # <i>cd /mnt/gentoo</i>
livecd gentoo # <i>links http://www.gentoo.org/main/en/mirrors.xml</i>
<comment>（选一个镜像，进入/x86/current/stages目录，高亮显示你需要的stage3包，
即i686 stage3，按下D键下载）</comment>

<comment>（<b>Or</b> 不选择最近的镜像，直接用wget下载）</comment>
livecd ~ # <i>cd /mnt/gentoo</i>
livecd gentoo # <i>wget ftp://gentoo.osuosl.org/pub/gentoo/releases/x86/current/stages/stage3-i686*tar.bz2</i>
</pre>

<pre caption="解开stage3压缩包">
livecd gentoo # <i>time tar xjpf stage3*</i>

real  1m13.157s
user  1m2.920s
sys   0m7.230s
</pre>

<p>
安装最新的Portage快照。跟下载stage3压缩包一样：从我们的<uri link="/main/en/mirrors.xml">列表</uri>选择一个最近的镜像，下载最新的快照并解压。
</p>

<pre caption="下载最新的Portage快照">
livecd gentoo # <i>cd /mnt/gentoo/usr</i>
livecd usr # <i>links http://www.gentoo.org/main/en/mirrors.xml</i>
<comment>（选一个镜像，进入snapshots/目录，高亮显示 <b>portage-latest.tar.bz2</b> ，按下D键下载）</comment>

<comment>（<b>Or</b> 不选择最近的镜像，直接用wget下载）</comment>
livecd gentoo # <i>cd /mnt/gentoo/usr</i>
livecd usr # <i>wget http://gentoo.osuosl.org/snapshots/portage-latest.tar.bz2</i>
</pre>

<pre caption="解开Portage快照">
livecd usr # <i>time tar xjf portage*</i>

real  0m51.523s
user  0m28.680s
sys   0m12.840s
</pre>

</body>
</section>
<section>
<title>切换系统</title>
<body>

<p>
挂载<path>/proc</path>文件系统，拷贝<path>/etc/resolv.conf</path>文件，然后chroot到你的Gentoo环境。
</p>

<pre caption="Chroot">
livecd usr # <i>cd /</i>
livecd / # <i>mount -t proc proc /mnt/gentoo/proc</i>
livecd / # <i>cp -L /etc/resolv.conf /mnt/gentoo/etc/</i>
livecd / # <i>chroot /mnt/gentoo /bin/bash</i>
livecd / # <i>env-update &amp;&amp; source /etc/profile</i>
>>> Regenerating /etc/ld.so.cache...
</pre>

</body>
</section>
<section>
<title>设定时区</title>
<body>

<p>
设置你的时区信息：使用<path>/usr/share/zoneinfo</path>中的正确条目。
</p>

<pre caption="设置时区">
livecd / # <i>ls /usr/share/zoneinfo</i>
<comment>（以上海为例）</comment>
livecd / # <i>cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime</i>
livecd / # <i>date</i>
Thu Aug 30 11:03:16 CST 2007
</pre>

</body>
</section>
<section>
<title>设定主机名和域名</title>
<body>

<p>
在<path>/etc/conf.d/hostname</path>和<path>/etc/hosts</path>中设置主机名。以下例子中我们用<c>mybox</c>作为主机名，用<c>at.myplace</c>作为域名。可以用nano编辑这些配置文件，或者使用下面的命令：
</p>

<pre caption="设置主机名和域名">
livecd / # <i>cd /etc</i>
livecd etc # <i>echo "127.0.0.1 mybox.at.myplace mybox localhost" > hosts</i>
livecd etc # <i>sed -i -e 's/HOSTNAME.*/HOSTNAME="mybox"/' conf.d/hostname</i>
<comment>（使用指定的主机名并检查）</comment>
livecd etc # <i>hostname mybox</i>
livecd etc # <i>hostname -f</i>
mybox.at.myplace
</pre>

</body>
</section>
<section>
<title>内核配置</title>
<body>

<p>
安装一个内核源码包（通常为<c>gentoo-sources</c>），配置、编译并拷贝<path>arch/i386/boot/bzImage</path>文件到<path>/boot</path>。
</p>

<pre caption="安装内核源码包，编译和安装内核">
livecd etc # <i>time emerge gentoo-sources</i>

real  2m51.435s
user  0m58.220s
sys   0m29.890s
livecd etc # <i>cd /usr/src/linux</i>
livecd linux # <i>make menuconfig</i>
<comment>（配置内核）</comment>
livecd linux # <i>time make -j2</i>

<comment>（所花的时间很大程度上决定于你所选的选项）</comment>
real  3m51.962s
user  3m27.060s
sys   0m24.310s

livecd linux # <i>make modules_install</i>
livecd linux # <i>cp arch/i386/boot/bzImage /boot/kernel</i>
</pre>

</body>
</section>
<section>
<title>配置系统</title>
<body>

<p>
编辑<path>/etc/fstab</path>，用实际的分区名代替<c>BOOT</c>，<c>ROOT</c>和<c>SWAP</c>。记得确认一下文件系统是否与所安装的相匹配。
</p>

<pre caption="fstab范例">
livecd linux # <i>cd /etc</i>
livecd etc # <i>nano -w fstab</i>
/dev/<i>sda1</i>   /boot     ext2    noauto,noatime     1 2
/dev/<i>sda3</i>   /         ext3    noatime            0 1
/dev/<i>sda2</i>   none      swap    sw                 0 0
</pre>

<p>
在<path>/etc/conf.d/net</path>中配置网络。把<c>net.eth0</c>启动脚本添加到默认运行级别。如果有多张网卡，分别为它们建立符号链接到<c>net.eth0</c>启动脚本，并一起添加到默认运行级别。用<c>nano</c>编辑<path>/etc/conf.d/net</path>，或者使用如下命令：
</p>

<pre caption="配置网络">
livecd etc # <i>cd conf.d</i>
livecd conf.d # <i>echo 'config_eth0=( "192.168.1.10/24" )' >> net</i>
livecd conf.d # <i>echo 'routes_eth0=( "default via 192.168.1.1" )' >> net</i>
livecd conf.d # <i>rc-update add net.eth0 default</i>
<comment>（如果你把网卡驱动编译为模块，
需要将它添加到/etc/modules.autoload.d/kernel-2.6）</comment>
livecd conf.d # <i>echo r8169 >> /etc/modules.autoload.d/kernel-2.6</i>
<comment>（如果希望重启后通过ssh重新连接到新机器：）</comment>
livecd conf.d # <i>rc-update add sshd default</i>
</pre>

<note>
如果需要支持PCMCIA卡，请emerge <c>pcmciautils</c>。
</note>

<p>
执行<c>passwd</c>设置root密码。
</p>

<pre caption="设置root密码">
livecd conf.d # <i>passwd</i>
New UNIX password: <comment>输入密码</comment>
Retype new UNIX password: <comment>再输入密码</comment>
passwd: password updated successfully
</pre>

<p>
编辑<path>/etc/conf.d/clock</path>以定义前面所使用的时区。
</p>

<pre caption="编辑/etc/conf.d/clock">
livecd conf.d # <i>nano -w /etc/conf.d/clock</i>
TIMEZONE="Asia/Shanghai"
</pre>

<p>
检查系统配置，查看并编辑这些配置文件：<path>/etc/rc.conf</path>， <path>/etc/conf.d/rc</path>，<path>/etc/conf.d/keymaps</path>。
</p>

<pre caption="可选：编辑一些配置文件">
livecd conf.d # <i>nano -w /etc/rc.conf</i>
livecd conf.d # <i>nano -w /etc/conf.d/rc</i>
livecd conf.d # <i>nano -w /etc/conf.d/keymaps</i>

</pre>

</body>
</section>
<section>
<title>安装系统工具</title>
<body>

<p>
安装一个系统日志如<c>syslog-ng</c>和一个cron守护进程如<c>vixie-cron</c>，并把它们添加到默认运行级别。
</p>

<note>
Cron守护进程依赖于MTA。<c>mail-mta/ssmtp</c>会因依赖性而被一起安装。如果你想使用一种更高级的MTA，可以现在安装它。要是现在没空，暂时先安装ssmtp，以后再卸载并安装你要的MTA。
</note>

<pre caption="安装系统日志和cron守护进程">
livecd conf.d # <i>time emerge syslog-ng vixie-cron</i>

real  1m52.699s
user  1m1.630s
sys   0m35.220s
livecd conf.d # <i>rc-update add syslog-ng default</i>
livecd conf.d # <i>rc-update add vixie-cron default</i>
</pre>

<p>
安装必要的文件系统工具（<c>xfsprogs</c>，<c>reiserfsprogs</c>或<c>jfsutils</c>）和网络工具（<c>dhcpcd</c>或<c>ppp</c>）。
</p>

<pre caption="安装其它工具">
livecd conf.d # <i>emerge xfsprogs</i>       <comment>(如果使用XFS文件系统)</comment>
livecd conf.d # <i>emerge jfsutils</i>       <comment>(如果使用JFS文件系统)</comment>
livecd conf.d # <i>emerge reiserfsprogs</i>  <comment>(如果使用Reiser文件系统)</comment>
livecd conf.d # <i>emerge dhcpcd</i>         <comment>(如果使用DHCP客户端)</comment>
livecd conf.d # <i>emerge ppp</i>            <comment>(如果使用PPPoE ADSL连接)</comment>
</pre>

</body>
</section>
<section>
<title>配置引导程序</title>
<body>

<p>
Emerge <c>grub</c>或<c>lilo</c>。配置<path>/boot/grub/grub.conf</path>或<path>/etc/lilo.conf</path>并安装你emerge的引导程序。
</p>

<p>
<b>1. Using grub</b>
</p>

<pre caption="Emerge grub并编辑它的配置文件">
livecd conf.d # <i>time emerge grub</i>

real  1m8.634s
user  0m39.460s
sys   0m15.280s
livecd conf.d # <i>nano -w /boot/grub/grub.conf</i>
</pre>

<pre caption="grub.conf范例">
default 0
timeout 10

title=Gentoo
root (hd0,0)
kernel /boot/kernel root=/dev/sda3
</pre>

<pre caption="安装grub">
livecd conf.d # <i>grub</i>
Probing devices to guess BIOS drives. This may take a long time.

grub> <i>root (hd0,0)</i>
 Filesystem type is ext2fs, partition type 0x83

grub> <i>setup (hd0)</i>
 Checking if "/boot/grub/stage1" exists... yes
 Checking if "/boot/grub/stage2" exists... yes
 Checking if "/boot/grub/e2fs_stage1_5" exists... yes
 Running "embed /boot/grub/e2fs_stage1_5 (hd0)"...  16 sectors are embedded.
succeeded
 Running "install /boot/grub/stage1 (hd0) (hd0)1+16 p (hd0,0)/boot/grub/stage2 /boot/
grub/menu.lst"... succeeded
Done.

grub> <i>quit</i>
</pre>

<p>
接着进入<uri link="#reboot">重启一节</uri>。
</p>

<p>
<b>2. Using lilo</b>
</p>

<pre caption="Emerge lilo并编辑它的配置文件">
livecd conf.d # <i>time emerge lilo</i>

real  0m47.016s
user  0m22.770s
sys   0m5.980s
livecd conf.d # <i>nano -w /etc/lilo.conf</i>
</pre>

<pre caption="lilo.conf范例">
boot=/dev/sda
prompt
timeout=50
default=gentoo

image=/boot/kernel
  label=Gentoo
  read-only
  root=/dev/sda3
</pre>

<pre caption="安装lilo">
livecd conf.d # <i>lilo</i>
Added Gentoo *
</pre>

</body>
</section>
<section id="reboot">
<title>重启</title>
<body>

<p>
退出chroot环境，卸载所有文件系统并重启：
</p>

<pre caption="重启">
livecd conf.d # <i>exit</i>
livecd / # <i>umount /mnt/gentoo/proc /mnt/gentoo/boot /mnt/gentoo</i>
livecd / # <i>reboot</i>
<comment>（别忘了取出光盘）</comment>
</pre>

</body>
</section>
<section id="after-reboot">
<title>完成安装</title>
<body>

<note>
在我们这台测试机器上，从minimal CD启动显示boot提示符开始，到重启后显示登录提示符， <b>总用时</b>为<b>00:42:31</b> 。没错，不到一个小时！注意这个时间还包含了stage3包、Portage快照和一些软件包的下载时间，以及配置内核所花的时间。
</note>

<p>
以<c>root</c>身份登录，用<c>useradd</c>添加一个或多个用户，作为日常使用。
</p>

<pre caption="从另一台电脑连到你的新机器">
<comment>（清理known_hosts文件中的内容，因为你的新机器已生成一个新的
通用主机密钥）</comment>
$ <i>nano -w ~/.ssh/known_hosts</i>
<comment>（找出新机器的IP并删除那一行，保存并退出nano）</comment>

<comment>#-#-#-#-#  choice  #-#-#-#-#
（用你新机器的IP地址）
#-#-#-#-#  choice  #-#-#-#-#
（使用你新机器的IP地址）</comment>
$ <i>ssh root@192.168.1.10</i>
The authenticity of host '192.168.1.10 (192.168.1.10)' can't be established.
RSA key fingerprint is 96:e7:2d:12:ac:9c:b0:94:90:9f:40:89:b0:45:26:8f.
Are you sure you want to continue connecting (yes/no)? <i>yes</i>
Warning: Permanently added '192.168.1.10' (RSA) to the list of known hosts.
Password: <comment>输入密码</comment>
</pre>

<pre caption="添加一个新用户">
mybox ~ # <i>adduser -g users -G lp,wheel,audio,cdrom,portage,cron -m john</i>
mybox ~ # <i>passwd john</i>
New UNIX password: <comment>设置John的密码</comment>
Retype new UNIX password: <comment>再次输入John的密码</comment>
passwd: password updated successfully
</pre>

</body>
</section>
<section>
<title>最后涉及的配置</title>
<body>

<p>
开始选择最近的镜像，在<path>/etc/make.conf</path>中定义<c>SYNC</c>变量和<c>GENTOO_MIRRORS</c>变量，或者也可以使用<c>mirrorselect</c>。此时你还可以定义并行编译的进程数。
</p>

<pre caption="使用mirrorselect并设置MAKEOPTS">
mybox ~ # <i>emerge mirrorselect</i>
mybox ~ # <i>mirrorselect -i -o >> /etc/make.conf</i>
mybox ~ # <i>mirrorselect -i -r -o >> /etc/make.conf</i>
<comment>（通常，一个较好的值为处理器数加一）</comment>
mybox ~ # <i>echo 'MAKEOPTS="-j2"' >> /etc/make.conf</i>
</pre>

<p>
现在是启用或禁用一些USE参数的好时机。运行<c>emerge -vpe world</c>，列出所有当前已安装的软件包以及它们被启用和禁用的USE参数。编辑<path>/etc/make.conf</path>或使用下列命令定义USE变量：
</p>

<pre caption="查看当前使用的USE参数并启用或禁用其中的某些">
mybox ~ # <i>emerge -vpe world</i>
<comment>（Portage列出软件包和它们的USE参数。作为例子，让我们禁用ipv6和fortran，
并启用unicode）</comment>
mybox ~ # <i>echo 'USE="nptl nptlonly -ipv6 -fortran unicode"' >> /etc/make.conf</i>
</pre>

<p>
新版本的glibc使用<path>/etc/locale.gen</path>来定义语言环境。
</p>

<pre caption="定义语言环境">
mybox ~ # <i>cd /etc</i>
mybox etc # <i>nano -w locale.gen</i>
</pre>

<p>
最后但并非最轻松的，你可能想修改<path>/etc/make.conf</path>中的<c>CFLAGS</c>变量来优化编码，以满足你的特定需要。请注意极少需要一长串的参数列表，那样甚至可能导致系统崩溃。建议通过<c>march</c>选项指定处理器类型并赋上 
<c>-O2 -pipe</c>参数。
</p>

<p>
可能你还想转到 <b>~x86</b>。只有当你能够对付那些脆弱不良的ebuild和软件包时才能这么做。如果你倾向于保持系统的稳定性，请不要添加<c>ACCEPT_KEYWORDS</c>变量。添加<c>FEATURES="parallel-fetch ccache"</c>却是个好主意。
</p>

<pre caption="为make.conf作最后的修改">
mybox etc # <i>nano -w make.conf</i>
<comment>（在CFLAGS中将-march设为你的CPU类型）</comment>
CFLAGS="-O2 -march=<i>athlon-xp</i> -pipe"
<comment>（添加下面一行）</comment>
FEATURES="parallel-fetch ccache"
<comment>（只有清楚自己在干什么才添加下面一行）</comment>
ACCEPT_KEYWORDS="~x86"
</pre>

<p>
可能你会想重编译整个系统两次，以使你所作的最新配置完全生效。这要花很长的时间来完成，而只能得到微小的速度提升。你可以让系统自己随着以后新软件包的发布而逐步完成优化。不过，站在保持系统一致性的立场来看，重编译仍不失为一个好主意。请参考文档<uri link="/doc/zh_cn/gcc-upgrading.xml">Gentoo GCC升级指南</uri>，其中讨论了如何搭建一个具有良好一致性的system和world，以及这样做的好处。
</p>

<p>
只重编译那些因你应用了新的USE参数或受此影响而需要升级的软件包，也要花费不少时间。可能还必须卸载会阻止你升级的软件包。在<c>emerge -vpuD --newuse world</c>的输出中寻找“[blocks <brite>B</brite>     ]”，用<c>emerge -C</c>卸载它们。
</p>

<pre caption="升级软件包">
<comment>（安装ccache）</comment>
mybox etc # <i>emerge ccache</i>

<comment>（请注意转到~x86会导致很多软件包要升级）</comment>
mybox etc # <i>emerge -vpuD --newuse world</i>
<comment>（好好看一看软件包列表和它们的USE参数，
有阻止的包就先卸载，然后启动漫长的过程）</comment>
mybox etc # <i>time emerge -vuD --newuse world</i>
<comment>（（重）编译了79个软件包）</comment>

real  180m13.276s
user  121m22.905s
sys   36m31.472s

<comment>（重编译libtool以避免一些潜在的问题）</comment>
mybox etc # <i>emerge libtool</i>

<comment>（更新配置文件，确保 <b>do not</b> 让etc-update更新你配置好的文件）</comment>
mybox etc # <i>etc-update</i>

<comment>（如果升级了perl，应该执行perl-cleaner脚本）</comment>
mybox etc # <i>time perl-cleaner all</i>
real  1m6.495s
user  0m42.699s
sys   0m10.641s

<comment>（如果升级了python的主要软件包，应该执行python-updater脚本）</comment>
mybox etc # <i>python-updater</i>
</pre>

</body>
</section>
<section>
<title>接下来该做什么</title>
<body>

<p>
想安装服务器应用程序还是一个桌面系统，取决于你打算让你的新Gentoo做什么。以下仅作为一个例子，统计了<c>emerge gnome</c>和<c>emerge kde</c>在~x86系统（按之前的描述安装的）上所花费的时间。两者是在同一起点开始安装的。
</p>

<p>
去看看我们的<uri link="/doc/zh_cn/">文档目录</uri>，研究一下如何安装和配置你挑选的软件。
</p>

<impo>
以下只是举个例子，并不意味着就作为推荐设置。
</impo>

<pre caption="Emerge GNOME">
mybox etc # <i>emerge -vp gnome</i>
<comment>（查看软件包列表和它们的USE参数，
如果需要请编辑make.conf</comment>
mybox etc # <i>nano -w /etc/make.conf</i>
<comment>（定义了以下USE参数）</comment>
USE="nptl nptlonly -ipv6 -fortran unicode svg hal dbus \
     -kde -qt3 -qt4 -arts -eds -esd gnome gstreamer gtk firefox"

mybox etc # <i>time emerge gnome</i>
<comment>（安装了326个软件包）</comment>

real  520m44.532s
user  339m21.144s
sys   146m22.337s
</pre>

<pre caption="Emerge KDE">
mybox etc # <i>emerge -vp kde-meta</i>
<comment>（查看软件包列表和它们的USE参数，
如果需要请编辑make.conf</comment>
mybox etc # <i>nano -w /etc/make.conf</i>
<comment>定义了以下USE参数）</comment>
USE="nptl nptlonly -ipv6 -fortran unicode svg hal dbus \
     kde qt3 qt4 -arts -eds -esd -gnome -gstreamer -gtk -firefox"

mybox etc # <i>time emerge kde-meta</i>
<comment>（安装了391个软件包）</comment>

real  1171m25.318s
user  851m26.393s
sys   281m45.629s
</pre>

</body>
</section>
</chapter>
</guide>



1.1                  xml/htdocs/doc/zh_cn/gnome-config.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/zh_cn/gnome-config.xml?rev=1.1&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/zh_cn/gnome-config.xml?rev=1.1&content-type=text/plain

Index: gnome-config.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">

<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/zh_cn/gnome-config.xml,v 1.1 2007/09/17 17:54:10 r0bertz Exp $ -->
<!-- English CVS version: 1.19 -->

<guide link="/doc/zh_cn/gnome-config.xml" lang="zh_cn">

<title>GNOME配置指南</title>

<author title="作者">
  <mail link="swift@g.o">Sven Vermeulen</mail>
</author>
<author title="编辑">
  <mail link="lars@×××××××.net">Lars Strojny</mail>
</author>
<author title="译者">
 <mail link="joanphan@×××××.com">Hans Joanphan</mail>
</author>
<author title="译者">
 <mail link="tysnoo@×××××.com">叶宝泰</mail>
</author>

<abstract>
GNOME是一个常用的桌面环境。本指南尝试描述所有关于GNOME的方方面面，包括安装、配置、使用……
</abstract>

<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>

<version>1.16</version>
<date>2007-07-05</date>

<chapter>
<title>GNOME是什么？</title>
<section>
<title>项目</title>
<body>

<p>
<uri link="http://www.gnome.org">GNOME</uri>是一个Unix/Linux桌面套件及开发平台，GNOME项目是专注于GNOME开发的自由软件项目。<uri link="http://foundation.gnome.org">GNOME基金会</uri>负责协调GNOME项目开发和其他相关事务。
</p>

</body>
</section>
<section>
<title>软件</title>
<body>

<p>
GNOME是一个桌面环境，也是一个开发平台。这份自由软件是众多行业领军者的首选桌面。他同时面向商业用户、家庭用户和开发人员。
</p>

</body>
</section>
<section>
<title>社区</title>
<body>

<p>
与任何一款大型自由软件项目一样，GNOME拥有广泛的用户和开发群。<uri link="http://www.gnomedesktop.org">Footnotes</uri>中为用户提供GNOME桌面的新闻，<uri link="http://planet.gnome.org">GnomePlanet</uri>面向热心人/贡献者的，而<uri link="http://developer.gnome.org">Developer.Gnome.Org</uri>是面向GNOME开发人员的。
</p>

</body>
</section>
</chapter>
<chapter>
<title>安装GNOME</title>
<section>
<title>您需要什么？</title>
<body>

<p>
开始安装GNOME之前，您可能要编辑一下USE变量。确保你的/etc/make.conf中列出的USE变量包含<c>gtk</c>和<c>gnome</c>。如果您想支持<c>hald</c>——硬件抽象层守护进程，请添加<c>hal</c>到你的USE标记中。USE变量<c>avahi</c>为GNOME提供DNS检测（类似Mac OS X下的Rendevouz）。如果您不想支持KDE（另一个大型桌面环境），去掉<c>qt*</c>、<c>arts</c>和<c>kde</c>变量。
</p>

<pre caption="/etc/make.conf中USE范例">
USE="-qt3 -qt4 -arts -kde gtk gnome hal avahi"
</pre>

<p>
您可以添加<c>branding</c>USE标记来获得一个可爱的“Gentoo牌”启动画面，取代默认的Gnome启动画面：
</p>

<pre caption="启用Gentoo品牌">
# <i>echo "gnome-base/gnome-session branding" &gt;&gt; /etc/portage/package.use</i>
</pre>

<p>
完成之后，通过emerge <c>gnome</c>来开始安装GNOME：
</p>

<pre caption="安装GNOME">
# <i>emerge gnome</i>
</pre>

<p>
您也可以选择使用<c>gnome-light</c>进行最小化的Gnome安装：
</p>

<pre caption="安装一个最小化的GNOME环境">
# <i>emerge gnome-light</i>
</pre>

<p>
这将花费一点时间，因此您可以先读一读从前妈妈给你买的而你却从未翻过的那些书本。装完了？很好，现在更新你的环境变量：
</p>

<pre caption="更新环境变量">
# <i>env-update &amp;&amp; source /etc/profile</i>
</pre>

<p>
如果您认真观察前面<c>emerge</c>命令的输出，会注意到它建议使用<c>gamin</c>让nautilus和gnome-vfs监视文件的变动：
</p>

<pre caption="安装gamin，一个文件变更监视器">
# <i>emerge gamin</i>
</pre>

<impo>
如果您是从<c>fam</c>（一个老旧过时的文件监视器）转换到<c>gamin</c>，那么您必须从所有的启动级别中删除<c>famd</c>然后将它卸载：
</impo>

<pre caption="可选：从fam转换到gamin">
# <i>rc-update del famd</i>
# <i>emerge --unmerge app-admin/fam</i>
</pre>

<p>
接下来我们做完剩余的服务。
</p>

<pre caption="将hald和avahi-dnsconfd添加到默认启动级别">
# <i>/etc/init.d/hald start</i>
# <i>rc-update add hald default</i>

# <i>/etc/init.d/avahi-dnsconfd start</i>
# <i>rc-update add avahi-dnsconfd default</i>
</pre>

</body>
</section>
<section>
<title>第一印象</title>
<body>

<p>
让我们先看一看刚刚所安装的。退出root shell并以普通用户登录。我们将配置一下会话，然后发出<c>startx</c>命令启动GNOME（参考<uri link="/doc/zh_cn/xorg-config.xml">X服务器配置指南</uri>中的<uri link="/doc/zh_cn/xorg-config.xml#using_startx">使用startx</uri>）：
</p>

<pre caption="设定GNOME为默认桌面环境">
$ <i>echo "exec gnome-session" &gt; ~/.xinitrc</i>
</pre>

<p>
现在请执行<c>startx</c>以启动图形环境：
</p>

<pre caption="启动GNOME">
$ <i>startx</i>
</pre>

<p>
如果一切正常，您将受到GNOME的欢迎问候。祝贺你。现在让我们看看如何配置GNOME以迎合您的需求。
</p>

</body>
</section>
</chapter>
<chapter>
<title>配置GNOME</title>
<section>
<title>GNOME的图形登录管理器</title>
<body>

<p>
如果您想让GNOME显示管理器（GDM）在开机时自动运行（那样就可以通过图形界面登录），必须将<c>xdm</c>启动脚本添加到默认的运行级别：
</p>

<pre caption="将xdm添加到默认运行级别">
# <i>rc-update add xdm default</i>
</pre>

<p>
现在编辑<path>/etc/conf.d/xdm</path>并修改DISPLAYMANAGER变量。
</p>

<pre caption="编辑/etc/conf.d/xdm">
DISPLAYMANAGER="gdm"
</pre>

<p>
如果您现在重启，GNOME显示管理器就会提示您输入用户名和密码，并且将默认使用GNOME作为桌面环境（尽管肯定会有一个选项让您可以从<path>/usr/share/xsessions/</path>中选择另一个可用的）。这样的话，如果您使用GDM，就不需要编辑<path>~/.xinitrc</path>了。
</p>

<p>
要使用<c>hald</c>的功能，只需启动<c>gnome-volume-manager</c>然后编辑它的选项。并且，需要将您的用户添加到<c>plugdev</c>组。
</p>

</body>
</section>
</chapter>
</guide>



1.1                  xml/htdocs/doc/zh_cn/gpm.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/zh_cn/gpm.xml?rev=1.1&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/zh_cn/gpm.xml?rev=1.1&content-type=text/plain

Index: gpm.xml
===================================================================
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">

<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/zh_cn/gpm.xml,v 1.1 2007/09/17 17:54:10 r0bertz Exp $ -->
<!-- English CVS version: 1.4 -->

<guide link="/doc/zh_cn/gpm.xml" lang="zh_cn">
<title>在命令行下用鼠标</title>

<author title="作者">
  <mail link="nightmorph@g.o">Joshua Saddler</mail>
</author>
<author title="译者">
  <mail link="jjj3112000@×××.com">Zezhou Jiang</mail>
</author>

<abstract>
这个指南将给你展示如何在命令行界面下建立并使用GPM（the General Purpose Mouse server）。这个在你新安装Gentoo或者你的系统无法或不用X服务时是非常有用的。
</abstract>

<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>

<version>1.2</version>
<date>2006-02-17</date>

<chapter>
<title>得到GPM</title>
<section>
<body>

<p>
如果你刚装好Gentoo，你很可能还没有把你的鼠标设置成能在命令行界面下工作。或者可能你不用或不需要X服务，但是你仍需要使用鼠标。解决方法很简单：<c>gpm</c>，通用目的鼠标服务。
</p>

<p>
首先，你需要得到GPM：
</p>

<pre caption="获得GPM">
# <i>emerge gpm</i>
</pre>

<p>
你可能在编译的时候会注意到几条有关配置服务的警告信息。你必须在启动GPM前进行配置。
</p>

</body>
</section>
</chapter>

<chapter>
<title>配置GPM</title>
<section>
<body>

<p>
在你能够使用GPM前，你必须取消几条有关你鼠标的位置和协议的内容的注释。你可以编辑GPM的配置文件来做这个：
</p>

<pre caption="建立GPM">
# <i>nano /etc/conf.d/gpm</i>
</pre>

<p>
对于我来说，我有一个在<path>/dev/input/mouse0</path>的鼠标。所以，我解除了<path>/dev/input/mice</path>的注释，因为这是一个为系统中的所有鼠标准备的一个通用设备和协议。试着在使用<path>/dev/psaux</path>之前使用<path>/dev/input/mice</path>，因为前者在最新的2.6内核中已经不被推荐而且被禁用了。如果<path>/dev/input/mice</path>失败了，然后回去试试别的设备。这是我的例子<path>/etc/conf.d/gpm</path>：
</p>

<pre caption="GPM配置实例">
<comment>（请取消你的鼠标的类型和适当的MOUSEDEV的行的注释）</comment>

#MOUSE=ps2
MOUSE=imps2
#MOUSEDEV=/dev/psaux
MOUSEDEV=/dev/input/mice
</pre>

<p>
如果你有一个滚轮鼠标，你将会希望用imps2协议，所以取消那行的注释。如果imps2和ps2都无法为你工作，请参考GPM信息页（<c>info gpm</c>）来找到其他可尝试的协议。同时，如果你想要在终端中点击超链接去导航到一个网站，那么跟着<c>/etc/conf.d/gpm</c>里的提示是一个好主意：
</p>

<pre caption="其他选项">
<comment>（如果你希望GPM能理解URL中使用的字符集或里面含有~或者:字符的名字，请取消这一行的注释。把它开启将会是一个好主意！）</comment>

APPEND="-l \"a-zA-Z0-9_.:~/\300-\326\330-\366\370-\377\""
</pre>

<p>
剩下的conf.d文件包含了一些你使用鼠标服务的其他建议；解除各种你所需要的选项的注释。请参见<c>man gpm</c>来得到更多的信息。
</p>

</body>
</section>
</chapter>

<chapter>
<title>运行GPM</title>
<section>
<body>

<p>
现在你的鼠标服务已经安装并配置好了，现在是时间来使用它了：
</p>

<pre caption="GPM的init脚本">
# <i>/etc/init.d/gpm start</i>
</pre>

<p>
你应该能看见一个块状的指针出现。记住只有root才能运行GPM的init脚本。然而，要避免每次你启动一个新对话的时候都要运行<c>su</c>然后再运行脚本，为什么不在你每次开启你的电脑时都启动GPM呢？
</p>

<pre caption="把GPM加入到默认运行程级">
# <i>rc-update add gpm default</i>
</pre>

<p>
现在，无论何时你启动你的电脑，每次你到登陆提示时都会被命令行鼠标迎接。即使你不用root用户登陆，鼠标服务仍然会继续运行。
</p>

</body>
</section>
</chapter>

<chapter>
<title>使用GPM</title>
<section>
<title>复制和粘贴</title>
<body>

<p>
用鼠标服务来复制和粘贴大块的文本会十分简单。只要简单地用鼠标左键把文本高亮标记起来（当你放开鼠标时它仍会保留高亮），如果你希望的话，切换到一个不同的终端，用鼠标指针定位，然后按下鼠标中键来在你的指针所指的位置粘贴文本。记住，你也可以在不离开你开启的终端时使用复制粘贴。这将使发送显示出的错误信息到<uri link="http://forums.gentoo.org">Gentoo Forums</uri>变得及其简单。
</p>

</body>
</section>
<section>
<title>文本模式浏览和GPM</title>
<body>

<p>
如果你有一个信息在一个屏幕上，还有一个文本浏览器在另一个屏幕上，你可以高亮它然后复制那个错误信息，然后切换到另一个终端，左键点击适当的文本输入框来选择它，然后按下鼠标中键。啊，你的错误信息现在已经贴到论坛上了。
</p>

<p>
虽然讨论文本浏览器有些超出指南的范围，但是不可避免地用户会需要找一个兼容的命令行浏览器。虽然<c>lynx</c>可能是最老也是构建最好的浏览器，它的界面却没有鼠标支持和识别。相反，试试用<c>links</c>吧，它有出色的鼠标整合。
</p>

<pre caption="得到links">
# <i>emerge links</i>
</pre>

<p>
这个指南包括了如何在命令行使用鼠标的指导。祝你使用鼠标愉快！
</p>

</body>
</section>
</chapter>
</guide>



1.1                  xml/htdocs/doc/zh_cn/grub-error-guide.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/zh_cn/grub-error-guide.xml?rev=1.1&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/zh_cn/grub-error-guide.xml?rev=1.1&content-type=text/plain

Index: grub-error-guide.xml
===================================================================
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">

<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/zh_cn/grub-error-guide.xml,v 1.1 2007/09/17 17:54:10 r0bertz Exp $ -->
<!-- English CVS version: 1.14 -->

<guide link="/doc/zh_cn/grub-error-guide.xml" lang="zh_cn">
<title>Gentoo Grub错误集锦</title>

<author title="审校">Hartwig Brandl</author>
<author title="编辑">
  <mail link="deathwing00@g.o">Ioannis Aslanidis</mail>
</author>
<author title="编辑">
  <mail link="swift@g.o">Sven Vermeulen</mail>
</author>

<abstract>
这个错误集锦的目的在于列出人们可能会遇到的GRUB的问题和错误。所有这些解决方案是由很多Gentoo论坛中的使用者而获得的。
</abstract>

<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>

<version>1.8</version>
<date>2005-12-21</date>

<chapter>
<title>篇首语</title>

<section>
<title>致谢</title>
<body>

<p>
感谢<uri link="http://forums.gentoo.org/profile.php?mode=viewprofile&amp;u=18420">Earthwings</uri>，<uri link="http://forums.gentoo.org/profile.php?mode=viewprofile&amp;u=39305">penetrode</uri>，<uri link="http://forums.gentoo.org/profile.php?mode=viewprofile&amp;u=41638">loyaltonone</uri>，<uri link="http://forums.gentoo.org/profile.php?mode=viewprofile&amp;u=4980">pilla</uri>，<uri link="http://forums.gentoo.org/profile.php?mode=viewprofile&amp;u=3139">airhead</uri>，<uri link="http://forums.gentoo.org/profile.php?mode=viewprofile&amp;u=13816">nephros</uri>，<uri link="http://forums.gentoo.org/profile.php?mode=viewprofile&amp;u=25859">yamakawa</uri> 和其他所有人在原<uri link="http://forums.gentoo.org/viewtopic.php?t=122656">帖</uri>上发表的建议。
</p>

</body>
</section>

<section>
<title>免责声明</title>
<body>

<p>
示例中提供的仅是例子，请务必确保根据你的系统的实际情况改变分区号及类似信息。遵照本文档中所提供的解决方案须自己承担风险。
</p>

</body>
</section>
</chapter>

<chapter>
<title>Grub loading, please wait..</title>
<section>
<title>状况</title>
<body>

<pre caption="Grub输出">
GRUB loading stage 1.5
GRUB loading, please wait...
</pre>

<p>
出现这段信息之后，系统停止。如果你试图用grub软盘引导系统，这种问题就会消失。
</p>

</body>
</section>
<section>
<title>解决方案</title>
<body>

<p>
根据<uri link="http://forums.gentoo.org/profile.php?mode=viewprofile&amp;u=3134">The_Bell</uri>你可以改变你BIOS中的引导命令。
</p>

<p>
调整你的BIOS使它不要首先从软盘启动。
</p>

<p>
<uri link="http://forums.gentoo.org/profile.php?mode=viewprofile&amp;u=39305">penetrode</uri>上说这可能是由于错误的CFLAGS设定引起的。尽管现在的grub ebuild过滤掉了<c>-fstack-protector</c>，如果其他的不起作用运用干净的CFLAG重新编译grub也不会有问题。
</p>

<pre caption="使用干净的CFLAG重构GRUB">
# <i>CFLAGS="-O2 -march=i686 -fomit-frame-pointer -pipe" emerge grub</i>
</pre>

</body>
</section>
</chapter>

<chapter>
<title>GRUB错误12</title>
<section>
<title>状况</title>
<body>

<pre caption="Grub输出">
12：无效设备请求
</pre>

<p>
如果设备字符串语法正确也会返回这个错误，另外这种错误的出现又不属于任何其它的错误。
</p>

</body>
</section>
<section>
<title>解决方案</title>
<body>

<p>
当你通过交互命令在你的引导设备中安装grub时,你是否在grub命令提示符后执行下面两行呢？
</p>

<pre caption="交互安装命令">
grub&gt; <i>root (hd0,0)</i>
grub&gt; <i>setup (hd0)</i>
</pre>

<p>
(hd0,0)应该用你的引导分区替换，而(hd0)用你选择的HDD替换。谨记(hd0)将安装引导管理器到你的第一块硬盘（即主引导盘）的主引导记录(MBR)中。
</p>

</body>
</section>
</chapter>

<chapter>
<title>Grub错误15</title>
<section>
<title>状况</title>
<body>

<p>
这个错误可能会发生在GRUB配置的两个不同阶段，或是在初始化配置期间（将GRUB安装在主引导记录中）抑或是在引导系统和试图连接Linux时（也或者是其它情况）。
</p>

<pre caption="Grub输出-初始化配置">
grub&gt; <i>root (hd0,0)</i>
 Filesystem type is xfs, partition type 0x83

grub&gt; <i>setup (hd0)</i>
 Checking if "/boot/grub/stage1" exists... no
 Checking if "/grub/stage1" exists... no

Error 15: File not found
</pre>

<pre caption="Grub输出──引导一条记录">
Booting 'gentoo Linux'

root (hd0,0)
Filesystem type is ext2fs, partition type 0x83
kernel (hd0,0)/boot/kernel-2.4.20 root=/dev/hda3 vga=792

Error 15: File not found
Press any key to continue...
</pre>

</body>
</section>
<section>
<title>解决方案──初始化配置</title>
<body>

<p>
如果特定的文件名没有找到而其它的（诸如磁盘和分区信息）是正确的将返回这一错误。
</p>

<p>
幸运的是，这条错误标明了缺少一个内核映像文件。你要确保你的引导分区中存在以上提到的相关的文件。
</p>

<p>
为了找到你的内核的精确命名，从一个安装光盘中启动，挂载你的根分区和引导分区（如果可用的话）。然后，切换到你的Gentoo系统并列出所有可用的文件,看哪一个内核映像是你要启用的：
</p>

<pre caption="调整存在的内核映像">
# <i>cd /boot</i>
# <i>ls</i>
</pre>

<p>
这将列出所有在你的引导分区所获得的内核。如果你的内核不存在，请确保你已经编译了一个内核（用<c>genkernel</c>或是手工编译）：
</p>

<pre caption="重新编译内核">
# <i>cd /usr/src/linux/</i>
# <i>make menuconfig</i>
# <i>make</i>
</pre>

<p>
并将它复制到你的引导分区：
</p>

<pre caption="复制内核">
# <i>cp /usr/src/linux/arch/i386/boot/bzImage /boot</i>
</pre>

<p>
调整内核的名字使其和你的<path>grub.conf</path>文件中定义的相同。另外还要确保你的<path>grub.conf</path>文件中关于<c>内核</c>的行关联到那个分区（相对的或绝对的）。
</p>

<p>
另外一个报告的错误是BIOS忽略了内核或grub stages所在的盘。除此之外，grub保存它stages的分区不应使用RAID-5（或其它的剥离技术）设定。
</p>

</body>
</section>
<section>
<title>解决方案──引导一个选项</title>
<body>

<p>
首先，调整你所用的<c>root</c>和<c>setup</c>行是正确的。
</p>

<p>
如果你确定它们是可用的，那么你<e>可能</e>用了有缺陷的GRUB版本（0.93.20031222）。请升级你的Portage树或是屏蔽此版的grub：
</p>

<pre caption="屏蔽Grub">
<comment>（在chrooted环境下执行这些）</comment>
# <i>echo "=sys-boot/grub-0.93.20031222" &gt;&gt; /etc/portage/package.mask</i>
# <i>emerge grub -p</i>
</pre>

<p>
你同样可以用由GRUB作者所推荐的<c>grub-install</c>脚本：
</p>

<pre caption="运用grub-install">
<comment>(如果你使用一个单独的引导分区你则还需要--root-directory选项，否则就不用管它）</comment>
# <i>grub-install --root-directory=/boot /dev/hda</i>
</pre>

<p>
如果这些都失败了，你的引导分区可能已经损坏。请检查分区错误：
</p>

<pre caption="检查分区错误">
<comment>（确保引导分区，在此处是/dev/hda1，</comment>
# <i>fsck -y /dev/hda1</i>
</pre>

</body>
</section>
</chapter>

<chapter>
<title>Grub错误17</title>
<section>
<title>状况</title>
<body>

<pre caption="Grub输出">
root (hd0,0)
filesystem type unknown partition type 0x7

Error 17 : Cannot mount selected partition
</pre>

</body>
</section>
<section>
<title>解决方案</title>
<body>

<p>
如果分区请求存在而文件系统类型不能被GRUB识别将返回此错误信息。
</p>

<p>
请一定检查你的root(x,y)在你的grub.conf中已经设置。
</p>

<p>
另外，如果你要引导Windows，请确保你的<path>grub.conf</path>文件中有<c>root (hdX,Y)</c>（或<c>rootnoverify (hdX,Y)</c>）和<c>chainloader (hdX,Y)+1</c>。
</p>

</body>
</section>
</chapter>

<chapter>
<title>Grub错误18</title>
<section>
<title>状况</title>
<body>

<pre caption="Grub输出">
kernel (hd1,4)/bzImage root=/dev/hdb7

Error 18: Selected cylinder exceeds max supported by BIOS
</pre>

</body>
</section>
<section>
<title>解决方案</title>
<body>

<p>
当试图读取的线性块地址在BIOS可转换区之外时返回这个错误。这通常出现在如果你的硬盘大于BIOS可以控制（旧机器上(E)IDE硬盘的512MB和通常状况下高于8G）。
</p>

<p>
试试升级你的BIOS或将你的引导分区移动到前面（或至少到恰当的范围内）。
</p>

</body>
</section>
</chapter>

<chapter>
<title>GRUB GRUB GRUB GRUB GRUB ...</title>
<section>
<title>状况</title>
<body>

<pre caption="Grub输出">
GRUB GRUB GRUB GRUB GRUB GRUB GRUB GRUB GRUB GRUB GRUB GRUB GRUB GRUB GRUB
  GRUB GRUB GRUB GRUB GRUB GRUB GRUB GRUB GRUB GRUB GRUB GRUB GRUB GRUB GRUB
...
</pre>

</body>
</section>
<section>
<title>解决方案</title>
<body>

<p>
通过<uri link="http://forums.gentoo.org/profile.php?mode=viewprofile&amp;u=3139">airhead</uri>可以知道这可能是由让你的bios自动检测你的硬盘引起的。试试将你的bios选项设定成User Type HDD。
</p>

<p>
另外一种可能是你将Grub装在主引导分区上和试图将它重新安装（例如是因为更换硬盘）但是运用了错误的<c>setup</c>和<c>root</c>命令。
</p>

</body>
</section>
</chapter>

<chapter>
<title>检查设备推测BIOS驱动。这可能要花费很长时间。</title>
<section>
<title>状况</title>
<body>

<p>
当你试图安装grub，它在显示下面几行后挂起：
</p>

<pre caption="Grub输出">
# <i>grub</i>

Probing devices to guess BIOS drives. This may take a long time.
</pre>

</body>
</section>
<section>
<title>解决方案</title>
<body>

<p>
一个报告的原因是由外来的硬盘设备配置文件引起的，如在一条线上有多个ultra/non-ultra DMA硬盘。
</p>

</body>
</section>
</chapter>

<chapter>
<title>安装Grub时，系统挂起</title>
<section>
<title>状况</title>
<body>

<p>
安装Grub时，系统挂起
</p>

<pre caption="Grub输出">
# <i>grub</i>
<comment>（在这一步，安装停止）</comment>
</pre>

</body>
</section>
<section>
<title>解决方案</title>
<body>

<p>
如果你没有软盘设备，你是否使用了--no-floppy开关？
</p>

<pre caption="使用--no-floppy开关安装grub">
# <i>grub --no-floppy</i>
</pre>

</body>
</section>
</chapter>

<chapter>
<title>Uncompressing Linux... Ok, booting the kernel.</title>
<section>
<title>状况</title>
<body>

<p>
出现下面的行后系统挂起：
</p>

<pre caption="Linux输出">
Uncompressing Linux... Ok, booting the kernel.
</pre>

</body>
</section>
<section>
<title>解决方案</title>
<body>

<p>
严格来讲，这并不是grub错误。一种可能的原因是ACPI没有正常工作但是在内核中却已经将它启用。请尝试在bios中禁用它。
</p>

</body>
</section>
</chapter>

<chapter>
<title>Grub只显示一个Grub提示符</title>
<section>
<title>状况</title>
<body>

<p>
当引导系统时，返回一个grub命令提示符而非一个你在<path>grub.conf</path>文件中所定义的选单。
</p>

</body>
</section>
<section>
<title>解决方案</title>
<body>

<p>
挂载你的引导分区并检查<path>grub/grub.conf</path>，如果它存在。
</p>

<pre caption="挂载和检查">
# <i>mount /dev/hda1 /mnt/gentoo/boot</i>
# <i>cat /mnt/gentoo/boot/grub/grub.conf</i>
</pre>

<p>
同时确定 <path>menu.lst</path> 的符号链接存在：
</p>

<pre caption="检查符号链接">
# <i>ls -l /mnt/gentoo/boot/grub/menu.lst</i>
lrwxrwxrwx  1 root root 9 Mar  7 14:00 /mnt/gentoo/boot/grub/menu.lst -> grub.conf
</pre>

<p>
如果没有，请重新建立符号链接：
</p>

<pre caption="重新建立menu.lst的符号链接">
# <i>cd /mnt/gentoo/boot/grub</i>
# <i>ln -snf grub.conf menu.lst</i>
</pre>

<p>
如果是这种情况，请重新安装grub：
</p>

<pre caption="重新安装Grub">
<comment>（在chrooted环境下运行）</comment>
# <i>grub-install --root-directory=/boot /dev/hda</i>
</pre>

</body>
</section>
</chapter>

<chapter>
<title>在/boot/boot找不到设备：找不到或没有块设备</title>
<section>
<title>状况</title>
<body>

<p>
当运行<c>grub-install</c>安装GRUB时，获得以下错误：
</p>

<pre caption="Grub输出">
# <i>grub-install --root-directory=/boot /dev/hda</i>
在/boot/boot找不到设备：找不到或没有块设备
</pre>

</body>
</section>
<section>
<title>解决方案</title>
<body>

<p>
检查你是否忘记了以下的：
</p>

<pre caption="更新mtab文件">
# <i>cp /proc/mounts /etc/mtab</i>
</pre>

</body>
</section>
</chapter>

<chapter>
<title>在Grub菜单中点击回车后系统重新启动</title>
<section>
<title>状况</title>
<body>

<p>
系统启动时在Grub菜单中点击回车，系统重新启动。
</p>

</body>
</section>
<section>
<title>解决方案</title>
<body>

<p>
请尝试禁用内核中的帧缓冲支持。如果这样做不起作用，禁用APM和ACPI。
</p>

</body>
</section>
</chapter>

<chapter>
<title>在Grub菜单中点击回车，出现黑屏</title>
<section>
<title>状况</title>
<body>

<p>
系统引导过程中，在Grub菜单中点击回车，出现黑屏，但是系统却仍有响应（例如，你的numlock指示灯还可切换）。
</p>

</body>
</section>
<section>
<title>解决方案</title>
<body>

<p>
禁用帧缓冲（通常是从你的<path>grub.conf</path>中移除<c>vga=XYZ</c>）并检查你的内核配置中的处理器架构。
</p>

</body>
</section>
</chapter>

<chapter>
<title>Grub Image缺失</title>
<section>
<title>状况</title>
<body>

<p>
系统启动时看不到Gentoo闪屏。
</p>

</body>
</section>
<section>
<title>解决方案</title>
<body>

<p>
首先检查<path>grub.conf</path>中的闪屏文件确实存在。如果存在，再检查grub ebuild。可能是你所用的版本的闪屏图像的补丁被注释掉了。
</p>

</body>
</section>
</chapter>

<chapter>
<title>选择Windows选项后，系统从第二个硬盘中启动Windows失败，</title>
<section>
<title>状况</title>
<body>

<p>
选择了Windows选项以后，系统拒绝引导而且没有明显的原因。
</p>

</body>
</section>
<section>
<title>解决方案</title>
<body>

<p>
<uri link="http://forums.gentoo.org/profile.php?mode=viewprofile&amp;u=14595">cyrillic</uri>提示我们你可以用不同的命令"映射"你的硬盘像下面一样改变<path>grub.conf</path>中的Windows选项：
</p>

<pre caption="硬盘映射">
title Windows XP
  map (hd0) (hd1)
  map (hd1) (hd0)
  chainloader (hd1,0)+1
</pre>

</body>
</section>
</chapter>

<chapter>
<title>Grub segfaults when trying to install</title>
<section>
<title>状况</title>
<body>

<p>
这种状况经下面的解释说是只与现在将grub安装到引导分区的grub-0.95.x相关联的。
</p>

<pre caption="安装Grub">
grub&gt; root (hd0,0)

grub&gt; setup (hd0)

Segmentation fault
</pre>

</body>
</section>
<section>
<title>解决方案</title>
<body>

<p>
与此相关的是一个知名bug而且在grub 0.96中已经确定。同时grub 0.94 r1和grub 0.94 r2应该能正常工作。如果它同样失败了，你可以试着emerge已经在amd64下稳定和在x86下还不稳定（~x86）的grub-static。要获得附加信息请参考bug <uri link="http://bugs.gentoo.org/show_bug.cgi?id=79378">#79378</uri>。
</p>

</body>
</section>
</chapter>

</guide>



1.1                  xml/htdocs/doc/zh_cn/lvm2.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/zh_cn/lvm2.xml?rev=1.1&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/zh_cn/lvm2.xml?rev=1.1&content-type=text/plain

Index: lvm2.xml
===================================================================
<?xml version='1.0' encoding="utf-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">

<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/zh_cn/lvm2.xml,v 1.1 2007/09/17 17:54:10 r0bertz Exp $ -->
<!-- English CVS version: 1.22 -->

<guide link="/doc/zh_cn/lvm2.xml" lang="zh_cn">
<title>Gentoo LVM2安装指南</title>

<author title="作者">
  <mail link="avi@×××××××××××××××.com">Avi Schwartz</mail>
</author>
<author title="Contributor">
  <mail link="rajiv@g.o">Rajiv Manglani</mail>
</author>
<author title="编辑">
  <mail link="neysx@g.o">Xavier Neys</mail>
</author>
<author title="译者">
  <mail link="palatis@××××××.tw">Victor Tseng</mail>
</author>
<author title="译者">
  <mail link="zm3345@×××××.com">Zhou Mi</mail>
</author>

<abstract>
该指南讲述该如何在你的Gentoo系统中使用逻辑卷管理器第二版（LVM2）
</abstract>

<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>

<version>2.5</version>
<date>2007-02-26</date>

<chapter>
<title>简介</title>
<section>
<body>

<p>
本指南使用两个IDE硬盘做范例。这表示你极可能需要根据自己的需求，对磁盘、分区名以及分区大小等信息做些更改。
</p>

<warn>
本文并不想成为一篇LVM2学习指南。它只是一个小笔记，作为<uri link="/doc/zh_cn/handbook/handbook-x86.xml?part=1">Gentoo安装手册（第一部分）</uri>的补充。请<e>务必</e>在你动手安装之前<e>阅读</e>Gentoo安装手册。
</warn>

<note>
完整的LVM HOWTO在这里：<uri>http://tldp.org/HOWTO/LVM-HOWTO</uri>
</note>

</body>
</section>
<section>
<title>系统需求</title>
<body>

<p>
如果你是全新安装gentoo系统，你需要有一张带LVM2支持的启动光盘，如Gentoo安装光盘。你可以在我们<uri link="/main/en/mirrors.xml">镜像站</uri>的<path>/releases/x86/current/installcd</path>下找到x86架构的Gentoo安装光盘。在其他的架构下也应该会有很好的支持。
</p>

<p>
如果你在一个有着空闲硬盘空间、正在运行着的系统上安装LVM2，你需要启用LVM2模块（<path>dm-mod</path>）。这个模块已内置于<path>gentoo-sources</path>。如何编译你的内核以便LVM2能正常工作，会在稍后提及。
</p>

<p>
并非所有Gentoo提供的2.4内核都支持LVM2！
</p>

<warn>
在2005.0安装光盘中的LVM2被错误地动态链接到一个函数库（libgpm），而这个函数库位于<path>/usr</path>。这表示，你不能将<path>/usr</path>放在LVM环境中。请更新到最新版本，或安装2.0.33（沒有-r1），它们都是静态链接的版本。
</warn>

</body>
</section>
<section>
<title>分区</title>
<body>

<p>
在我们的范例系统中有两个IDE硬盘，它们的分区是这样的：
</p>

<ul>
  <li>/dev/hda1 -- /boot</li>
  <li>/dev/hda2 -- (交换分区)</li>
  <li>/dev/hda3 -- /</li>
  <li>将被用作LVM2</li>
  <li>将被用作LVM2</li>
</ul>

<impo>
请特别注意分区名字，毕竟a和b常常被看错，那些数字也很容易被混淆。一个小失误将导致某个分区被错误地覆盖掉。我们警告过你了！
</impo>

<p>
ok，开始吧……
</p>

</body>
</section>
</chapter>

<chapter>
<title>安装</title>
<section>
<body>

<p>
先照着安装手册做，直到<e>第4章──准备磁盘</e>
</p>

<p>
使用安装手册上提及的<c>fdisk</c>，不过将分区划分成上面范例中的那样。它<e>只是个范例</e>，请调整它以符合自己的需求。
</p>

<p>
创建建一个小小的<path>/boot</path>分区(hda1)。在这个例子中，<path>/boot</path>不会被LVM2管理。这个分区里存放着内核和引导程序。相信一个64M的分区够存放不少内核的了。
</p>

<p>
创建一个交换分区（hda2）。
</p>

<p>
创建根（root）分区（hda3）。如果你有兴趣尝试把根分区到LVM下管理（虽然我们不建议这样做），你可以参考本文末尾列出的资源。那里有一个mini-howto会告诉该如何做。如果将<path>/opt /usr /home /var</path>和<path>/tmp</path>都放在LVM2卷组（vg）中的话，根分区也不用太大。在我们的例子中，1GB就足够了。
</p>

<note>
我们<b>不建议</b>将下列目录放在LVM2分区上：<path>/etc /lib /mnt /proc /bin /sbin /dev /root</path>。这样做的好处是，当有什么糟糕的事情（系统严重受损，但是对root来说还有点用）发生的时候，你还可以登入系统。
</note>

<p>
假如<path>/boot</path>，交换分区和根分区还没能用完整个硬盘，可以创建第四个分区，并把它的类型设为8e（Linux LVM）。如果你还有其他供LVM使用的硬盘，请在每个硬盘上都创建一个分区，并把分区类型设为8e。
</p>

<note>
由于现在的硬盘都非常大，你也许想将你的硬盘分成几个小分区，而不是一个大的，然后全部添加到LVM2卷组。LVM2让分区扩充容量变得很简单，所以你可以留下一些未配置的分区，天知道你以后会不会在LVM2以外的地方用到它们。简而言之，在还没有确定拿分区做什么用之前，别先把它们用光了。举例来说吧，我们的一位投稿者就将他的160GB硬盘分成了8个20GB的分区来用。
</note>

<p>
按照安装手册的步骤，建立分区<path>/dev/hda1</path>和<path>/dev/hda3</path>的文件系统，并建立且激活交换分区<path>/dev/hda2</path>。
</p>

<p>
加载LVM2模块<path>dm-mod</path>。
</p>

<pre caption="加载LVM2模块">
# <i>modprobe dm-mod</i>
</pre>

<p>

你可能要在扫描并激活LVM之前先编辑<path>/etc/lvm/lvm.conf</path>文件，把一些设备排除在外。因为默认情况下，LVM2会扫描所有的设备，包括会产生错误信息的光驱。在下面的例子中，我们替换掉了允许扫描所有设备的那行，改为除两个IDE硬盘外，不扫描其他任何设备。
</p>

<pre caption="起用LVM">
<comment>（避免扫描除硬盘外的所有设备）</comment>
# <i>nano -w /etc/lvm/lvm.conf</i>
<comment>（查找下面的行）</comment>
    filter = [ "a/.*/" ]
<comment>（用下面内容来替换，保证只扫描
/dev/hda和/dev/hdb）</comment>
    filter = [ "a|/dev/hd[ab]|", "r/.*/" ]
<comment>（保存文件并退出nano）</comment>
# <i>vgscan</i>
  Reading all physical volumes.  This may take a while...
  No volume groups found
<comment>（启用之前创建的卷组）</comment>
# <i>vgchange -a y</i>
</pre>

<p>
准备磁盘分区
</p>

<pre caption="准备磁盘分区">
# <i>pvcreate /dev/hda4 /dev/hdb1</i>
  No physical volume label read from /dev/hda4
  Physical volume "/dev/hda4" successfully created
  No physical volume label read from /dev/hdb1
  Physical volume "/dev/hdb1" successfully created
</pre>

<p>
创建一个卷组。卷组是一些物理单元的逻辑集合。
</p>

<p>
范例中<path>/dev/hda1</path>，<path>/dev/hda2</path>和<path>/dev/hda3</path>分别是<path>/boot</path>，交换分区和根分区。所以我们需要合并的是<path>/dev/hda4</path>和<path>/dev/hdb1</path>。尽管这用一个命令就可以完成，作为示范，我们还是先创建一个卷组，然后再扩充它。
</p>

<pre caption="创建和扩充卷组">
<comment>（创建一个名为vg的卷组）</comment>
# <i>vgcreate vg /dev/hda4</i>
  /etc/lvm/backup: fsync failed: Invalid argument <comment>（忽略此警告）</comment>
  Volume group "vg" successfully created
<comment>（扩充已有的卷组）</comment>
# <i>vgextend vg /dev/hdb1</i>
  /etc/lvm/backup: fsync failed: Invalid argument <comment>（再次忽略这个警告，以后也请继续忽略）</comment>
  Volume group "vg" successfully extended
</pre>

<p>
创建逻辑卷。逻辑卷类似于在非LVM2环境中用fdisk创建的磁盘分区。在这个例子中，我们创建了如下分区：
</p>

<table>
<tr>
  <th>目录</th>
  <th>大小</th>
</tr>
<tr>
  <ti>/usr</ti>
  <ti>10 GB</ti>
</tr>
<tr>
  <ti>/home</ti>
  <ti>5 GB</ti>
</tr>
<tr>
  <ti>/opt</ti>
  <ti>5 GB</ti>
</tr>
<tr>
  <ti>/var</ti>
  <ti>10 GB</ti>
</tr>
<tr>
  <ti>/tmp</ti>
  <ti>2 GB</ti>
</tr>
</table>

<p>
由于我们正要使用的是LVM2，所以不必太在意分区的大小，因为扩充容量很容易。
</p>

<note>
正如Terje Kvernes所评述的，增加分区的大小要比缩小它容易得多。我想你可能会想要从小分区开始，然后在需要的时候才扩充它们。
</note>

<pre caption="创建和扩充逻辑卷">
# <i>lvcreate -L10G -nusr  vg</i>
  Logical volume "usr" created <comment>（以后的类似信息就不显示了）</comment>
# <i>lvcreate -L5G  -nhome vg</i>
# <i>lvcreate -L5G  -nopt  vg</i>
# <i>lvcreate -L10G -nvar  vg</i>
# <i>lvcreate -L2G  -ntmp  vg</i>
<comment>（作为范例，让我们增加一个额外的5GB逻辑卷）</comment>
# <i>lvextend -L+5G /dev/vg/home</i>
</pre>

<p>
在逻辑卷中创建文件系统的步骤和在普通分区中相同。我们以使用ext3为例，当然你选用其他文件系统也行：
</p>

<pre caption="创建文件系统">
# <i>mke2fs -j /dev/vg/usr</i>
# <i>mke2fs -j /dev/vg/home</i>
# <i>mke2fs -j /dev/vg/opt</i>
# <i>mke2fs -j /dev/vg/var</i>
# <i>mke2fs -j /dev/vg/tmp</i>
</pre>

<p>
按照安装手册中挂载分区的方法挂载你创建的LVM2逻辑卷，但请将<path>/dev/hdxx</path>替换为<path>/dev/vg/逻辑卷名</path>。
</p>

<pre caption="挂载逻辑卷">
<comment>（请如安装手册所述，先挂载根分区）</comment>
# <i>mkdir /mnt/gentoo/usr</i>
# <i>mount /dev/vg/usr /mnt/gentoo/usr</i>
# <i>mkdir /mnt/gentoo/home</i>
# <i>mount /dev/vg/home /mnt/gentoo/home</i>
# <i>mkdir /mnt/gentoo/opt</i>
# <i>mount /dev/vg/opt /mnt/gentoo/opt</i>
# <i>mkdir /mnt/gentoo/var</i>
# <i>mount /dev/vg/var /mnt/gentoo/var</i>
# <i>mkdir /mnt/gentoo/tmp</i>
# <i>mount /dev/vg/tmp /mnt/gentoo/tmp</i>
</pre>

<note>
接下来的步骤跟安装手册中提到的差不多，在这里我们只列出一些有差异的地方。
</note>

<p>
请在配置内核时确认已启用了LVM2支持（并非所以2.4内核都支持）。选择下列LVM2模块：
</p>

<pre caption="在2.4.x内核中选择LVM2模块">
Multi-device support (RAID and LVM)  ---&gt;
  [*] Multiple devices driver support (RAID and LVM)
  &lt; &gt;  RAID support
<comment>（注意我们故意不选LVM，这是给LVM1用的）</comment>
  &lt; &gt;  Logical volume manager (LVM) support
  &lt;M&gt;  Device-mapper support
  &lt; &gt;   Mirror (RAID-1) support
</pre>

<pre caption="在2.6.x内核中选择LVM2模块">
Device Drivers  ---&gt;
 Multi-device support (RAID and LVM)  ---&gt;
   [*] Multiple devices driver support (RAID and LVM)
   &lt; &gt;   RAID support
   &lt;M&gt;   Device mapper support
</pre>

<p>
编译好的模块叫做<path>dm-mod.ko</path>
</p>

<p>
在编译好内核并安装完模块之后，将下面这行加入你的<path>/etc/modules.autoload.d/kernel-{KV}</path>中，其中{KV}表示你的内核版本（2.4或2.6），以便在开机时自动加载LVM2：
</p>

<pre caption="在/etc/modules.autoload.d/kernel-2.6中添加LVM2模块">
# <i>nano -w /etc/modules.autoload.d/kernel-2.6</i>
<comment>（增加底下这行）</comment>
dm-mod
</pre>

<p>
现在，安装lvm2包。
</p>

<impo>
请确定已将你的<path>/usr/src/linux</path>链接到了你现在使用的内核源代码，因为lvm2 ebuild所依赖的device-mapper ebuild会用到<path>/usr/src/linux/include/linux</path>下的源文件。
</impo>

<pre caption="emerging lvm2 软件包">
# <i>emerge lvm2</i>
</pre>

<p>
按照<uri link="#doc_chap2_pre2">前面</uri>的方法编辑文件<path>/etc/lvm/lvm.conf</path>。你先前修改过的那个配置文件是宿主系统中的文件，重启之后就不存在了。你得在新安装的Gentoo系统中再重新编辑一次。
</p>

<p>
在编辑<path>/etc/fstab</path>文件时，照着安装手册上说的，加入你的LVM2逻辑卷。重申一下，以下内容是我们范例中所必需的：
</p>

<pre caption="/etc/fstab的部分内容">
/dev/hda1     /boot   ext3    noauto,noatime 1 2
/dev/hda2     none    swap    sw             0 0
/dev/hda3     /       ext3    noatime        0 1
# Logical volumes
/dev/vg/usr   /usr    ext3    noatime        0 2
/dev/vg/home  /home   ext3    noatime        0 2
/dev/vg/opt   /opt    ext3    noatime        0 2
/dev/vg/var   /var    ext3    noatime        0 2
/dev/vg/tmp   /tmp    ext3    noatime        0 2
</pre>

<p>
当你来到安装手册中最后的安装步骤时，最好不要忘了卸载你所有的LVM2逻辑卷，并在重启前执行以下命令：
</p>

<pre caption="关闭LVM2">
# <i>vgchange -a n</i>
</pre>

<p>
重新开机，所有的分区都应该被挂载好了。
</p>

</body>
</section>
</chapter>

<chapter>
<title>重启后如何继续</title>
<section>
<body>

<p>
如果你在某处中断了Gentoo的安装又想继续的话，你需要先创建分区节点：
</p>

<pre caption="重新启用分区">
# <i>vgscan --mknodes</i>
</pre>

<p>
在缺少最新工具的安装光盘中，很可能需要用如下方法来重新启用分区：
</p>

<pre caption="重新启用分区">
<comment>（先将所有分区复位）</comment>
# <i>vgchange -a n</i>
<comment>（导出所有分区）</comment>
# <i>vgexport -a vg</i>
<comment>（导入所有分区）</comment>
# <i>vgimport -a vg</i>
<comment>（重新启用所有分区）</comment>
# <i>vgchange -a y</i>
</pre>

</body>
</section>
</chapter>

<chapter>
<title>相关资源</title>
<section>
<body>

<ul>
  <li>
    官方网页<uri link="http://sources.redhat.com/lvm2">LVM2 home page</uri>
  </li>
  <li>
    <uri link="http://tldp.org/HOWTO/LVM-HOWTO">LVM Howto</uri>
  </li>
  <li>
    Daniel Robbins写在IBM DeveloperWorks上的关于LVM的文章：<uri link="/doc/zh_cn/articles/lvm-p1.xml">第一部分</uri>以及<uri link="http://doc/zh_cn/articles/lvm-p2.xml">第二部分</uri>
  </li>
  <li>
    如何启动你在LVM1上的根分区：<uri>http://www.the-infinite.org/archive/docs/lvm/howto-boot-off-root-lv.txt</uri>
  </li>
</ul>

</body>
</section>
</chapter>

<chapter>
<title>特别感谢</title>
<section>
<body>

<p>
感谢<mail link="bangert@g.o">Thilo Bangert</mail>以及<mail link="terjekv@××××××××.no">Terje Kvernes</mail>为本文提供的帮助和建议。
</p>

</body>
</section>
</chapter>
</guide>



1.1                  xml/htdocs/doc/zh_cn/mysql-upgrading.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/zh_cn/mysql-upgrading.xml?rev=1.1&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/zh_cn/mysql-upgrading.xml?rev=1.1&content-type=text/plain

Index: mysql-upgrading.xml
===================================================================
<?xml version='1.0' encoding="utf-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">

<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/zh_cn/mysql-upgrading.xml,v 1.1 2007/09/17 17:54:10 r0bertz Exp $ -->
<!-- English CVS version: 1.21 -->

<guide link="/doc/zh_cn/mysql-upgrading.xml" lang="zh_cn">
<title>MySQL 4.*或5.0.*的升级指南</title>

<author title="作者">
  <mail link="citizen428@g.o">Michael Kohl</mail>
</author>
<author title="作者">
  <mail link="vivo@g.o">Francesco Riosa</mail>
</author>
<author title="译者">
  <mail link="jjj3112000@×××.com">Zezhou Jiang</mail>
</author>

<abstract>
MySQL团队很荣幸地宣布MySQL 5.0很快就要出现在Gentoo稳定的软件包树里了。这个指南描述了如何升级到MySQL 4.*或5.0.*。
</abstract>

<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>

<version>1.17</version>
<date>2007-06-04</date>

<chapter>
<title>直接升级，建议从4.1 =&gt; 5.0移动</title>
<section>
<body>

<p>
4.1的myisam存储引擎已经足够成熟了，它允许直接升级到下一个MySQL的主版本。
</p>

<note>
对于MERGE表来说不是这样。如果你尝试直接升级这种很少用的表类型你可能会陷入麻烦。你应该清除并重建这些表，并且在升级过程中把他们的内容储存起来。如果你不太确定，你应该从<uri link="#doc_chap2">Upgrading from old versions of MySQL</uri> 开始。
</note>

<p>
在这一步需要两个命令行，因为lock属于mysql会话。
</p>

<pre caption="直接从4.1升级至5.0.*">
# <i>quickpkg dev-db/mysql</i>
# <i>alias MYSQL="mysql --user=root --password=</i><comment>'your_password'</comment><i>"</i>
# <i>DATADIR=$(MYSQL --batch --raw --silent --skip-column-names \</i>
     <i>--execute='SHOW variables LIKE "datadir";' \</i>
     <i>| sed -e 's|datadir[ \t]||')</i>

<comment>（下一步应该在第二个命令行下做）</comment>
# <i>mysql --user=root --password=</i><comment>'your_password'</comment>
mysql&gt; <i>FLUSH TABLES WITH READ LOCK;</i>

<comment>（回到第一个命令行来运行这个命令）</comment>
# <i>tar -cjpvf ~/mysql.$(date +%F"T"%H-%M).tar.bz2 \</i>
     <i>/etc/conf.d/mysql /etc/mysql/my.cnf "${DATADIR}"</i>

<comment>（接下来的命令应该在第二个命令行下做）</comment>
mysql&gt; <i>UNLOCK TABLES;</i>
mysql&gt; <i>quit</i>

<comment>（回到第一个命令行来完成接下来的升级）</comment>
# <i>tar -tjvf ~/mysql.*.tar.bz2</i>
# <i>emerge -av "&gt;dev-db/mysql-5.0"</i>
# <i>dispatch-conf</i>
# <i>revdep-rebuild</i>
# <i>/etc/init.d/mysql restart</i>
# <i>mysql_upgrade_shell --user=root --password=</i><comment>'your_password'</comment><i> \</i>
     <i>--protocol=tcp --datadir="${DATADIR}"</i>
# <i>/etc/init.d/mysql restart</i>
# <i>unset DATADIR</i>
# <i>unalias MYSQL</i>
</pre>

</body>
</section>
</chapter>

<chapter>
<title>从旧的MySQL版本升级</title>
<section>
<body>

<p>
用户从老的MySQL版本（&lt;4.0.24）升级需要现安装MySQL 4.0.25。如果你已有一个更新的版本，你可以跳过这一区域，并从<uri link="#backup">next one</uri>继续。
</p>

<pre caption="简单升级">
# <i>emerge -av --buildpkg "&lt;mysql-4.1"</i>
</pre>

</body>
</section>
</chapter>

<chapter id="backup">
<title>为你当前的数据做备份</title>
<section>
<body>

<impo>
在不同的MySQl版本中主键的值的处理方式是不一样的，请参见<uri link="http://bugs.gentoo.org/108502">bug #108502</uri>来得到更多信息，极其推荐你扫描“0”（zero）或更小的值，并且升级它们到一个大于等于“1”的值。
</impo>

<p>
所有数据库管理员必须做的最重要的任务之一就是备份数据，那我们就开始吧：
</p>

<pre caption="所有数据库的dump">
# <i>mysqldump \</i>
  <i>-uroot \</i>
  <i>--password=</i><comment>'your_password'</comment><i> \</i>
  <i>-hlocalhost \</i>
  <i>--all-databases \</i>
  <i>--opt \</i>
  <i>--allow-keywords \</i>
  <i>--flush-logs \</i>
  <i>--hex-blob \</i>
  <i>--master-data \</i>
  <i>--max_allowed_packet=16M \</i>
  <i>--quote-names \</i>
  <i>--result-file=BACKUP_MYSQL_4.0.SQL</i>
</pre>

<p>
现在一个叫做<path>BACKUP_MYSQL_4.0.SQL</path>的文件应该存在，它可以在后面你重建数据时起到作用。数据是被SQL的MySQL语言描述的，它是一种结构化查询语言。
</p>

<p>
现在是检查你的备份是否正常工作的好时间了。
</p>

</body>
</section>
</chapter>

<chapter>
<title>从最近的MySQL版本升级</title>
<section>
<body>

<p>
如果你跳过了step #1，你现在必须创建一个最近安装的版本的备份包（是数据服务的，不是数据的）：
</p>

<pre caption="二进制包备份">
# <i>quickpkg dev-db/mysql</i>
</pre>

<p>
现在是时间吧最近的版本和它所有的数据清理干净了：
</p>

<pre caption="卸载MySQL">
# <i>/etc/init.d/mysql stop</i>
# <i>emerge -C mysql</i>
# <i>tar cjpvf ~/mysql.$(date +%F"T"%H-%M).tar.bz2 /etc/mysql/my.cnf /var/lib/mysql/</i>
# <i>ls -l ~/mysql.*</i>
# <i>rm -rf /var/lib/mysql/ /var/log/mysql</i>
</pre>

<note>
现在两个不同的备份应该存在：SQL的一个，这个在不同版本间是轻便的，另一个允许你快速恢复你的数据库。更多的细节将会在后面提到。
</note>

<p>
当你摆脱了旧的MySQl安装后，你现在可以安装新的版本了。记住必须用<c>revdep-rebuild</c>来rebuild与MySQL有联系的包。
</p>

<pre caption="升级二进制包">
# <i>emerge -av "&gt;mysql-4.1"</i>
<comment>（你也可以用dispatch-conf来升级你的配置文件）</comment>
# <i>etc-update</i>
# <i>revdep-rebuild</i>
</pre>

<p>
现在配置新安装的MySQl版本并重启实例：
</p>

<pre caption="配置MySQL4.1的基本安装">
# <i>emerge --config =mysql-4.1.<comment>&lt;micro_version&gt;</comment></i>
# <i>/etc/init.d/mysql start</i>
</pre>

<p>
最后你可以导入在step #2所创建的备份。
</p>

<impo>
默认的<path>/etc/mysql/my.cnf</path>文件默认设置了二进制的登陆（<c>log-bin</c>）。它会记录每一个对数据的修改操作。如果你运行一个非常大的数据库（大于等于1GB），它会创建极大的文件，并且迅速地用掉磁盘空间。如果你空间不够，禁用二进制登陆会是个好主意。
</impo>

<impo>
在MySQL4.1和之前的版本默认的编码是<c>utf8</c>。如果数据包含了<e>non</e>-ASCII编码，你可能想要保持数据库默认的编码设置，通过使用在<path>/etc/mysql/my.cnf</path>文件里的<c>latin1</c>替换所有的<c>utf8</c>的东西。在<uri link="#On_charset_conversion">Charset conversion</uri>这一章可以找到更多的信息。
</impo>

<impo>
管理的<c>mysql</c>数据库包括用户名、密码之间的其它东西<b>must</b>被编码为utf8。
</impo>

<p>
当一个未知的键被包含时，较老的mysqldump组件可能会使用错误的指令来导出表。为了解决这个问题，用一下声明来包住SQL：
</p>

<pre caption="修复foreign key checks">
SET FOREIGN_KEY_CHECKS=0
SET FOREIGN_KEY_CHECKS=1
</pre>

<p>
接下来，导入备份
</p>

<pre caption="导入MySQL备份">
# <i>cat BACKUP_MYSQL_4.0.SQL \</i>
     <i>| mysql \</i>
     <i>-uroot \</i>
     <i>--password=</i><comment>'your_password'</comment><i> \</i>
     <i>-hlocalhost \</i>
     <i>--max_allowed_packet=16M</i>

# <i>mysql_fix_privilege_tables \</i>
     <i>--defaults-file=/etc/mysql/my.cnf \</i>
     <i>--user=root \</i>
     <i>--password=</i><comment>'your_password'</comment><i></i>
</pre>

<p>
如果你现在重启MySQL服务并且所有的事都按预料进行，你就有了一个完全运行的4.1.x的MySQL版本。
</p>

<pre caption="重启MySQL实例">
# <i>/etc/init.d/mysql restart</i>
</pre>

<p>
如果当你在升级时遇到任何问题，请把它们报告到<uri link="http://bugs.gentoo.org">Bugzilla</uri> 。
</p>

</body>
</section>
</chapter>

<chapter>
<title>恢复旧的MySQL 4.0安装</title>
<section>
<body>

<p>
如果你不喜欢MySQL 4.1，你可以回到MySQL 4.0。
</p>

<pre caption="恢复到上一个版本">
# <i>/etc/init.d/mysql stop</i>
# <i>emerge -C mysql</i>
# <i>rm -rf /var/lib/mysql/ /var/log/mysql</i>
# <i>emerge --usepkgonly "&lt;mysql-4.1"</i>
<comment>（使用创建备份时的那个来代替 &lt;timestamp&gt;。）</comment>
# <i>tar -xjpvf mysql.&lt;timestamp&gt;.tar.bz2 -C /</i>
# <i>/etc/init.d/mysql start</i>
</pre>

<impo>
如果依据这个指南<c>dev-db/mysql</c>以外的包被编译安装了，你必须运行<c>revdep-rebuild</c>来确保每一个客户端使用了正确的mysql客户端共享组件。
</impo>

</body>
</section>
</chapter>

<chapter id="On_charset_conversion">
<title>字符转换：</title>
<section>
<title>介绍</title>
<body>

<p>
这一章并不打算成为一个如何做这样的转换的详尽的指南，反倒要成为一个读者可以推敲的短小的提示列表。
</p>

<p>
转换一个数据库可能是一个复杂的任务，并且难度随着数据的不同而增加。像serialized object和blobs是一个例子来说明把碎片弄在一起是很难的。
</p>

</body>
</section>
<section>
<title>索引</title>
<body>

<p>
每个utf-8字符连索引在内一共占3Byte。MySQL里的索引可以达到1000Byte那么长（767Byte是InnoDB表）。请记住限制使用Byte来衡量的，然而卷的长度是用字符的数量来解释的。
</p>

<p>
MySQL也可以在column的一部分创建索引，这可能有些帮助。下面是一些例子：
</p>

<pre caption="使用prefixes索引">
$ <i>mysql -uroot -p'<comment>your_password</comment>' test</i>

mysql> <i>SHOW variables LIKE "version" \G</i>
*************************** 1. row ***************************
Variable_name: version
    Value: <comment>5.0.24-log</comment>
1 row in set (0.00 sec)

mysql> <i>CREATE TABLE t1 (</i>
  ->   <i>c1 varchar(255) NOT NULL default '',</i>
  ->   <i>c2 varchar(255) NOT NULL default ''</i>
  ->   <i>) ENGINE=MyISAM DEFAULT CHARSET=utf8;</i>
Query OK, 0 rows affected (0.01 sec)

mysql> <i>ALTER TABLE t1</i>
  ->   <i>ADD INDEX idx1 ( c1 , c2 );</i>
<comment>ERROR 1071 (42000): Specified key was too long; max key length is 1000 bytes</comment>

mysql> <i>ALTER TABLE t1</i>
  ->   <i>ADD INDEX idx1 ( c1(165) , c2(165) );</i>
Query OK, 0 rows affected (0.01 sec)
Records: 0  Duplicates: 0  Warnings: 0

mysql> <i>CREATE TABLE t2 (</i>
  ->   <i>c1 varchar(255) NOT NULL default '',</i>
  ->   <i>c2 varchar(255) NOT NULL default ''</i>
  ->   <i>) ENGINE=MyISAM DEFAULT CHARSET=sjis;</i>
Query OK, 0 rows affected (0.00 sec)

mysql> <i>ALTER TABLE t2</i>
  ->   <i>ADD INDEX idx1 ( c1(250) , c2(250) );</i>
Query OK, 0 rows affected (0.03 sec)
Records: 0  Duplicates: 0  Warnings: 0

mysql> <i>CREATE TABLE t3 (</i>
  ->   <i>c1 varchar(255) NOT NULL default '',</i>
  ->   <i>c2 varchar(255) NOT NULL default ''</i>
  ->   <i>) ENGINE=MyISAM DEFAULT CHARSET=latin1;</i>
Query OK, 0 rows affected (0.00 sec)

mysql> <i>ALTER TABLE t3</i>
  ->   <i>ADD INDEX idx1 ( c1 , c2 );</i>
Query OK, 0 rows affected (0.03 sec)
Records: 0  Duplicates: 0  Warnings: 0
</pre>

</body>
</section>
<section>
<title>环境</title>
<body>

<p>
系统必须配置成支持UTF-8编码。你会在我们的<uri link="/doc/en/utf-8.xml">Using UTF-8 with Gentoo</uri>和<uri link="/doc/en/guide-localization.xml">Localization Guide</uri>文档里发现更多信息。
</p>

<p>
在这个例子里，我们设置一些在<path>/etc/env.d/02locale</path>文件里的环境变量来利用英文的UTF-8编码：
</p>

<pre caption="/etc/env.d/02locale">
LC_ALL=en_US.UTF-8
LANG=en_US.UTF-8
</pre>

<p>
接下来请确定运行<c>env-update &amp;&amp; source /etc/profile</c>。
</p>

</body>
</section>
<section>
<title>iconv</title>
<body>

<p>
由<c>sys-libs/glibc</c>提供的<c>iconv</c>是用来将文本文件从一个编码转换到另一个编码的工具。你也可以使用<c>app-text/recode</c>。
</p>

<pre caption="使用iconv">
<comment>（从latin1到utf8）</comment>
$ <i>iconv -f ISO-8859-15 -t UTF-8 file1.sql &gt; file2.sql</i>

<comment>（从日语到utf8）</comment>
$ <i>iconv -f ISO2022JP -t UTF-8 file1.sql &gt; file2.sql</i>
</pre>

<p>
<c>iconv</c>可以在环境不是设置成utf8时记录一个sql的dump。
</p>

</body>
</section>
<section>
<title>SQL矫正</title>
<body>

<p>
你可以使用<c>CONVERT()</c>和<c>CAST()</c>这两个MySQL函数来转换在你的SQL脚本中的数据。
</p>

</body>
</section>
<section>
<title>Apache（web服务器）</title>
<body>

<p>
为了apache使用utf8，你必须调节以下在<path>httpd.conf</path>文件里的变量：AddDefaultCharset，CharsetDefault和CharsetSourceEnc。如果你的html文件源码没有用utf8编码，那它们必须<b>must</b>被<c>iconv</c>或者<c>recode</c>转换。
</p>

</body>
</section>
</chapter>
</guide>



1.1                  xml/htdocs/doc/zh_cn/nano-basics-guide.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/zh_cn/nano-basics-guide.xml?rev=1.1&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/zh_cn/nano-basics-guide.xml?rev=1.1&content-type=text/plain

Index: nano-basics-guide.xml
===================================================================
<?xml version='1.0' encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">

<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/zh_cn/nano-basics-guide.xml,v 1.1 2007/09/17 17:54:10 r0bertz Exp $ -->
<!-- English CVS version: 1.25 -->

<guide link="/doc/zh_cn/nano-basics-guide.xml" lang="zh_cn">

<title>Nano基础指南</title>

<author title="Gentoo Doc Editor">
  <!-- meekrob@g.o -->
Sherman Boyd
</author>
<author title="Editor">
  <mail link="swift@g.o">Sven Vermeulen</mail>
</author>
<author title="Translator">
  <mail link="zm3345@×××××.com">Zhou Mi</mail>
</author>

<abstract>
这是篇nano简明使用指南，能帮助你尽快了解nano的基本用法。
</abstract>

<version>1.6</version>
<date>2006-01-05</date>

<chapter>
<title>Nano基础</title>
<section>
<title>目的</title>
<body>

<p>
这是篇nano简明使用指南，帮助你快速了解nano的基本用法。如想获取更多的帮助信息，请参阅：
</p>

<p>
<uri>http://www.nano-editor.org</uri>
</p>

</body>
</section>
<section>
<title>打开文件与新建文件</title>
<body>

<p>
使用nano打开或新建文件，只需键入：
</p>

<pre caption="打开或新建文件">
# <i>nano 文件名</i>
</pre>

<p>
Nano是一种单模式编辑器，你可以直接输入文字。如果你要编辑一个像<path>/etc/fstab</path>一样的配置文件，请使用<c>-w</c>参数，例如：
</p>

<pre caption="禁用自动换行">
# <i>nano -w /etc/fstab</i>
</pre>

<warn>
这非常重要。如果在编辑配置文件时忘了加<c>-w</c>参数，可能会导致你的系统无法起动或产生别的异常。
</warn>

</body>
</section>
<section>
<title>保存和退出</title>
<body>

<p>
如果你要保存所做的修改，按下<c>Ctrl+O</c>。想要退出，按下<c>Ctrl+X</c>。如果你退出前没有保存所做的修改，它会提示你是否要保存。如果不要，请按<c>N</c>，反之，则按<c>Y</c>。然后它会让你确认要保存的文件名，确认或修改后按<c>Enter</c>即可。
</p>

<p>
如果你没有修改好而不小心按了保存键，您可以在请求确认文件名时按<c>Ctrl+C</c>来取消。
</p>

</body>
</section>
<section>
<title>剪切和粘贴</title>
<body>

<p>
要剪切一整行，请用<c>Ctrl+K</c>（按住<c>Ctrl</c>不放，再按下<c>K</c>键）。光标所在的行便消失了。要粘贴它，只需把光标移动到您所要粘贴的位置，然后按<c>Ctrl+U</c>即可。要移动多行，只需多按几次<c>Ctrl+K</c>把需要移动内容都剪切下来，然后按一次<c>Ctrl+U</c>就可以把刚剪切的内容全部粘贴上来。
</p>

<p>
如果你想使用更精确的剪切控制，则需要给文本做标记。移动光标到需要剪切文本的开头，按下<c>Ctrl+6</c>（或者<c>Alt+A</c>）。然后移动光标到待剪切文本的末尾：被做了标记的文本便会反白。要撤消文本标记，只需再按一次<c>Ctrl+6</c>。用<c>Ctrl+K</c>来剪切被标记的文本，用<c>Ctrl+U</c>来粘贴。
</p>

</body>
</section>
<section>
<title>搜索特定文字</title>
<body>

<p>
当你想搜索某特定文字时，只要想成<e>"WhereIs"</e>而不是<e>"Search"</e>，事情就简单了。只要按下<c>Ctrl+W</c>，键入你要搜索的字符串，再按<c>Enter</c>就可以了。想再次搜索相同的字符串，可以直接按<c>Alt+W</c>。
</p>

<note>
在nano帮助文档里，Ctrl-键被表示为一个脱字符（<c>^</c>），因此<c>Ctrl+W</c>被写成了<c>^W</c>，等等。Alt-键被表示为一个<c>M</c>（从"Meta"而来），因此<c>Alt+W</c>被写成了<c>M-W</c>。
</note>

</body>
</section>
<section>
<title>更多选项</title>
<body>

<p>
如果你有兴趣调整nano设置，一定去看看<path>/etc/nanorc</path>。
</p>

</body>
</section>
<section>
<title>最后</title>
<body>

<p>
就这样子吧！感谢#gentoo频道里的kiyose和quazion。再次提醒你，要了解更多的nano信息，请参阅：</p>

<p>
<uri>http://www.nano-editor.org</uri>
</p>

</body>
</section>
</chapter>
</guide>



1.1                  xml/htdocs/doc/zh_cn/portage-utils.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/zh_cn/portage-utils.xml?rev=1.1&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/zh_cn/portage-utils.xml?rev=1.1&content-type=text/plain

Index: portage-utils.xml
===================================================================
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">

<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/zh_cn/portage-utils.xml,v 1.1 2007/09/17 17:54:10 r0bertz Exp $ -->
<!-- English CVS version: 1.5 -->

<guide link="/doc/zh_cn/portage-utils.xml" lang="zh_cn">

<title>Portage-utils</title>

<author title="作者">
  <mail link="rane@g.o">Łukasz Damentko</mail>
</author>
<author title="编辑">
  <mail link="nightmorph@g.o">Joshua Saddler</mail>
</author>
<author title="编辑">
  <mail link="vanquirius@g.o">Marcelo Góes</mail>
</author>
<author title="译者">
  <mail link="jjj3112000@×××.com">Zezhou Jiang</mail>
</author>

<abstract>
这个指南涵盖了一些普通的portage-utils用法，portage-utils是一套用C写的快速Portage帮助程序。
</abstract>

<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>

<version>1.3</version>
<date>2007-05-23</date>

<chapter>
<title>介绍</title>
<section>
<body>

<p>
<c>portage-utils</c>是一套使用C写的非常快速的程序集，对于<c>gentoolkit</c>来说，它是意在提供一个快速但选择有限的副本。请记住<c>portage-utils</c>不是打算代替<c>gentoolkit</c>。虽然它的组件比同等的<c>gentoolkit</c>的组件更有效率，而且也许在需要重复地调用Portage时更适于用于脚本，但是<c>portage-utils</c>不提供同样的函数。它重来不考虑eclass，并且不提供像<c>revdep-rebuild</c>和<c>glsa-check</c>之类的工具。
</p>

<p>
你可以在<uri link="/doc/en/gentoolkit.xml">Gentoolkit</uri>指南里找到更多有关<c>gentoolkit</c>的信息。
</p>

<p>
你可以键入<c>man q</c> or <c>q --help</c>来得到<c>portage-utils</c>里的所有程序的列表。请阅读提到的所有的软件的man页，因为这个指南只是对这些最有用的函数进行一个简要的介绍，并且不包括每一个程序的所有信息。
</p>

<p>
使用<c>portage-utils</c>的第一步是安装包文件：
</p>

<pre caption="安装portage-utils">
# <i>emerge portage-utils</i>
</pre>

</body>
</section>
</chapter>

<chapter>
<title>使用</title>
<section>
<title>如何找到一个文件属于的包</title>
<body>

<p>
用<c>qfile</c>找一个文件属于的包：
</p>

<pre caption="找到一个文件属于的包">
$ <i>qfile /etc/fonts/fonts.conf</i>
media-libs/fontconfig (/etc/fonts/fonts.conf)
$ <i>qfile /usr/share/keymaps/atari/atari-uk-falcon.map.gz</i>
sys-apps/kbd (/usr/share/keymaps/atari/atari-uk-falcon.map.gz)
</pre>

</body>
</section>
<section>
<title>验证包的完整性</title>
<body>

<p>
如果你想要检查被某些包安装的文件的MD5或者是mtimes，你可以使用<c>qcheck</c>应用程序：
</p>

<pre caption="检查包的完整性">
$ <i>qcheck portage-utils</i>
Checking app-portage/portage-utils-0.1.13 ...
  * 36 out of 36 files are good
</pre>

<p>
当然，所有的安装后改变的文件都会在这里被报告。如果某个程序报告你必须在安装完后手动编辑配置文件，那其实没有什么可担心的。
</p>

</body>
</section>
<section>
<title>列出依赖于某些包的包文件</title>
<body>

<p>
当然那里也有能让你列出某些包依赖的所有的包。这你可以使用<c>qdepends</c>来达到。使用<c>-a</c>选项来显示某个包所有的DEPEND，RDEPEND和PDEPEND信息。
</p>

<pre caption="列出依赖于某些包的包文件">
$ <i>qdepends -a pygtk</i>
 * DEPEND
dev-python/pygtk-2.8.2: &gt;=dev-lang/python-2.3 &gt;=x11-libs/gtk+-2.8.0
&gt;=dev-libs/glib-2.8.0 &gt;=x11-libs/pango-1.10.0 &gt;=dev-libs/atk-1.8.0
&gt;=gnome-base/libglade-2.5.0 &gt;=dev-python/pycairo-0.9.0 dev-python/numeric
virtual/opengl dev-python/pyopengl &gt;=x11-libs/gtkglarea-1.99
&gt;=dev-util/pkgconfig-0.9 sys-devel/patch
 * RDEPEND
dev-python/pygtk-2.8.2: &gt;=dev-lang/python-2.3 &gt;=x11-libs/gtk+-2.8.0
&gt;=dev-libs/glib-2.8.0 &gt;=x11-libs/pango-1.10.0 &gt;=dev-libs/atk-1.8.0
&gt;=gnome-base/libglade-2.5.0 &gt;=dev-python/pycairo-0.9.0 dev-python/numeric
virtual/opengl dev-python/pyopengl &gt;=x11-libs/gtkglarea-1.99
 * PDEPEND
</pre>

</body>
</section>
<section>
<title>列出属于一个ebuild文件的文件</title>
<body>

<p>
<c>qlist</c>给你属于一个ebuild的所有文件的列表
</p>

<pre caption="列出属于一个ebuild文件的文件">
$ <i>qlist vim</i>
/usr/bin/gvim
/usr/bin/gvimdiff
/usr/bin/evim
/usr/bin/eview
/usr/bin/gview
/usr/bin/rgvim
[...]
</pre>

</body>
</section>
<section>
<title>搜索使用某些USE标记的包</title>
<body>

<p>
使用<c>quse</c>来做这事，它必须使用root用户来运行。当第一次建立/更新ebuild缓存时可能需要一些时间。
</p>

<pre caption="寻找带有“firefox”USE标记的包">
# <i>quse firefox</i>
app-office/openoffice/openoffice-2.0.2_rc1.ebuild binfilter curl eds firefox gnome gtk java kde ldap xml2
dev-haskell/gtk2hs/gtk2hs-0.9.10.ebuild doc glade gnome firefox
dev-java/swt/swt-3.1-r1.ebuild accessibility cairo firefox gnome
[...]
</pre>

</body>
</section>
<section>
<title>找到包的大小</title>
<body>

<p>
使用<c>qsize</c>程序来做这件事是想要多简单就有多简单：
</p>

<pre caption="找到包的大小">
$ <i>qsize vim</i>
app-editors/gvim-6.4: 10 files, 7 non-files, 2327.516 KB
app-editors/vim-6.4: 6 files, 2 non-files, 2058.14 KB
app-editors/vim-core-6.4: 1024 files, 68 non-files, 10950.984 KB
[...]
</pre>

</body>
</section>
<section>
<title>搜索Portage树</title>
<body>

<p>
<c>portage-utils</c>的最强大的工具之一是<c>qsearch</c>。这个工具允许你比默认的<c>emerge -s</c>更快地搜索Portage树。
</p>

<p>
这里是一些关于它的用法的示例：
</p>

<pre caption="使用qsearch来搜索软件包树">
<comment>（我忘记了我最喜欢的字体的包的名字）</comment>
$ <i>qsearch terminus</i>
media-fonts/terminus-font A clean fixed font for the console and X11

<comment>（我想谢谢制作了它们的那个家伙。他的主页是什么？）</comment>
$ <i>qsearch -H terminus</i>
media-fonts/terminus-font http://www.is-vn.bg/hamster/jimmy-en.html

<comment>（我现在要一个聊天客户端）</comment>
$ <i>qsearch -S "jabber client"</i>
app-emacs/emacs-jabber A Jabber client for Emacs.
net-im/gajim Jabber client written in PyGTK
net-im/gnome-jabber Gnome Jabber Client
net-im/gossip Lightweight Jabber client for GNOME
net-im/imcom Python commandline Jabber Client
net-im/psi QT 3.x Jabber Client, with Licq-like interface
net-im/tkabber Featureful Jabber client for tcl/tk.
x11-themes/psi-themes Iconsets for Psi, a QT 3.x Jabber Client
</pre>

</body>
</section>
<section>
<title>从emerge的log文件里提取信息</title>
<body>

<p>
那里也有一个允许你从你的<path>emerge.log</path>文件里提取有用信息的工具。它叫做<c>qlop</c>，并且当你想要评估包的编译时间或者和你的朋友比较谁的电脑比较快时它会很有用。它也能让你现在正在编译什么和要多长时间，这当你在命令行下并打算检查它时很方便。
</p>

<pre caption="用qlop阅读emerge的log文件">
<comment>（我现在开始编译安装perl，并且我想要一个它一般要安装多长的预测）</comment>
$ <i>qlop -tH perl</i>
perl: 7 minutes, 52 seconds for 4 merges
<comment>（现在让我们看看正在编译安装什么）</comment>
$ <i>qlop -c</i>
* perl-5.8.8-r23
    started: Mon May 21 12:41:11 2007
    elapsed: 19 seconds
</pre>

</body>
</section>
</chapter>
</guide>



1.1                  xml/htdocs/doc/zh_cn/vdr-guide.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/zh_cn/vdr-guide.xml?rev=1.1&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/zh_cn/vdr-guide.xml?rev=1.1&content-type=text/plain

Index: vdr-guide.xml
===================================================================
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">

<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/zh_cn/vdr-guide.xml,v 1.1 2007/09/17 17:54:10 r0bertz Exp $ -->
<!-- English CVS version: 1.7 -->

<guide link="/doc/zh_cn/vdr-guide.xml" lang="zh_cn">
<title>Gentoo Linux VDR指南</title>

<author title="作者">
  <mail link="ng@××××.de">Norman Golisz</mail>
</author>
<author title="作者">
  <mail link="diox@g.o">Dimitry Bradt</mail>
</author>
<author title="作者">
  <mail link="zzam@g.o">Matthias Schwarzott</mail>
</author>
<author title="编辑">
  <mail link="nightmorph@g.o">Joshua Saddler</mail>
</author>
<author title="译者">
  <mail link="kunxi@×××××.org">奚焜</mail>
</author>

<abstract>
本指南向您展示如何配置Gentoo Linux来支持DVB和VDR。
</abstract>

<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>

<version>1.4</version>
<date>2007-01-02</date>

<chapter>
<title>DVB简介</title>
<section>
<title>什么是DVB？</title>
<body>

<p>
<e>DVB</e>是<e>Digital Video Broadcasting，数字视频广播</e>的简称。DVB描述了如何传播电视，广播和交互服务，比如MHP（多媒体家庭平台），EPG（数字节目向导）和teletext。采用MPEG-2数据压缩技术（HDTV采用H.264），使得在同一个频带上传输多路电视信号成为可能。数据压缩率越高，能够传输的频道越多，同时图像质量的损失也越大。</p>

<p>
DVB可以通过多种方法传播。末尾的字母标志了传播的方式，比如DVB-<e>T</e>是陆基传播。此外还有其他的传播方式：
</p>

<ul>
  <li>DVB-S是通过卫星传播</li>
  <li>DVB-C是通过光纤传播</li>
  <li>DVB-H是面向移动设备的传播（陆基）</li>
  <li>DVB-IPI是通过基于IP网络的传播，比如互联网</li>
  <li>
    DVB-RC(S/C/T)指定了用于传输数据服务的回馈频道，比如宽带互联网
  </li>
</ul>

</body>
</section>

<section>
<title>DVB卡的种类和要求</title>
<body>

<p>
除了根据DVB流的接收方式外，DVB卡还根据输出分为两类。第一类卡内置了解码器，可以通过<path>/dev/video</path>直接访问视频流，我们称其为<e>全功能卡</e>。另外一类卡没有解码器，需要主机提供软件解码，即<e>简装版卡</e>。这通常意味着较高的系统需求。您的计算机至少要配备600MHz主频以上的CPU，256MB以上的内存。<uri link="http://linuxtv.org/wiki/index.php/DVB_Card_Vendors">此表</uri>可以帮助您找到您的板卡。
</p>

</body>
</section>
</chapter>

<chapter>
<title>准备系统</title>
<section>
<title>配置内核</title>
<body>

<p>
首先，我们必须保证您的内核支持DVB以及您的DVB设备。自2.6系列内核起，所需的驱动已经包含在内核源代码中。检查您的内核配置，保证下列的选项被编译进内核或者模块。
</p>

<pre caption="需要的内核选项">
Input Device Support ---&gt;
* Event Interface
Device Drivers ---&gt;
Multimedia Devices ---&gt;
Digital Video Broadcasting Devices ---&gt;
    [*] DVB For Linux
     *  DVB Core Support
   M  [您的驱动]
</pre>

<p>
此外，我们还需要为您的硬件选择合适的驱动。为了找出您的卡的正确驱动，我们将所有的驱动都编译成模块。如果您使用的是PCI设备，请安装<c>pciutils</c>。如果您希望将驱动编入内核或者您没有PCI卡，您可以跳过这个步骤，前进至<uri link="#kernel_output">检查内核输出</uri>。
</p>

<pre caption="安装pciutils">
# <i>emerge pciutils</i>
</pre>

<p>
在启动了新内核后，我们运行<c>pcimodules</c>来列出所需的驱动。
</p>

<pre caption="列出所需的模块">
# <i>pcimodules</i>
ohci-hcd
ehci-hcd
sis900
snd-emu10k1
b2c2-flexcop-pci
nvidia
nvidiafb
</pre>

<p>
在这种情况下，我们需要加载内核模块<c>b2c2-flexcop-pci</c>。我们在<path>/etc/modules.autoload.d/kernel-2.6</path>里加入这个驱动模块名。
</p>

<pre caption="加入驱动模块名">
# <i>echo b2c2-flexcop-pci &gt;&gt; /etc/modules.autoload.d/kernel-2.6</i>
</pre>

</body>
</section>

<section id="kernel_output">
<title>检查内核输出</title>
<body>

<p>
推荐将所有的驱动都编译成模块，这样您就以动态地加载所需的模块，这在您不清楚所需模块名的时候特别有用。如果您已经知道了模块名，您可以将这个驱动编译进内核。编译内核，安装模块，重启系统。您可以用<c>dmesg</c>来检查是否您的内核成功地探测到您的板卡。
</p>

<pre caption="检查内核输出">
# <i>dmesg | grep DVB</i>
<comment>（如果您的系统配备了TerraTec Ciergy T2，您的输出可能是这样：）</comment>
DVB: registering new adaptor (TerraTec/qanu USB2.0 Highspeed DVB-T Receiver).
input: TerraTec/qanu USB2.0 Highspeed DVB-T Receiver remote control as /class/input/input2
</pre>

</body>
</section>
</chapter>

<chapter id="inst_vdr">
<title>安装VDR</title>
<section>
<body>

<p>
要安装VDR，我们只需要emerge它。
</p>

<pre caption="安装VDR">
# <i>emerge vdr</i>
</pre>

<p>
我们现在继续<uri link="#inst_ir_remote">安装遥控</uri>。
</p>

</body>
</section>
</chapter>

<chapter id="inst_ir_remote">
<title>安装遥控</title>
<section>
<body>

<p>
有两种方法可以通过红外遥控您的VDR。如果您的电视卡内置支持红外接收器，您可以用<c>vdr-remote</c>。否则，您很有可能需要LIRC。
</p>

</body>
</section>
<section>
<title>安装vdr-remote</title>
<body>

<p>
我们首先通过emerge来安装插件：
</p>

<pre caption="安装vdr-remote">
# <i>emerge vdr-remote</i>
# <i>emerge --config vdr-remote</i>
</pre>

<p>
当使用遥控插件来管理您DVB卡上的红外端口，默认的配置应该工作正常。它将自动使用包含"dvb"的输入设备。高级用户可以看一下<path>/etc/conf.d/vdr.remote</path>配置文件。
</p>

<p>
现在继续<uri link="#video-out">视频输出方案</uri>。
</p>

</body>
</section>
<section>
<title>其他方法：安装LIRC</title>
<body>

<p>
如果您的卡支持遥控（但是您无法或者不愿意使用<c>vdr-remote</c>），您也许希望配置LIRC。LIRC会分析按下的键，为每一个键返回一个名字。支持LIRC的程序会等待键盘信息，然后运行配置文件中指定的动作，配置文件大多保存在可执行文件的配置目录中（比如，<c>mplayer</c>加载<path>~/.mplayer/lircrc</path>）。安装LIRC之前，您先要把<c>lirc</c>加入到您的USE标记中，并在<path>/etc/make.conf</path>加入一个新的条目：<c>LIRC_DEVICES</c>。用<uri link="http://www.lirc.org/html/table.html">下表</uri>来找到这个选项的合适参数。
</p>

<pre caption="安装LIRC">
# <i>nano -w /etc/make.conf</i>
<comment>（用合适的驱动替代"devinput"）</comment>
LIRC_DEVICES="devinput"
USE="lirc"
# <i>emerge lirc</i>
</pre>

<p>
首先，我们要为每个键值定义一个名字。大多数支持的遥控器已经正确的配置了。请参考<uri link="http://lirc.sourceforge.net/remotes/">遥控器列表</uri>，下载所需的文件，保存为<path>/etc/lircd.conf</path>。然后，我们要找出用什么设备来访问我们的遥控器。运行下述命令来获得当前的输入设备列表（请确保您的设备在运行中）。</p>

<pre caption="当前的输入设备列表">
# <i>cat /proc/bus/input/devices</i>
I: Bus=0000 Vendor=0000 Product=0000 Version=0000
N: Name="TerraTec/qanu USB2.0 Highspeed DVB-T Receiver remote control"
P: Phys=usb-0000:00:1d.7-1/input0
S: Sysfs=/class/input/input2
H: Handlers=kbd event1
B: EV=100003
B: KEY=108fc210 2043 0 0 0 0 8000 2080 1 9e1680 0 0 ffc
</pre>

<p>
本例中的设备是Terratec Cinergy T2，所以我们可以通过<path>/dev/input/event1</path>来访问设备。用您的输出中相应的设备来替换<c>event1</c>。
</p>

<p>
<c>lircd</c>需要知道设备名。加入此行到<path>/etc/conf.d/lirc.conf</path>。请用您的实际驱动名和设备名替换<c>devinput</c>和<c>event1</c>。
</p>

<pre caption="加入lircd选项">
LIRCD_OPTS="-H devinput -d /dev/input/event1"
</pre>

<p>
是时候启动<c>lircd</c>了:
</p>

<pre caption="启动lircd">
# <i>/etc/init.d/lircd start</i>
</pre>

<p>
现在您应该可以看到<c>lircd</c>捕捉，解码按键了。运行<c>irw</c>，查看完毕后用Ctrl+C来结束应用程序。
</p>

<pre caption="测试LIRC">
# <i>irw</i>
0000000000001aa2 00 Exit Technisat_TTS35AI.conf
0000000000001a8d 00 Mute Technisat_TTS35AI.conf
0000000000000a97 00 OK Technisat_TTS35AI.conf
0000000000000a97 01 OK Technisat_TTS35AI.conf
0000000000000a92 00 Menu Technisat_TTS35AI.conf
</pre>

<p>
下一步，将它加入到默认运行级，以便在启动时自动运行。
</p>

<pre caption="将lircd加入到默认运行级">
# <i>rc-update add lircd default</i>
</pre>

<p>
要使用您的遥控器，您必须启用VDR的LIRC支持。把此行加入到<path>/etc/conf.d/vdr</path>：
</p>

<pre caption="启用LIRC支持">
# <i>nano -w /etc/conf.d/vdr</i>
IR_CTRL="lirc"
</pre>

</body>
</section>
</chapter>

<chapter id="video-out">
<title>视频输出方案</title>
<section>
<body>

<p>
您需要决定在下列视频输出设备中选择一种（仅仅一种！）输出图像和屏幕显示（OSD）。
</p>

</body>
</section>
<section id="vdr-dxr3">
<title>硬解压：全功能DVB卡</title>
<body>

<p>
使用这些昂贵的高档卡的用户不需要额外安装任何软件，您可以前进至<uri link="#channel_list">配置您的频道列表</uri>。
</p>

</body>
</section>
<section id="vdr-dxr3">
<title>硬解压：DXR3/Hollywood+ 卡</title>
<body>

<p>
使用DXR3卡，我们需要<c>vdr-dxr3</c>插件。
</p>

<pre caption="安装插件">
# <i>emerge vdr-dxr3</i>
# <i>echo em8300 &gt;&gt; /etc/modules.autoload.d/kernel-2.6</i>
</pre>

<p>
em8300模块需要根据卡的版本号作一些配置。
</p>

<p>
继续 <uri link="#channel_list">配置您的频道列表</uri>。
</p>

</body>
</section>
<section id="vdr-pvr350">
<title>硬解压：PVR350卡</title>
<body>

<p>
既然PVR350卡配备了板载的MPEG解码芯片，我们当然希望用到它。我们需要安装<c>vdr-prv350</c>插件。如果<c>ivtv-driver</c>还没有安装，emerge会自动为您安装它。我们把ivtv加入到<path>/etc/modules.autoload.d/kernel-2.6</path>使得它在每次启动时自动加载：
</p>

<pre caption="安装PVR350插件">
# <i>emerge vdr-pvr350</i>
# <i>echo ivtv &gt;&gt; /etc/modules.autoload.d/kernel-2.6</i>
</pre>

<p>
继续 <uri link="#channel_list">配置您的频道列表</uri>。
</p>

</body>
</section>
<section id="vdr-xineliboutput">
<title>软解压： vdr-softdevice</title>
<body>

<p>
要安装它，我们需要emerge<c>vdr-softdevice</c>。不要忘了启用这个插件。
</p>

<pre caption="安装软解压插件">
# <i>emerge vdr-softdevice</i>
# <i>emerge --config vdr-softdevice</i>
</pre>

<p>
要选择正确的音频／视频输出，请编辑<path>/etc/conf.d/vdr.softdevice</path>。
</p>

<p>
到此为止，我们只介绍了shm（"shared memory"，共享内存）的方案。安装的配置文件（设置SOFTDEVICE_VIDEO_OUT）已经启用此选项。稍后您需要启动<c>ShmClient</c>打开观看窗口。
</p>

<note>
如果您不希望采用一个独立的键盘布局来控制softdevice/shm的VDR，您可以用Matthias Schwarzott的<uri link="http://dev.gentoo.org/~zzam/remote.softdevice-shm.conf">devspace</uri>。复制上述文件到<path>/etc/vdr/remote.conf</path>，对其运行<c>chown vdr:vdr</c>使其能正常工作。</note>

<p>
继续<uri link="#channel_list">配置您的频道列表</uri>。
</p>

</body>
</section>
<section id="vdr-xineliboutput">
<title>软解压： vdr-xineliboutput</title>
<body>

<p>
一些用户青睐<c>vdr-xineliboutput</c>，因为它支持远程访问。我们现在就教您如何在主机和客户机上配置<c>vdr-xineliboutput</c>。首先，主机的设置：
</p>

<pre caption="安装vdr-xineliboutput">
# <i>emerge vdr-xineliboutput</i>
# <i>emerge --config vdr-xineliboutput</i>
</pre>

<p>
加入下列命令行参数对于xinliboutput的运行至关重要。更多的选项清参考<c>vdr --help</c>。
</p>

<pre caption="加入命令行参数到/etc/conf.d/vdr.xineliboutput">
_EXTRAOPTS="--local=none --remote=37890"
</pre>

<p>
下一步是编辑<path>/etc/vdr/svdrphosts.conf</path>。这个文件描述了哪些客户端允许访问主机系统上运行的VDR的SVDRP端口。
</p>

<pre caption="编辑/etc/vdr/svdrphosts.conf">
<comment>（正确地语法是：IP地址[/子网掩码]）</comment>
127.0.0.1             <comment>（localhost永远是被支持的）</comment>
192.168.1.0/24        <comment>（本地网的任何主机）</comment>
#204.152.189.113      <comment>（一个特定的主机）</comment>
#0.0.0.0/0            <comment>（任何网络的任何主机 － 请谨慎使用此选项！）</comment>
</pre>

<p>
如果您只需要在运行VDR的计算机上用<c>vdr-xineliboutput</c>观看，您可以继续<uri link="#channel_list">配置您的频道列表</uri>。
</p>

<p>
否则，您只需要在您的客户端<c>emerge media-plugins/vdr-xineliboutput</c>：
</p>

<pre caption="客户端设置">
# <i>emerge vdr-xineliboutput</i>
</pre>

<p>
在启动VDR后，您可以用<c>vdr-sxfe xvdr://hostname</c>命令来连接VDR，观看图像和屏幕显示。
</p>

<p>
继续<uri link="#channel_list">配置您的频道列表</uri>。
</p>

<note>
还有一个插件<c>vdr-dummydevice</c>可以模拟真实的输出设备，用于特殊的场合，比如专用的视频录制服务器，这些高级的应用并非常见的VDR设定。
</note>

</body>
</section>
</chapter>

<chapter id="channel_list">
<title>创建频道列表</title>
<section>
<body>

<p>
要使得VDR真正有用，您还需要创建合适的频道列表。除了下载以外，还有多种方法来获得一个可用的频道列表。默认的安装包含了Astra 19.2°E的DVB-S频道列表。
</p>

</body>
</section>
<section>
<title>用linuxtv-dvb-apps的dvbscan</title>
<body>

<pre caption="安装linuxtv-dvb-apps">
# <i>emerge linuxtv-dvb-apps</i>
</pre>

<p>
为您所在区域设定正确的频率以及接收类型。这些文件在<path>/usr/share/dvb/scan</path>。比如在德国纽伦堡地区接受DVB-T，您需要用<path>/usr/share/dvb/scan/dvb-t/de-Nuernberg</path>。
</p>

<pre caption="用dvbscan来扫描频道">
$ <i>dvbscan -o vdr /usr/share/dvb/scan/dvb-t/de-Nuernberg &gt; /etc/vdr/channels.conf</i>
</pre>

</body>
</section>
<section>
<title>使用vdr-reelchannelscan</title>
<body>

<p>
首先，删除已有的频道列表。
</p>

<pre caption="清除旧的频道列表">
# <i>rm /etc/vdr/channels.conf</i>
</pre>

<pre caption="安装并激活vdr-reelchannelscan">
# <i>emerge vdr-reelchannelscan</i>
# <i>emerge --config vdr-reelchannelscan</i>
</pre>

</body>
</section>
<section>
<title>采用vdr-analogtv系统的频道</title>
<body>

<p>
您也许在此要设置您的频道列表。如果您安装了&gt;=<c>media-plugins/vdr-analogtv-1.0.00-r1</c>，VDR项目在<path>/usr/share/doc/vdr-analogtv-$version/examples/</path>提供了一些例子。
</p>

</body>
</section>
</chapter>

<chapter>
<title>启动VDR</title>
<section>
<body>

<p>
完成了所有基础的软件部分，您还需要配置VDR的屏幕输出(OSD)。
</p>

<p>
如果你使用硬件解码器，您现在可以切换到连着的电视了。如果您使用软件解码器，客户端必须在VDR启动后运行。
</p>

<p>
首先，您必须学习键盘定义；即把按键和VDR内部命令联系起来。
</p>

<note>
考虑到您也许需要编辑键盘配置，或者更有可能的是删除配置，回到键盘学习的状态，友情提醒：VDR在<path>/etc/vdr/remote.conf</path>保存按键定义。
</note>

<p>
我们首先启动VDR：
</p>

<pre caption="启动VDR">
# <i>/etc/init.d/vdr start</i>
* Preparing start of vdr:
*   config files ...                                        [ ok ]
*   Waiting for prerequisites (devices nodes etc.) ...      [ ok ]
* Starting vdr ...                                          [ ok ]
* First start of vdr: No check for running vdr possible
* until control device (remote/keyboard) keys are learnt!
</pre>

<note>
使用软件解码器的用户可以开启客户端程序，它会打开一个窗口显示电视画面和OSD
</note>

<pre caption="激活客户端的软件解码器">
<comment>（使用vdr-softdevice的用户）</comment>
# <i>ShmClient</i>
<comment>（使用vdr-xineliboutput的用户）</comment>
# <i>vdr-sxfe xvdr://hostname</i>
</pre>

<p>
VDR最有用的键是：
</p>
<ul>
  <li>方向键（左／右／上／下）</li>
  <li>菜单／退出／选择</li>
  <li>颜色设置（红／绿／黄／蓝）</li>
  <li>数字键（0－9）</li>
</ul>

<impo>
如果您没有很多键备选，保证分配这些键。（某些遥控器的播放／暂停等键和颜色设置共用同样的键，用它们设置颜色。）
</impo>

<p>
基本的安装已经结束，您还需要配置VDR。切换到输出屏幕，按照屏幕上的指令配置操作。VDR会要求您按下遥控器上的键来学习正确的键值。如果您没有遥控器，您也可以使用您的键盘。
</p>



<p>
现在您可以把VDR启动脚本加入到默认运行级，在您的计算机启动的时候自动运行。
</p>

<pre caption="将vdr加入默认运行级">
# <i>rc-update add vdr default</i>
</pre>

</body>
</section>
</chapter>

<chapter>
<title>排错</title>
<section>
<body>

<note>
如果您需要任何帮助，您可以在<uri link="irc://irc.freenode.org/gentoo-vdr">#gentoo-vdr</uri>发问，或者查看我们的<uri link="http://forums.gentoo.org/">论坛</uri>。
</note>

</body>
</section>
</chapter>
</guide>



1.1                  xml/htdocs/doc/zh_cn/xfce-config.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/zh_cn/xfce-config.xml?rev=1.1&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/zh_cn/xfce-config.xml?rev=1.1&content-type=text/plain

Index: xfce-config.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">

<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/zh_cn/xfce-config.xml,v 1.1 2007/09/17 17:54:10 r0bertz Exp $ -->
<!-- English CVS version: 1.8 -->

<guide link="/doc/zh_cn/xfce-config.xml" lang="zh_cn">

<title>Xfce配置指南</title>

<author title="作者">
  <mail link="nightmorph@g.o">Joshua Saddler</mail>
</author>

<author title="译者">
  <mail link="wcw8410@×××××.com">吴传文</mail>
</author>

<abstract>
本指南对Xfce进行了广泛的介绍。Xfce是一个快捷的、轻量级的，功能齐全的桌面环境。
</abstract>

<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>

<version>1.6</version>
<date>2007-07-21</date>

<chapter>
<title>介绍</title>
<section>
<title>Xfce桌面环境</title>
<body>

<p>
<uri link="http://www.xfce.org">Xfce</uri>是类Unix操作系统上的一个快捷、轻量级的桌面环境。它是为生产力而设计的，并且具备很好的可配置性，同时还符合<uri link="http://www.freedesktop.org">Freedesktop</uri>的规范。
</p>

<p>
不像Gnome和KDE等这些比较臃肿的桌面环境，Xfce占用的系统资源要少得多。另外，它拥有更好的模块性和更少的依赖性；它将占用你更少的磁盘空间和更少的安装时间。
</p>

<p>
这篇指南将不仅向你说明如何安装和配置一个最小化的Xfce环境，并且还将探索一些可用方案来创建一个功能齐全的桌面环境，保持与Xfce设计思想的一致：轻巧，快速和模块化。
</p>

<p>
另外，本指南还将向你说明如何从4.2版本<uri link="#upgrade">升级</uri>到4.4版本。
</p>

</body>
</section>
</chapter>

<chapter>
<title>安装Xfce</title>
<section>
<title>基础</title>
<body>

<p>
首先，确定你已经按照<uri link="/doc/zh_cn/xorg-config.xml">如何配置X服务器</uri>所说的安装好了Xorg。
</p>

<p>
在我们安装功能齐全的最小化桌面之前，让我们花点时间来回顾一下我们将要安装的基本软件包。
</p>

<table>
<tr>
  <th>名称</th>
  <th>描述</th>
</tr>
<tr>
  <ti>xfce4</ti>
  <ti>基本的Xfce桌面环境</ti>
</tr>
<tr>
  <ti>xscreensaver</ti>
  <ti>
    带省电功能的屏保,并能够锁定屏幕安全
  </ti>
</tr>
</table>

<p>
你可以自由地装上任何其它你想要软件包，但从现在开始，我们将坚持建议你安装一个快捷最小化的工作环境。请反复检查<path>/etc/make.conf</path>中的USE标记；你可能至少需要<c>USE="dbus -gnome hal startup-notification"</c>。
</p>

<p>
现在，让我们开始安装Xfce。
</p>

<pre caption="安装Xfce">
# <i>emerge -avt xfce4 xscreensaver</i>
</pre>

<p>
然后，把你系统上的一般用户加到<c>plugdev</c>，<c>cdrom</c>,<c>cdrw</c>和<c>usb</c>组里，这样他/她们便能充分使用<c>hal</c>来挂载和使用照相机、光驱和U盘等之类的设备。
</p>

<pre caption="把用户加入硬件组">
<comment>（用你真实的用户名来代替username）</comment>
# <i>for x in plugdev cdrom cdrw usb ; do gpasswd -a username $x ; done</i>
</pre>

<p>
接着，更新你的环境变量：
</p>

<pre caption="更新环境变量">
# <i>env-update &amp;&amp; source /etc/profile</i>
</pre>

<p>
现在启动<c>hald</c>并且把它加到default运行级别：
</p>

<pre caption="启动hald">
# <i>/etc/init.d/hald start</i>
# <i>rc-update add hald default</i>
</pre>

</body>
</section>
</chapter>

<chapter>
<title>配置Xfce</title>
<section>
<title>启动Xfce</title>
<body>

<p>
现在Xfce已经安装完毕了，接着我们将把它设置成我们默认的桌面环境，一旦我们执行<c>startx</c>便可进入。将你的root用户退出然后以普通用户的身份登录。
</p>

<pre caption="设置Xfce作为默认的桌面环境">
$ <i>echo "exec startxfce4" > ~/.xinitrc</i>
</pre>

<p>
现在敲入<c>startx</c>来启动你的图形环境：
</p>

<pre caption="启动Xfce">
$ <i>startx</i>
</pre>

<p>
恭喜！欢迎你进入Xfce桌面环境。继续看下去，再扩展一点。接下去的部分将教你如何根据自己的要求来配置Xfce。
</p>

</body>
</section>
<section>
<title>程序启动</title>
<body>

<p>
你可能注意到在桌面上点击鼠标右键将弹出一个菜单，上面有你所有的应用程序。这是非常有用的，但是一旦你打开了多个窗口，你的桌面将很容易被完全掩盖住，这样启动一个新的程序便变得很不方便了。所以，你所希望的第一件事就是在你的面板上添加一个便捷的应用程序菜单。右击面板，然后选择"Add New Item"。滚动选项列表，选择"Xfce Menu"。你可以自己指定它在面板上的位置。当你点击它时,它会显示应用/选择菜单，上面给出了一个很好的分类清单，清单里包含了你已安装的程序。
</p>

</body>
</section>
<section>
<title>Sessions &amp; startup</title>
<body>

<p>
如果你已经（或者打算）安装一些流行的Gnome或KDE软件，比如<c>k3b</c>、<c>nautilus</c>、<c>kmail</c>、<c>evolution</c>等等，那么你要确定Xfce在启动时为这些程序启动了相应的服务。依次点击Menu --> Settings --> Sessions &amp; Startup。在"Advanced"标签里面，选择相应的复选框。这样可能会稍微增加Xfce启动的时间，但是会减少加载KDE和Gnome应用程序的时间。
</p>

<p>
Xfce能够保存你每次会话所做设置和运行的程序，这根据你在Sessions &amp; Startup菜单的"General"标签页的设置而定。当你退出登录时，既可以让Xfce自动保存也可以让Xfce每次都提示你是否要保存。当你想撤销错误的设置时这项功能尤其有用。意外关闭了面板该怎么办？只要在被问到是否要保存当前会话时选择否，那么下次你启动Xfce时，你原来的桌面就又回来了。想要在下次登录时自动加载你打开的浏览器、终端和邮件客户端吗？只要在退出时保存你的会话。
</p>

<p>
你已经安装并配置了一个基本的工作环境。但如果你还有兴趣动手做更多的事情，请接着下去！
</p>

</body>
</section>
</chapter>

<chapter>
<title>附加的应用程序</title>
<section>
<title>面板插件</title>
<body>

<p>
在这一小节里面，我们将讨论一些在Xfce里面每天都会用到的有用插件和应用软件。
</p>

<p>
Portage里面已经有许多可用的面板插件了；你用<c>emerge --search xfce</c>自己看看。尽管这些插件的名字中大部分都是带有自我解释含义的，但是有一些插件还是值得引起我们注意的，因为它们非常有用。要使用它们，只要简单的<c>emerge</c>它们。当你右击面板时便能看到它们已经被加到“Add New Item”菜单里的“Available Items”列表里面。
</p>

<ul>
  <li>
    <c>xfce4-mount</c>让你可以通过点击鼠标，便能方便地获得<path>/etc/fstab</path>中已挂载的设备的列表。
  </li>
  <li>
    <c>xfce4-battery</c>对于笔记本用户来说，是非常完美的。它可以显示电池的使用率、剩余时间、电源（交流电还是电池）、风扇状态、警告，甚至可以被配置在一定的电能水平下执行命令。当电池快耗尽时，这个功能可以让笔记本进入休眠状态。
  </li>
  <li>
    <c>verve</c>是嵌在面板上的一个小命令行。当你想运行一个命令时，用它会比另外打开一个终端还快。
  </li>
  <li>
    <c>xfce4-mixer</c>是音量控制器。它能控制ALSA和OSS声音程序。
  </li>
</ul>

<p>
如果在这些为Xfce定做的插件里找不到你想要的，那么尝试在Gnome面板插件的列表里寻找！是的，先安装<c>xfce4-xfapplet</c>，然后你就可以安装和运行Gnome里的插件。
</p>

</body>
</section>
<section>
<title>有用的程序</title>
<body>

<p>
Xfce绑定了一些有用的应用程序，包括<c>thunar</c>、<c>terminal</c>、<c>orage</c>和<c>mousepad</c>。注意：如果你安装<c>xfce4</c> 时用了<c>minimal</c>这个USE标记，那后3个程序将不会安装。然而，这些都是很小但却非常棒的程序，它们都很值得装上试试。
</p>

<p>
<c>orage</c>是一个简便易用的日历。<c>mousepad</c>是一个十分精简的文本编辑器，它的启动速度非常快。<c>terminal</c>则远比xterm更好配置更好用，它支持Unicode文本和伪透明，并通过Xfce内建的混色工具加快了透明化的速度，达到了即开即透明的效果。只是有一点你要确定下，你面板上的终端启动器默认运行的命令是<path>/usr/bin/Terminal</path>而不是xterm。右击该终端启动器然后选择"Properties"来改变它的命令。
</p>

<p>
<c>thunar</c>是Xfce内建的一个图形化文件管理器。它更快但功能却更强大，能通过插件来实现更多的功能；只需通过<c>emerge</c>来安装。让我们来看一看：
</p>

<ul>
  <li>
    <c>thunar-archive</c>让你可以通过右击菜单来创建和解开归档（压缩）文件。如果它与<c>xarchiver</c>结合，则更加好用。<c>xarchiver</c>是一个为刚刚为Xfce开发的图形化归档<uri link="http://www.foo-projects.org/~benny/projects/thunar-archive-plugin/">工具</uri>。
  </li>
  <li>
    <c>thunar-media-tags</c>让你可以一次性智能地对多个媒体文件进行重命名，并且让你能<uri link="http://thunar.xfce.org/pwiki/projects/thunar-media-tags-plugin">编辑</uri>这些文件的标签（tags)信息,例如id3标签。
  </li>
  <li>
    <c>thunar-thumbnailers</c>让你可以在Thunar里面<uri link="http://goodies.xfce.org/projects/thunar-plugins/thunar-thumbnailers">预览</uri>某些类型的文件，像图片和字体。
  </li>
  <li>
    <c>thunar-volman</c>自动<uri link="http://foo-projects.org/~benny/projects/thunar-volman/">管理</uri>即插即用的媒体设备和驱动器。
  </li>
</ul>

<p>
接着，我们加进一些有用的轻量级桌面应用程序，来与Xfce的设计思想保持一致。
</p>

<p>
尽管<c>mousepad</c>已经是相当好了，但如果你需要一个功能齐全的文字处理器，同时又不想要臃肿的OpenOffice，那么装上<c>abiword</c>试试。<uri link="http://www.abisource.com">AbiWord</uri>是一个更加轻快，并且与业界标准文档类型完全互通的文字处理工具。
</p>

<pre caption="加入一个文档处理器">
# <i>emerge -avt abiword</i>
</pre>

<p>
你想要一个好用的电子邮件客户端／新闻广播员，但又不要求要像<c>mozilla-thunderbird</c>或者<c>evolution</c>，有什么好办法呢？装上<c>sylpheed-claws</c>或者<c>claws-mail</c>试试。
</p>

<p>
在网上聊天方面，<c>irssi</c>是一个优秀的IRC客户端，它运行于终端里，小巧并且配置性极好。如果你更倾向于想要一个包含了所有聊天协议的客户端，那么你可能想要<c>emerge gaim</c>。
</p>

<p>
如果你需要电影和音乐播放器，那没有比<c>mplayer</c>和<c>audacious</c>更好的了。几乎所有格式的多媒体文件它们都能很好地播放，它们还有很多现成的插件可以用来扩展更多的功能。
</p>

<p>
最后，你还需要一个网页浏览器。几乎所有的图形化网页浏览器都要比你大多数的桌面应用程序占用更多的资源。尽管如此，<c>mozilla-firefox</c>（或者 <c>mozilla-firefox-bin</c>）依然是一个很好的选择。除此之外，你可能发现<c>opera</c>速度也是相当快的。但是<c>opera</c>并不像<c>mozilla-firefox</c>一样可用于这么多种架构的处理器，并且它有更多的依赖关系，除非你用USE标记忽略它们。
</p>

<pre caption="添加一个网页浏览器">
<comment>（安装Mozilla Firefox）</comment>
# <i>emerge mozilla-firefox</i>
<comment>（安装Opera）</comment>
# <i>echo "www-client/opera qt-static" >> /etc/portage/package.use</i>
# <i>emerge opera</i>
</pre>

<p>
到这里，我们已经提出一些很好的建议来丰富你的桌面应用，接着，看看我们还可以做些什么来提升你的Xfce体验。
</p>

</body>
</section>
<section>
<title>图形界面登录</title>
<body>

<p>
还记得我们添加<c>startxfce4</c>到<path>~/.xinitrc</path>文件中吗？要进入你的桌面，你所需要做的就是在登录以后敲入<c>startx</c>。这种方法是很好的，如果你喜欢完全基于文本启动和登录的话。否则，让我们使用一个显示管理器，它会在你系统引导后自动启动Xfce（这样你就能用图形化界面登录）。
</p>

<p>
首先，让我们确定下系统启动后加载了Xfce：
</p>

<pre caption="添加xdm到default运行级别">
# <i>rc-update add xdm default</i>
</pre>

<p>
这还远没有结束。我们还要挑选一个显示管理器然后设置一些合适的变量。尽管在Portage中有若干显示管理器可以选择，但在这篇指南中，我们将坚持两个选择：<c>xdm</c>和<c>gdm</c>。
</p>

<p>
<c>xdm</c>速度很快而且是轻量级的，但是它不够美观，并且定制性不好。如果你想要使用它，那先<c>emerge</c>它：
</p>

<pre caption="安装XDM">
# <i>emerge -avt xdm</i>
</pre>

<p>
然后在<path>/etc/conf.d/xdm</path>中编辑DISPLAYMANAGER变量：
</p>

<pre caption="编辑/etc/conf.d/xdm">
DISPLAYMANAGER="xdm"
</pre>

<p>
把XSESSION="Xfce4"添加到<path>/etc/rc.conf</path>，这样<c>xdm</c>就能自动启动你的Xfce了。
</p>

<p>
在你选择坚持用（相当难看的）<c>xdm</c>的同时，为什么不试一下<c>gdm</c>呢？配置它要容易得多，并且它要远远漂亮得多。首先，<c>emerge</c>它。注意到虽然它依赖一些软件，但这些软件都很很小，而且数量也比其它显示管理器所依赖的软件数量少。
</p>

<pre caption="安装GDM">
# <i>emerge -avt gdm</i>
</pre>

<p>
接着，把DISPLAYMANAGER变量的值改为<c>gdm</c>而不是<c>xdm</c>：
</p>

<pre caption="编辑/etc/conf.d/xdm">
DISPLAYMANAGER="gdm"
</pre>

</body>
</section>
<section>
<title>美化你的桌面</title>
<body>

<p>
对桌面外观稍微设置下是大有裨益的。Xfce拥有所有你期望从现代桌面系统得到的设置选项，字体反锯齿设置、颜色模板、大量的窗体装饰物、主题，等等还有很多。如果这还不够，那安装第三方的主题、图标集、鼠标光标主题还有壁纸也很容易。
</p>

<p>
<uri link="/main/en/graphics.xml">Gentoo website</uri>上面已收集了一批包含了各种分辨率的漂亮的Gentoo壁纸。如果你在寻找图标集和完整的Xfce主题，那到<uri link="http://www.xfce-look.org/">Xfce-Look</uri>这里来，这上面有很多。还有件重要的事情要记住，对于你下载的任何第三方美化包，通常需要先解压，然后再安装到合适的目录里。如果你想让你系统上所有的用户都能使用这些主题和图标集，那么把图标集安装到<path>/usr/share/icons/</path>，主题安装到<path>/usr/share/themes/</path>。如果仅供当前用户使用，那么把主题和图标集分别安装到<path>~/.themes/</path>和<path>~/.icons/</path>。
</p>

<p>
如果你安装了GDM作为你的显示管理器，那看一下<uri link="http://www.gnome-look.org">Gnome-Look</uri>这上面的许多GDM主题。安装它们，你既可以在命令行下把它们解压到<path>/usr/share/gdm/themes/</path>，也可以以<b>root</b>身份运行<c>gdmsetup</c>，然后把归档文件（压缩包）拖放到GDM窗口。这里还有一些<uri link="http://gnome-look.org/content/show.php?content=45575">非常好的</uri>Gentoo<uri link="http://gnome-look.org/content/show.php?content=20071">主题</uri>。
</p>

<p>
最后，Xfce还拥有自己内建的混色工具来管理窗口的透明化。你可以在Menu --> Settings --> Window Manager这里找到这个选项。为了达到最好的效果，你需要让你的显卡使用支持硬件加速渲染的驱动。确认你安装<c>xfwm4</c>时加入了<c>xcomposite</c>USE标记。接着，你需要在<path>/etc/X11/xorg.conf</path>中打开混色开关，加入一下片断：
</p>

<pre caption="打开xorg.conf中的混色开关">
Section "Extensions"
    Option  "Composite"  "Enable"
EndSection
</pre>

<p>
这仅仅是Xfce和Xorg-X11所要求的最低限度配置。但是，对硬件加速的设置则取决于你自己的显卡，这已经超出本文讨论的范围了。请阅读<uri link="/doc/zh_cn/index.xml?catid=desktop">桌面文档资源</uri>列表中的其它指南，来学会如何配置让你的显卡实现硬件加速。
</p>

</body>
</section>
</chapter>

<chapter id="upgrade">
<title>升级</title>
<section>
<title>从4.2升级到4.4</title>
<body>

<p>
把Xfce从4.2升级到4.4并不麻烦，它就跟大多数的升级一样简单。在4.4版本里面，许多过时的软件包不是被淘汰就是它们的功能已经以其它方式被包含进桌面了。
</p>

<p>
首先，更新你的Portage树（<c>emerge --sync</c>），然后看看Xfce有哪些组件可以升级（<c>emerge -pvtuD world</c>）。
</p>

<p>
你会注意到有一些包阻止了你的升级，因为大多数4.2的包是不能与4.4的包共存的。这里有个直截了当的办法：只要像<uri link="/doc/zh_cn/handbook/handbook-x86.xml?part=2&amp;chap=1">Portage手册</uri>和<c>man emerge</c>所说的那样卸载掉这些阻挡你的包，然后级就能继续了。
</p>

<p>
接着，你可能需要重建某些包，如跟<c>dbus</c>挂钩的应用程序。首先你需要安装<c>gentoolkit</c>。一旦<c>gentoolkit</c>安装好了，运行：
</p>

<pre caption="重建包">
# <i>revdep-rebuild -p</i>
<comment>（如果你在输出看到了任何关于有包被破坏的信息，那么运行下一条命令）</comment>
# <i>revdep-rebuild</i>
</pre>

<note>
更多的信息，请参考<c>man revdep-rebuild</c>和<uri link="/doc/zh_cn/gentoolkit.xml">Gentoolkit指南</uri>。
</note>

<p>
一旦重建完成，再一次运行<c>revdep-rebuild -p</c>，这一次只是确定你已经有了一个干净可靠的系统。如果还出现任何出错信息，继续<c>revdep-rebuild -p</c>和<c>revdep-rebuild</c>直到再也没有关于有包被损坏的消息出现。由于Xfce相当广泛地使用了<c>dbus</c>，所以大多数的升级问题都源于<c>dbus</c>。
</p>

<p>
接着，重启<c>dbus</c>和／或<c>hal</c>。
</p>

<pre caption="重启dbus和hal">
# <i>/etc/init.d/dbus restart</i>
# <i>/etc/init.d/hald restart</i>
</pre>

<p>
最后，给你自己一个全新的环境。
</p>

<pre caption="更新环境变量">
# <i>env-update &amp;&amp; source /etc/profile</i>
</pre>

</body>
</section>
<section>
<title>设置</title>
<body>

<p>
确定你熟悉了新Settings Manager里面所有的新选项。在桌面屏幕上进行操作是我们感兴趣的地方；Xfce现在可以管理你的桌面并且在上面安放图标了。
</p>

<p>
还有一个Window Manager Tweaks窗口，在那里你可以调整窗口、工作区间还有透明化（如果支持的话）的属性值。Xfce4.4稍微改变了工作区间与焦点活动窗口之间的默认行为。如果你发现在一个工作区间里点击一个超链接，却把你在另外一个区间里的浏览器调了过来（或者类似烦人的窗口聚焦行为），那么设置Settings --> Window Manager Tweaks --> Focus --> Activate Focus Stealing Prevention试试。
</p>

<p>
确定你阅读了<uri link="http://www.xfce.org/documentation/">Xfce文档</uri>并且通过<uri link="http://www.xfce.org/about/tour">Xfce历程</uri>了解了更多关于4.4的信息和学到了更多配置它的方法。
</p>

</body>
</section>
</chapter>

<chapter>
<title>总结</title>
<section>
<body>

<p>
祝贺你已经走到这么远了！你已经为你的计算需要安装配置了快捷的桌面环境和可靠的应用套件。
</p>

</body>
</section>
<section>
<title>资源</title>
<body>

<p>
对于配置和使用Xfce你还需要其它的帮助吗？还想得到更多轻量级应用程序的建议？试试到这里找找：
</p>

<ul>
  <li><uri link="http://forums.gentoo.org">The Gentoo forums</uri></li>
  <li>#irc.freenode.net上的xfce频道</li>
  <li>
    <path>/usr/share/xfce4/doc/C/index.html</path>这里提供了Xfce的安装帮助文档和其它文档。把你的浏览器对准这里开始阅读。甚至还有许多配置选项的细节“隐藏”在这些帮助文档里面。
  </li>
  <li><uri link="http://www.xfce.org">Xfce's home page</uri></li>
</ul>

</body>
</section>
</chapter>
</guide>



-- 
gentoo-commits@g.o mailing list