Часто задаваемые вопросы по FreeBSD 4.X, 5.X и 6.X
Пред. |  | След.

# Глава 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>.
Информация по подписке на эту рассылку находится на сайте проекта перевода.