Есть ли версии документации в другом формате, например, в виде обычного текста ASCII или PostScript?
Да. Документация имеется в нескольких различных форматах и упакованная разными способами на FTP-сервере FreeBSD, и находится она в каталоге /pub/FreeBSD/doc/.
Документация подразделяется на категории различными способами. Это включает:
Имя документа, например, faq или handbook.
Язык и кодировка документа. Они опираются на имена локализаций, которые вы найдёте в каталоге /usr/share/locale вашей системы FreeBSD. На данный момент для документации поддерживаются следующие языки и кодировки:
| en_US.ISO8859-1 | Английский (США) |
| de_DE.ISO8859-1 | Немецкий |
| es_ES.ISO8859-1 | Испанский |
| fr_FR.ISO8859-1 | Французский |
| ja_JP.eucJP | Японский (кодировка EUC) |
| ru_RU.KOI8-R | Русский (кодировка KOI8-R) |
| zh_TW.Big5 | Китайский (кодировка Big5) |
Замечание: Некоторые документы могут иметься не на всех языках.
Формат документа. Мы создаём документацию в нескольких различных форматах. У каждого из форматов имеются свои плюсы и свои минусы. Некоторые форматы лучше подходят для чтения в онлайне, когда как другие предназначены для получения эстетично выглядящей на бумаге копии. Наличие документации во всех этих форматах обеспечивает возможность прочтения нашими пользователями любой её части как с экрана монитора, так и на бумаге после вывода на печать. На данный момент поддерживаются следующие форматы;
| html-split | Набор маленьких связанных друг с другом HTML-файлов. |
| html | Один большой HTML-файл, полностью содержащий документ. |
| pdb | Формат баз данных Palm Pilot, для использования с утилитой iSilo. |
| Adobe's Portable Document Format | |
| ps | PostScript |
| rtf | Rich Text Format от Microsoft [a] |
| txt | Обычный текст |
| Примечания: a. Номера страниц при загрузке в Word автоматически не обновляются. Нажмите CTRL+A, CTRL+END, F9 после загрузки документа для обновления номеров страниц. |
Способ компрессии и создания архива. Сейчас используется три.
В случае формата html-split, файлы архивируются с помощью . Получающийся файл .tar затем подвергается сжатию по схемам, подробно описываемым далее.
Все другие форматы генерируют один файл с именем book.format (то есть book.pdb, book.html, и так далее).
Эти файлы затем сжимаются по двум схемам сжатия.
| zip | Формат Zip. Если вам нужно будет развернуть это во FreeBSD, то потребуется установить сначала порт archivers/unzip. |
| bz2 | Формат BZip2. Используется реже, чем Zip, но, как правило, даёт файлы меньшего размера. Чтобы работать с такими файлами, установите порт archivers/bzip2. |
После выбора формата и способа компрессии, в котором вы хотите получить файл, вы должны определиться, должен ли он быть в виде пакаджа 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, и в нём находится оглавление, вводный материал и ссылки на остальные части документа. После этого вы их можете копировать и перемещать при необходимости на окончательное местоположение.
