Baoding-FenShuaJiang
/
Green_GoodERP18_FSJ_Standard
Watch 1
Star 0
Wiki 捐赠
gooderp18绿色标准版
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Tree: 0f75e31513
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '0f75e31513'
${ noResults }
Green_GoodERP18_FSJ_Standard/PostgreSQL/doc/postgresql/html/docguide-toolsets.html

95 lines
8.6KB
Raw Blame History 

  1. <?xml version="1.0" encoding="UTF-8" standalone="no"?>

  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>J.2. Tool Sets</title><link rel="stylesheet" type="text/css" href="stylesheet.css" /><link rev="made" href="pgsql-docs@lists.postgresql.org" /><meta name="generator" content="DocBook XSL Stylesheets V1.79.1" /><link rel="prev" href="docguide-docbook.html" title="J.1. DocBook" /><link rel="next" href="docguide-build.html" title="J.3. Building the Documentation" /></head><body><div xmlns="http://www.w3.org/TR/xhtml1/transitional" class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="5" align="center">J.2. Tool Sets</th></tr><tr><td width="10%" align="left"><a accesskey="p" href="docguide-docbook.html" title="J.1. DocBook">Prev</a> </td><td width="10%" align="left"><a accesskey="u" href="docguide.html" title="Appendix J. Documentation">Up</a></td><th width="60%" align="center">Appendix J. Documentation</th><td width="10%" align="right"><a accesskey="h" href="index.html" title="PostgreSQL 12.4 Documentation">Home</a></td><td width="10%" align="right"> <a accesskey="n" href="docguide-build.html" title="J.3. Building the Documentation">Next</a></td></tr></table><hr></hr></div><div class="sect1" id="DOCGUIDE-TOOLSETS"><div class="titlepage"><div><div><h2 class="title" style="clear: both">J.2. Tool Sets</h2></div></div></div><div class="toc"><dl class="toc"><dt><span class="sect2"><a href="docguide-toolsets.html#id-1.11.11.5.5">J.2.1. Installation on Fedora, RHEL, and Derivatives</a></span></dt><dt><span class="sect2"><a href="docguide-toolsets.html#id-1.11.11.5.6">J.2.2. Installation on FreeBSD</a></span></dt><dt><span class="sect2"><a href="docguide-toolsets.html#id-1.11.11.5.7">J.2.3. Debian Packages</a></span></dt><dt><span class="sect2"><a href="docguide-toolsets.html#id-1.11.11.5.8">J.2.4. macOS</a></span></dt><dt><span class="sect2"><a href="docguide-toolsets.html#DOCGUIDE-TOOLSETS-CONFIGURE">J.2.5. Detection by <code class="command">configure</code></a></span></dt></dl></div><p>

  3.    The following tools are used to process the documentation.  Some

  4.    might be optional, as noted.

  5. 

  6.    </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><a class="ulink" href="https://www.oasis-open.org/docbook/" target="_top">DocBook DTD</a></span></dt><dd><p>

  7.        This is the definition of DocBook itself.  We currently use version

  8.        4.2; you cannot use later or earlier versions.  You need

  9.        the <acronym class="acronym">XML</acronym> variant of the DocBook DTD, not

  10.        the <acronym class="acronym">SGML</acronym> variant.

  11.       </p></dd><dt><span class="term"><a class="ulink" href="https://github.com/docbook/wiki/wiki/DocBookXslStylesheets" target="_top">DocBook XSL Stylesheets</a></span></dt><dd><p>

  12.        These contain the processing instructions for converting the

  13.        DocBook sources to other formats, such as

  14.        <acronym class="acronym">HTML</acronym>.

  15.       </p><p>

  16.        The minimum required version is currently 1.77.0, but it is recommended

  17.        to use the latest available version for best results.

  18.       </p></dd><dt><span class="term"><a class="ulink" href="http://xmlsoft.org/" target="_top">Libxml2</a> for <code class="command">xmllint</code></span></dt><dd><p>

  19.        This library and the <code class="command">xmllint</code> tool it contains are

  20.        used for processing XML.  Many developers will already

  21.        have <span class="application">Libxml2</span> installed, because it is also

  22.        used when building the PostgreSQL code.  Note, however,

  23.        that <code class="command">xmllint</code> might need to be installed from a

  24.        separate subpackage.

  25.       </p></dd><dt><span class="term"><a class="ulink" href="http://xmlsoft.org/XSLT/" target="_top">Libxslt</a> for <code class="command">xsltproc</code></span></dt><dd><p>

  26.        <code class="command">xsltproc</code> is an XSLT processor, that is, a program to

  27.        convert XML to other formats using XSLT stylesheets.

  28.       </p></dd><dt><span class="term"><a class="ulink" href="https://xmlgraphics.apache.org/fop/" target="_top">FOP</a></span></dt><dd><p>

  29.        This is a program for converting, among other things, XML to PDF.

  30.       </p></dd></dl></div><p>

  31.   </p><p>

  32.    We have documented experience with several installation methods for

  33.    the various tools that are needed to process the documentation.

  34.    These will be described below.  There might be some other packaged

  35.    distributions for these tools. Please report package status to the

  36.    documentation mailing list, and we will include that information

  37.    here.

  38.   </p><p>

  39.    You can get away with not installing DocBook XML and the DocBook XSLT

  40.    stylesheets locally, because the required files will be downloaded from the

  41.    Internet and cached locally.  This may in fact be the preferred solution if

  42.    your operating system packages provide only an old version of especially

  43.    the stylesheets or if no packages are available at all.  See

  44.    the <code class="option">--nonet</code> option for <code class="command">xmllint</code>

  45.    and <code class="command">xsltproc</code> for more information.

  46.   </p><div class="sect2" id="id-1.11.11.5.5"><div class="titlepage"><div><div><h3 class="title">J.2.1. Installation on Fedora, RHEL, and Derivatives</h3></div></div></div><p>

  47.     To install the required packages, use:

  48. </p><pre class="programlisting">

  49. yum install docbook-dtds docbook-style-xsl fop libxslt

  50. </pre><p>

  51.    </p></div><div class="sect2" id="id-1.11.11.5.6"><div class="titlepage"><div><div><h3 class="title">J.2.2. Installation on FreeBSD</h3></div></div></div><p>

  52.     To install the required packages with <code class="command">pkg</code>, use:

  53. </p><pre class="programlisting">

  54. pkg install docbook-xml docbook-xsl fop libxslt

  55. </pre><p>

  56.    </p><p>

  57.     When building the documentation from the <code class="filename">doc</code>

  58.     directory you'll need to use <code class="command">gmake</code>, because the

  59.     makefile provided is not suitable for FreeBSD's <code class="command">make</code>.

  60.    </p></div><div class="sect2" id="id-1.11.11.5.7"><div class="titlepage"><div><div><h3 class="title">J.2.3. Debian Packages</h3></div></div></div><p>

  61.     There is a full set of packages of the documentation tools

  62.     available for <span class="productname">Debian GNU/Linux</span>.

  63.     To install, simply use:

  64. </p><pre class="programlisting">

  65. apt-get install docbook-xml docbook-xsl fop libxml2-utils xsltproc

  66. </pre><p>

  67.    </p></div><div class="sect2" id="id-1.11.11.5.8"><div class="titlepage"><div><div><h3 class="title">J.2.4. macOS</h3></div></div></div><p>

  68.     On macOS, you can build the HTML and man documentation without installing

  69.     anything extra.  If you want to build PDFs or want to install a local copy

  70.     of DocBook, you can get those from your preferred package manager.

  71.    </p><p>

  72.     If you use MacPorts, the following will get you set up:

  73. </p><pre class="programlisting">

  74. sudo port install docbook-xml-4.2 docbook-xsl fop

  75. </pre><p>

  76.     If you use Homebrew, use this:

  77. </p><pre class="programlisting">

  78. brew install docbook docbook-xsl fop

  79. </pre><p>

  80.    </p></div><div class="sect2" id="DOCGUIDE-TOOLSETS-CONFIGURE"><div class="titlepage"><div><div><h3 class="title">J.2.5. Detection by <code class="command">configure</code></h3></div></div></div><p>

  81.    Before you can build the documentation you need to run the

  82.    <code class="filename">configure</code> script as you would when building

  83.    the <span class="productname">PostgreSQL</span> programs themselves.

  84.    Check the output near the end of the run, it should look something

  85.    like this:

  86. </p><pre class="screen">

  87. checking for xmllint... xmllint

  88. checking for DocBook XML V4.2... yes

  89. checking for dbtoepub... dbtoepub

  90. checking for xsltproc... xsltproc

  91. checking for fop... fop

  92. </pre><p>

  93.    If <code class="filename">xmllint</code> was not found then some of the following

  94.    tests will be skipped.

  95.   </p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="docguide-docbook.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="docguide.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="docguide-build.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">J.1. DocBook </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> J.3. Building the Documentation</td></tr></table></div></body></html>
上海开阖软件有限公司 沪ICP备12045867号-1