Часто Задаваемые Вопросы по FreeBSD 2.X, 3.X, 4.X и 5.X


Есть ли версии документации в другом формате, например, в виде обычного текста ASCII или PostScript? - часть 2


  • Все другие форматы генерируют один файл с именем book.format (то есть book.pdb, book.html, и так далее).

    Эти файлы затем сжимаются по двум схемам сжатия.

    Схема

    Описание

    zip Формат Zip. Если вам нужно будет развернуть это во FreeBSD, то потребуется установить сначала порт archivers/unzip.
    bz2 Формат BZip2. Используется реже, чем Zip, но, как правило, даёт файлы меньшего размера. Чтобы работать с такими файлами, установите порт archivers/bzip2.

    Таким образом, версия Руководства в формате 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, и в нём находится оглавление, вводный материал и ссылки на остальные части документа. После этого вы их можете копировать и перемещать при необходимости на окончательное местоположение.




    Начало  Назад  Вперед