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

2.1. Есть ли хорошие книги о FreeBSD?
2.2. Есть ли версии документации в другом формате, например, в виде обычного текста ASCII или PostScript®?
2.3. Где найти информацию по спискам рассылки FreeBSD?
2.4. Какие существуют телеконференции по FreeBSD?
2.5. Существуют ли каналы IRC (Internet Relay Chat) по FreeBSD?
2.6. Где можно пройти платные курсы по FreeBSD и получить поддержку?

2.1. Есть ли хорошие книги о FreeBSD?

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

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

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

2.3. Где найти информацию по спискам рассылки FreeBSD?

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

2.4. Какие существуют телеконференции по FreeBSD?

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

2.5. Существуют ли каналы IRC (Internet Relay Chat) по FreeBSD?

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

2.6. Где можно пройти платные курсы по FreeBSD и получить поддержку?

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

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

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

Этот, и другие документы, могут быть скачаны с ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/.

По вопросам, связанным с FreeBSD, прочитайте документацию прежде чем писать в <questions@FreeBSD.org>.
По вопросам, связанным с этой документацией, пишите <doc@FreeBSD.org>.
По вопросам, связанным с русским переводом документации, пишите в рассылку <frdp@FreeBSD.org.ua>.
Информация по подписке на эту рассылку находится на сайте проекта перевода.

Обновлено: 12.03.2015