Глава 2. Документация и поддержка

В рамках проекта создан широкий спектр документации, которая доступна в on-line по следующей ссылке: http://www.FreeBSD.org/docs.html. Эти же самые документы доступны и в виде пакаджей, которые можно с лёгкостью установить в вашу систему FreeBSD. Детальная информация о пакаджах с документацией может быть найдена в последующих параграфах.

Кроме того, в Библиографии в конце этого FAQ и в Руководстве имеются ссылки на другие рекомендуемые для чтения книги.

Да. Документация имеется в нескольких различных форматах и упакованная разными способами на 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	Французский
  it_IT.ISO8859-15	Итальянский
  ja_JP.eucJP	Японский (кодировка EUC)
  ru_RU.KOI8-R	Русский (кодировка KOI8-R)
  zh_CN.GB2312	Упрощённый китайский (кодировка GB2312)
  zh_TW.Big5	Традиционный китайский (кодировка Big5)

  Замечание: Некоторые документы могут иметься не на всех языках.

• Формат документа. Мы создаём документацию в нескольких различных форматах. У каждого из форматов имеются свои плюсы и свои минусы. Некоторые форматы лучше подходят для чтения в on-line, когда как другие предназначены для получения эстетично выглядящей на бумаге копии. Наличие документации во всех этих форматах обеспечивает возможность прочтения нашими пользователями любой её части как с экрана монитора, так и на бумаге после вывода на печать. На данный момент поддерживаются следующие форматы;

  Формат	Значение
  html-split	Набор маленьких связанных друг с другом HTML-файлов.
  html	Один большой HTML-файл, полностью содержащий документ.
  pdb	Формат баз данных Palm Pilot, для использования с утилитой iSilo.
  pdf	Adobe's Portable Document Format
  ps	PostScript
  rtf	Rich Text Format от Microsoft [a]
  txt	Обычный текст
  Примечания: a. Номера страниц при загрузке в Word автоматически не обновляются. Нажмите CTRL+A, CTRL+END, F9 после загрузки документа для обновления номеров страниц.

• Способ компрессии и создания архива. Сейчас используется три.

  1. В случае формата html-split, файлы архивируются с помощью tar(1). Получающийся файл .tar затем подвергается сжатию по схемам, подробно описываемым далее.

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

Исчерпывающая информация содержится в разделе Руководства, который посвящён спискам рассылки.

Полная информация о группах новостей есть в разделе Руководства, касающемся телеконференций.

Да, большинство сетей IRC имеют канал FreeBSD:

• Канал #FreeBSD в сети EFNet посвящён FreeBSD, но не обращайтесь туда за технической поддержкой и даже не пытайтесь найти человека, который поможет вам обойтись без чтения страниц Справочника или собственных изысканий. Этот канал предназначен в первую и основную очередь для общения, и в круг обсуждаемых тем входят секс, спорт, ядерное оружие, как будто это и есть FreeBSD. В общем, вас предупредили! Канал доступен на сервере irc.chat.org.

• Канал #FreeBSDhelp в сети EFNet предназначен для помощи пользователям FreeBSD. Здесь гораздо более благосклонно относятся к вопросам, чем на канале #FreeBSD.

• Канал #FreeBSD в сети DALNET доступен на сервере irc.dal.net в США и на irc.eu.dal.net в Европе.

• Канал #FreeBSDHelp в сети DALNET доступен на серверах irc.dal.net в США и irc.eu.dal.net в Европе.

• Канал #FreeBSD в сети UNDERNET доступен на серверах us.undernet.org в США и eu.undernet.org в Европе. Так как это канал взаимопомощи, приготовьтесь к чтению документации, к которой вас отошлют.

• Канал #FreeBSD в сети RUSNET это канал для русскоговорящих посетителей, посвящённый помощи пользователям FreeBSD. Также это хорошее место для не технических дискуссий.

Все эти каналы разные и не имеют отношения друг к другу. Их стили общения также отличаются, так что вам, может быть, придётся попробовать все, чтобы найти тот, который соответствует вашему стилю. Как и обычно с любым каналом IRC, если вы легко раздражаетесь или не можете иметь дела с большим количеством лиц школьного (и младшего школьного) возраста, пытающихся озвучить свои попытки самоутвердиться, не обращайте на это внимания.

DaemonNews проводит платные курсы и осуществляет коммерческую поддержку FreeBSD. Дополнительную информацию можно найти на их сайте BSD Mall.

FreeBSD Mall предоставляет поддержку FreeBSD на коммерческой основе. Вы можете получить более полную информацию с их Web-сайта.

Чтобы попасть в этот список, другие организации, осуществляющие обучение и поддержку, должны обратиться к нам в проект.