26.4.更新文档
=============

文档是 FreeBSD 操作系统的一个组成部分。虽然总是可以在 FreeBSD 网站（\ `文档门户 <https://docs.freebsd.org/>`__\ ）上找到最新版本的 FreeBSD 文档，但如果有一份最新的 FreeBSD 网站、手册、FAQ 和文章的本地副本，也会很方便。

这一节介绍了如何使用源代码或 FreeBSD Ports 来保持 FreeBSD 文档的本地副本的更新。

关于编辑和提交文档更正的信息，请参考 FreeBSD 文档项目新贡献者入门（\ `FreeBSD 文档项目新贡献者入门 <https://docs.freebsd.org/en/books/fdp-primer/>`__\ ）。

26.4.1.从源代码更新文档
-----------------------

从源代码重新编译 FreeBSD 文档需要一系列 FreeBSD 基本系统之外的工具。可以按照 FreeBSD 文档项目入门的这些步骤来安装所需的工具。

安装完成后，使用 ``git`` 来获取一份干净的文档源代码：

.. raw:: latex

   \diilbookstyleinputcell

.. code:: shell-session

   # git clone https://git.FreeBSD.org/doc.git /usr/doc

文档的源代代码的初始下载可能需要一些时间。让它运行，直到完成。

要获取后续更新的文件源代码，可以执行：

.. raw:: latex

   \diilbookstyleinputcell

.. code:: shell-session

   # git pull

文档源代码的最新快照被提取到 **/usr/doc** 后，一切都为更新已安装的文档做好准备。

要进行全面更新，键入：

.. raw:: latex

   \diilbookstyleinputcell

.. code:: shell-session

   # cd /usr/doc
   # make