23.3. 更新文件集

说明文件是FreeBSD操作系统不可或缺的一部份。最新版本的FreeBSD文件除了可在FreeBSD网站(https://www.freebsd.org/doc/)取得,也可很简单的取得本地的FreeBSD网站、使用手册、FAQ及文章副本。

本节将说明如何使用源码与FreeBSD Port套件集来取得最新版本FreeBSD文件本地复本。

有关编辑与提出修正说明文件的信息,请参考FreeBSD文件计划入门书(https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/)。

23.3.1. 自源码更新说明文件

从源码构建 FreeBSD 文档需要一组不属于 FreeBSD 基本系统的工具。所需的工具可以从 FreeBSD 文档项目开发的textproc/docproj软件包或 Port 安装。

安装后,使用svnlite获取文档源码:

# svnlite checkout https://svn.FreeBSD.org/doc/head /usr/doc

第一次下载文件源码需要一些时间,请耐心等候执行完毕。

往后更新文件源码可执行:

# svnlite update /usr/doc

下载最新的文件源码到/usr/doc之后,便完成要更新已安装文件的准备动作。

完整更新所有可用的语言可以执行:

# cd /usr/doc
# make install clean

若只想要更新特定语言,可对/usr/doc中特定语言的子目录执行make

# cd /usr/doc/en_US.ISO8859-1
# make install clean

另一个更新文件的方式是在/usr/doc或特定的语言子目录下执行此指令:

# make update

要指定安装的输出格式可使用FORMATS来设定:

# cd /usr/doc
# make FORMATS='html html-split' install clean

有数个选项可更新部份文件或只编译特定翻译来简化更新程序。这些选项可在/etc/make.conf设为系统全局的预设选项,或是透过指令传送给make

选项有:

DOC_LANG

要编译与安装的语言及编码清单,例如en_US.ISO8859-1代表英语文件。

FORMATS

要编译的输出格式清单,目前支持htmlhtml-splittxtps以及pdf

DOCDIR

要安装文件的位置,预设为/usr/share/doc

要取得更多可做为FreeBSD系统全局选项的make变数,请参考make.conf(5)

23.3.2. 自Port更新说明文件

Based on the work of Marc Fonvieille.

前一节介绍了由源码更新FreeBSD文件的方法,本节将说明使用Port套件集的替代方法,可由以下方式达成:

  • 安装事先编译好的文件套件,无须在本地编译任何东西或安装文件工具集。

  • 使用Port框架来编译文件源码,可让取得与编译文件的步骤更简单。

这个更新FreeBSD文件的方法,会使用到一系列由文件工程团队每月更新的文件Port与套件。这些套件列于FreeBSD Port套件集的docs分类下(http://www.freshports.org/docs/)。

文件Port的组织方式如下:

当使用Binary套件时,会安装指定语言FreeBSD文件的所有可用格式。例如以下指令会安装最新的匈牙利语文件套件:

# pkg install hu-freebsd-doc

注意:

套件使用的名称格式与Port的名称不同:lang-freebsd-doc,其中lang是语言代码的缩写,例如hu代表匈牙利语,zh_cn代表简体中文。

要指定文件的格式,需以编译Port来代替安装套件。例如要编译并安装英语文件:

# cd /usr/ports/misc/freebsd-doc-en
# make install clean

Port提供设定选单来指定要编译与安装的格式,预设会选择分页的HTML(类似http://www.FreeBSD.org使用的格式)以及PDF

此外,编译文件Port时也可指定数个make选项,包括:

WITH_HTML

编译一份文件使用一个HTML档的HTML格式。格式化后的文件会储存至名称为article.htmlbook.html的档案。

WITH_PDF

格式化的文件会储存至名称为article.pdfbook.pdf的档案。

DOCBASE

指定要安装文件的位置,预设为/usr/local/share/doc/freebsd

以下示例使用变数来安装PDF的匈牙利语文件到特定目录:

# cd /usr/ports/misc/freebsd-doc-hu
# make -DWITH_PDF DOCBASE=share/doc/freebsd/hu install clean

文件套件或Port可以依第 4 章 使用 Package 和 Ports 安装应用程序的说明更新。例如以下指令会使用ports-mgmt/portmaster更新已安装的匈牙利语文件:

# portmaster -PP hu-freebsd-doc

本文档和其它文档可从这里下载: ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/.

如果对于FreeBSD有问题,请先阅读 文档,如不能解决再联系 <questions@FreeBSD.org>.

关于本文档的问题请发信联系 <doc@FreeBSD.org>.