翻译14.1 docguide.sgml

Author: sirlipeng

postgresql/doc/src/sgml/docguide.sgml

@@ -274,14 +274,17 @@ ____________________________________________________________________________-->
    You can get away with not installing DocBook XML and the DocBook XSLT
    stylesheets locally, because the required files will be downloaded from the
    Internet and cached locally.  This may in fact be the preferred solution if
-   your operating system packages provide only an old version of especially
-   the stylesheets or if no packages are available at all.  See
-   the <option>-&minus;nonet</option> option for <command>xmllint</command>
-   and <command>xsltproc</command> for more information.
+   your operating system packages provide only an old version of these files,
+   or if no packages are available at all.
+   If you want to prevent any attempt to access the Internet while building
+   the documentation, you need to pass the <option>-&minus;nonet</option> option
+   to <command>xmllint</command> and <command>xsltproc</command>; see below
+   for an example.
   </para>
 ____________________________________________________________________________-->
   <para>
-   你可以在本地不安装DocBook XML和DocBook XSLT样式表的情况下开始工作，因为所需的文件将从Internet下载下来并且缓存在本地。如果你的操作系统包仅提供了旧版本的样式表或者根本就没有所需的包，那么这种方式实际上是最好的解决方案。更多信息请见<command>xmllint</command>和<command>xsltproc</command>的<option>--nonet</option>选项。
+   你可以在本地不安装DocBook XML和DocBook XSLT样式表的情况下开始工作，因为所需的文件将从Internet下载下来并且缓存在本地。如果你的操作系统包仅提供这些文件的旧版本，或者根本没有可用的包，则这实际上可能是首选解决方案。
+   如果你想在构建文档时阻止任何访问Internet的尝试，你需要将<option>--nonet</option>选项传递给<command>xmllint</command>和<command>xsltproc</command>；参见下面的示例。
   </para>
 
   <sect2>
@@ -412,31 +415,60 @@ ____________________________________________________________________________-->
 <!--==========================orignal english content==========================
   <para>
    Before you can build the documentation you need to run the
-   <filename>configure</filename> script as you would when building
+   <filename>configure</filename> script, as you would when building
    the <productname>PostgreSQL</productname> programs themselves.
-   Check the output near the end of the run, it should look something
+   Check the output near the end of the run; it should look something
    like this:
 <screen>
 checking for xmllint... xmllint
-checking for DocBook XML V4.5... yes
-checking for dbtoepub... dbtoepub
 checking for xsltproc... xsltproc
 checking for fop... fop
+checking for dbtoepub... dbtoepub
+</screen>
+  If <filename>xmllint</filename> or <filename>xsltproc</filename> is not
+   found, you will not be able to build any of the documentation.
+   <filename>fop</filename> is only needed to build the documentation in
+   PDF format.
+   <filename>dbtoepub</filename> is only needed to build the documentation
+   in EPUB format.
+  </para>
+
+  <para>
+   If necessary, you can tell <filename>configure</filename> where to find
+   these programs, for example
+<screen>
+./configure ... XMLLINT=/opt/local/bin/xmllint ...
+</screen>
+   Also, if you want to ensure that <filename>xmllint</filename>
+   and <filename>xsltproc</filename> will not perform any network access,
+   you can do something like
+<screen>
+./configure ... XMLLINT="xmllint -&minus;nonet" XSLTPROC="xsltproc -&minus;nonet" ...
 </screen>
-   If <filename>xmllint</filename> was not found then some of the following
-   tests will be skipped.
   </para>
 ____________________________________________________________________________-->
   <para>
-   在你能编译文档之前，你需要运行<filename>configure</filename>脚本，就像你在编译<productname>PostgreSQL</productname>程序本身时所作的那样。检查运行末尾附近的输出，应该看起来像这样：
+   在你能编译文档之前，你需要运行<filename>configure</filename>脚本，就像你在编译<productname>PostgreSQL</productname>程序本身时所作的那样。检查运行末尾附近的输出;它应该看起来像这样：
 <screen>
 checking for xmllint... xmllint
-checking for DocBook XML V4.5... yes
-checking for dbtoepub... dbtoepub
 checking for xsltproc... xsltproc
 checking for fop... fop
+checking for dbtoepub... dbtoepub
+</screen>
+   如果未找到<filename>xmllint</filename>或<filename>xsltproc</filename>，你将无法构建任何文档<filename>fop</filename>仅用于在中构建文档
+PDF格式。
+<filename>dbtoepub</filename>仅用于以EPUB格式构建文档。
+  </para>
+
+  <para>
+   如果需要，你可以告诉<filename>configure</filename>到哪里去找这些程序，例如
+<screen>
+./configure ... XMLLINT=/opt/local/bin/xmllint ...
+</screen>
+   另外，如果你想确认<filename>xmllint</filename>和<filename>xsltproc</filename>不会执行任何网络访问，你可以如下操作
+<screen>
+./configure ... XMLLINT="xmllint --nonet" XSLTPROC="xsltproc --nonet" ...
 </screen>
-   如果没有找到<filename>xmllint</filename>，那么一些后续测试将被跳过。
   </para>
 
   </sect2>