Да. Документация имеется в нескольких различных форматах и упакованная разными
способами на FTP-сервере FreeBSD, и находится она в каталоге /pub/FreeBSD/doc/.
Документация подразделяется на категории различными способами. Это включает:
-
Имя документа, например, faq или handbook.
-
Язык и кодировка документа. Они опираются на имена локализаций, которые вы найдёте в
каталоге /usr/share/locale вашей системы FreeBSD. На данный
момент для документации поддерживаются следующие языки и кодировки:
Замечание: Некоторые документы могут иметься не на всех языках.
-
Формат документа. Мы создаём документацию в нескольких различных форматах. У каждого
из форматов имеются свои плюсы и свои минусы. Некоторые форматы лучше подходят для чтения
в онлайне, когда как другие предназначены для получения эстетично выглядящей на бумаге
копии. Наличие документации во всех этих форматах обеспечивает возможность прочтения
нашими пользователями любой её части как с экрана монитора, так и на бумаге после вывода
на печать. На данный момент поддерживаются следующие форматы;
-
Способ компрессии и создания архива. Сейчас используется три.
-
В случае формата html-split, файлы архивируются с помощью
tar(1). Получающийся
файл .tar затем подвергается сжатию по схемам, подробно
описываемым далее.
-
Все другие форматы генерируют один файл с именем book.format (то есть book.pdb, book.html, и так далее).
Эти файлы затем сжимаются по двум схемам сжатия.
Таким образом, версия Руководства в формате PostScript, упакованная с помощью BZip2,
будет находиться в файле с именем book.ps.bz2 в каталоге handbook/.
После выбора формата и способа компрессии, в котором вы хотите получить файл, вы
должны определиться, должен ли он быть в виде пакаджа 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-файлов, упакованная при помощи bzip2(1), находится в
файле doc/ru_RU.KOI8-R/books/faq/book.html-split.tar.bz2. Для
сгрузки и распаковки этого файла вам нужно сделать вот что.
# fetch ftp://ftp.FreeBSD.org/pub/FreeBSD/
doc/en_US.ISO8859-1/books/faq/book.html-split.tar.bz2
# bzip2 -d book.html-split.tar.bz2
# tar xvf book.html-split.tar
У вас получится набор файлов .html. Главным является index.html, и в нём находится оглавление, вводный материал и ссылки
на остальные части документа. После этого вы их можете копировать и перемещать при
необходимости на окончательное местоположение.