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

В рамках проекта создан широкий спектр документации, которая доступна on-line по следующей ссылке: http://www.FreeBSD.org/docs.html. Кроме того, в Библиографии в конце этого FAQ и в Руководстве имеются ссылки на другие рекомендуемые для чтения книги.

Да. Документация имеется в нескольких различных форматах и упакованная разными способами на FTP-сервере FreeBSD, и находится она в каталоге /pub/FreeBSD/doc/.

Документация подразделяется на категории различными способами. Это включает:

• Имя документа, например, faq или handbook.

• Язык и кодировка документа. Они опираются на имена локализаций, которые вы найдёте в каталоге /usr/share/locale вашей системы FreeBSD. На данный момент для документации поддерживаются следующие языки и кодировки:

  Кодировка	Язык
  en_US.ISO8859-1	Английский (США)
  bn_BD.ISO10646-1	Бенгальский или Бангла (Бангладеш)
  da_DK.ISO8859-1	Датский (Дания)
  de_DE.ISO8859-1	Немецкий (Германия)
  el_GR.ISO8859-7	Греческий (Греция)
  es_ES.ISO8859-1	Испанский (Испания)
  fr_FR.ISO8859-1	Французский (Франция)
  hu_HU.ISO8859-2	Венгерский (Венгрия)
  it_IT.ISO8859-15	Итальянский (Италия)
  ja_JP.eucJP	Японский (Япония, кодировка EUC)
  mn_MN.UTF-8	Монгольский (Монголия, кодировка UTF-8)
  nl_NL.ISO8859-1	Голландский (Нидерланды)
  no_NO.ISO8859-1	Норвежский (Норвегия)
  pl_PL.ISO8859-2	Польский (Польша)
  pt_BR.ISO8859-1	Португальский (Бразилия)
  ru_RU.KOI8-R	Русский (Россия, кодировка KOI8-R)
  sr_YU.ISO8859-2	Сербский (Сербия)
  tr_TR.ISO8859-9	Турецкий (Турция)
  zh_CN.GB2312	Упрощённый китайский (Китай, кодировка GB2312)
  zh_TW.Big5	Традиционный китайский (Тайвань, кодировка Big5)

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

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

  Формат	Значение
  html-split	Набор маленьких связанных друг с другом HTML-файлов.
  html	Один большой HTML-файл, полностью содержащий документ.
  pdf	Adobe's Portable Document Format
  ps	PostScript
  rtf	Rich Text Format от Microsoft
  txt	Обычный текст

  Замечание: Номера страниц при загрузке Rich Text Format в Word автоматически не обновляются. Для обновления нумерации нажмите Ctrl+A, Ctrl+End, F9 после загрузки документа.

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

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

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

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

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

     Таким образом, сжатая в bzip2 версия Руководства в формате PostScript, будет находиться в файле с именем book.ps.bz2 в каталоге handbook/.

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

Например, версия 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.efnet.org.

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

• Канал ##FreeBSD в сети Freenode предназначен для помощи общего характера, на нём в любое время присутствует много посетителей. Общение в течение уже некоторого времени известно своей тенденцией сводиться к разговорам не по теме, но приоритет отдается пользователям с вопросами по FreeBSD. Мы рады помочь разобраться в основах, отсылая к Руководству по мере возможности и направляя вас туда, где вы сможете более глубоко изучить интересующие вас темы. В целом, мы являемся англоговорящим каналом, несмотря на то, что к нам приходят пользователи со всего мира. Если вы пожелаете общаться на родном языке, то попробуйте попросить об этом на английском и затем перейдите на другой канал ##freebsd-lang по мере необходимости.

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

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

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

• Канал #bsdchat в сети Freenode это канал для посетителей, говорящих на китайском традиционном языке (кодировка UTF-8), посвящённый помощи пользователям FreeBSD. Также это хорошее место для не технических дискуссий.

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

Официальные форумы FreeBSD расположены по адресу http://forums.FreeBSD.org/.

iXsystems, Inc., дочерней компанией которой является FreeBSD Mall, предоставляет поддержку FreeBSD и программного обеспечения PC-BSD на коммерческой основе, в дополнение к разработке FreeBSD и решениям, требующим тонкой настройки.

BSD Certification Group, Inc. предоставляет сертификацию системного администрирования DragonFly BSD, FreeBSD, NetBSD, OpenBSD. Если вы в этом заинтересованы, посетите их сайт.

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