Документация и поддержка

Chapter 2 Документация и поддержка

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

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

В рамках проекта создан широкий спектр документации, которая доступна в онлайне по следующей ссылке: 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 Французский
    ja_JP.eucJP Японский (кодировка EUC)
    ru_RU.KOI8-R Русский (кодировка KOI8-R)
    zh_TW.Big5 Китайский (кодировка Big5)

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

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

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

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

    2. Все другие форматы генерируют один файл с именем book.format (то есть book.pdb, view.php?faq=book, и так далее).

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

      Схема Описание
      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/view.php?faq=book-split.tar.bz2. Для сгрузки и распаковки этого файла вам нужно сделать вот что.

# fetch ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/
/en_US.ISO8859-1/books/faq/view.php?faq=book-split.tar.bz2
# bzip2 -d view.php?faq=book-split.tar.bz2
# tar xvf view.php?faq=book-split.tar

У вас получится набор файлов .html. Главным является view.php?faq=index, и в нём находится оглавление, вводный материал и ссылки на остальные части документа. После этого вы их можете копировать и перемещать при необходимости на окончательное местоположение.

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

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

2.4. Где можно найти информацию о проблеме 2000 года во FreeBSD?

Полная информация находится на странице Готовности к 2000 году.

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

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

2.6. Существуют ли каналы 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 в Европе.

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

  • Канал #FreeBSD в сети HybNet. Этот канал на самом деле является каналом взаимопомощи. Список серверов можно найти на сайте сети HybNet.



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

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

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

FreeBSD Services Ltd осуществляет коммерческую поддержку FreeBSD в Великобритании (а также продаёт FreeBSD на DVD). Более полную информацию можно получить на их веб-сайте.

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

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

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

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