Да. Документация имеется в нескольких
различных форматах и упакованная разными способами на
FTP-сервере FreeBSD, и находится она в каталоге /pub/FreeBSD/doc/.
Документация подразделяется на категории различными
способами. Это включает:
-
Имя документа, например, faq или handbook.
-
Язык и кодировка документа. Они опираются на
имена локализаций, которые вы найдёте в каталоге
/usr/share/locale вашей
системы FreeBSD. На данный момент для документации
поддерживаются следующие языки и кодировки:
Note: Некоторые документы могут
иметься не на всех языках.
-
Формат документа. Мы формируем документацию в
нескольких различных форматах, пытаясь сделать её
максимально гибкой. Имеющиеся форматы;
-
Способ компрессии и создания архива. Сейчас
используется три.
-
В случае формата html-split, файлы архивируются с
помощью tar(1).
Получающийся файл .tar затем подвергается сжатию
по схемам, подробно описываемым далее.
-
Все другие форматы генерируют один файл с
именем book.format (то есть
book.pdb, book.html, и так далее).
Эти файлы затем сжимаются по трём схемам
сжатия.
Таким образом, версия Руководства в формате
Postscript, упакованная с помощью BZip2, будет
находиться в файле с именем book.ps.bz2 в каталоге handbook/.
-
Отформатированная документация также
доступна в виде пакаджей FreeBSD, о чём пойдёт
речь несколько позже.
После выбора формата и способа компрессии, в котором
вы хотите получить файл, вы должны определиться, должен
ли он быть в виде пакаджа FreeBSD.
Плюсом сгрузки и установки в виде пакаджа является
то, что документация затем может управляться обычными
средствами для работы с пакаджами, такими, как pkg_add(1) и pkg_delete(1).
Если вы решили сгрузить и установить пакадж, то вы
должны знать имя файла. Файлы, содержащие документацию
в виде пакаджей, находятся в каталоге packages. Каждый такой файл имеет вид
document-name.lang.encoding.format.tgz.
Например, FAQ на английском языке в формате PDF
находится в пакадже faq.en_US.ISO8859-1.pdf.tgz.
Зная это, для установки пакаджа с англоязычным FAQ в
формате PDF вы можете воспользоваться следующей
командой.
# pkg_add ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/packages/faq.en_US.ISO8859-1.pdf.tgz
Сделав это, можно использовать утилиту pkg_info(1) для
определения того, куда файл был установлен.
# pkg_info -f faq.en_US.ISO8859-1.pdf
Information for faq.en_US.ISO8859-1.pdf:
Packing list:
Package name: faq.en_US.ISO8859-1.pdf
CWD to /usr/share/doc/en_US.ISO8859-1/books/faq
File: book.pdf
CWD to .
File: +COMMENT (ignored)
File: +DESC (ignored)
Как видите, book.pdf будет
установлен в /usr/share/doc/en_US.ISO8859-1/books/faq.
Если же вы не хотите использовать пакаджи, то вам
нужно самим сгрузить упакованные файлы, распаковать их,
а затем скопировать документацию в соответствующие
места.
Например, версия FAQ в виде отдельных HTML-файлов,
упакованная при помощи gzip(1), находится
в файле doc/ru_RU.KOI8-R/books/faq/book.html-split.tar.gz.
Для сгрузки и распаковки этого файла вам нужно сделать
вот что.
# fetch ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/en_US.ISO8859-1/books/faq/book.html-split.tar.gz
# fetch ftp://ftp.freebsd.org/pub/FreeBSD/doc/en_US.ISO8859-1/books/faq/book.html-split.tar.gz
# gzip -d book.html-split.tar.gz
# tar xvf book.html-split.tar
У вас получится набор файлов .html. Главным является index.html, и в нём находится
оглавление, вводный материал и ссылки на остальные
части документа. После этого вы их можете копировать и
перемещать при необходимости на окончательное
местоположение.
