Gentoo Logo

Настольная книга Gentoo

Содержание:

1.  Общие сведения

Имеющиеся языки

Настольная книга Gentoo представлена на следующих языках:

английский | бразильский португальский | испанский | итальянский | немецкий | польский | румынский | русский | традиционный китайский | французский | чешский | японский

Введение

Добро пожаловать на страницу настольной книги Gentoo. Здесь даются некоторые пояснения по настольной книге Gentoo, которые скорее всего отвечают на большинство ваших вопросов. Мы расскажем об идеях, лежащих в основе книги, о ее текущем состоянии, о будущих планах, об обработке запросов на изменения и т. д.

2.  Просмотр настольной книги

Формат Описание Издания
HTML Последняя версия, по главе на страницу, удобна для просмотра он-лайн x86, sparc, amd64, ppc, ppc64, alpha, hppa, mips
HTML Последняя версия, все главы на одной странице x86, sparc, amd64, ppc, ppc64, alpha, hppa, mips
HTML Последняя версия, все главы на одной странице, для печати x86, sparc, amd64, ppc, ppc64, alpha, hppa, mips
HTML Специальные инструкции по бессетевой установке выпуска 2006.1 настольная книга Gentoo 2006.1 (англ.)

Также существуют отдельные издания для различных выпусков Gentoo, в которые включены указания по установке с компакт-диска без использования подключения к сети. Если вас интересует бессетевая установка, обращайтесь к настольной книге Gentoo Linux 2006.1 (англ.) для своей архитектуры.

Предыдущие выпуски

Для истории мы также храним издания настольной книги, относящиеся к предыдущим выпускам (начиная с 2004.2; на английском языке). Для вывода представления отдельной страницы для печати можно перейти по ссылке «для печати», находящейся вверху справа. Чтобы вывести представление «все главы на одной странице», к адресу URL добавьте ?full=1.

Предупреждение: Эти издания не поддерживаются.

Выпуск Архитектура
2004.2 (англ.) alpha, amd64, hppa, mips, ppc, sparc, x86
2004.3 (англ.) amd64, hppa, ppc, sparc, x86
2005.0 (англ.) alpha, amd64, hppa, ppc, sparc, x86
2005.1 (англ.) alpha, amd64, hppa, ppc, sparc, x86
2006.0 alpha, amd64, hppa, ppc, ppc64, sparc, x86

3.  Проект настольной книги

Цель

Цель проекта настольной книги Gentoo — создание связного документа, описывающего каждый мыслимый аспект Gentoo Linux. Она призвана объединить существующие руководства так, чтобы для каждой архитектуры, каждой установки, каждого пользователя годился один и тот же документ. Это не только облегчает поддержку, но и показывает пользователю, что расхождения незначительны, а различные архитектуры нет смысла рассматривать по отдельности.

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

Состояние

На данный момент завершена и официально опубликована четвертая часть, настройка сети в Gentoo. В ней подробно раскрываются возможности настройки сети для нового стабильного базового набора (baselayout).

Если вы хотите принять участие в развитии настольной книги Gentoo, пишите нам в список рассылки gentoo-doc, или напрямую Sven Vermeulen (по-английски). Предварительная подписка на список рассылки обязательна.

Примечание: По вопросам, относящимся к русскому переводу настольной книги Gentoo, обращайтесь в список рассылки gentoo-doc-ru (по-русски; предварительная подписка обязательна). Или просто напишите письмо Алексею Чумакову. — прим. пер.

Сообщения об ошибках и запросы на изменения

Если вы обнаружите ошибку в руководстве, зайдите на страницу Gentoo Linux Bugzilla (англ.) и создайте запрос в разделе Docs-user, компонент Handbook (пишите по-английски).

4.  Распространенные вопросы

Нельзя ли динамически создавать свое издание руководства для каждого варианта установки, как по волшебству?

Теоретически, в мире возможно все что угодно, но такого мы решили не делать по нескольким причинам.

Поддержка руководства стала бы значительно сложнее. Нам не только пришлось бы искать, к каким именно вариантам относятся отчеты об ошибках (а далеко не все пишут в отчетах даже о своих предшествующих действиях), но и стало бы значительно сложнее писать руководство «на одном дыхании»: мы бы больше отвлекались на порядок строк, согласование фраз и т.п.

Хотя пока есть только версия он-лайн, уже разрабатываются и другие форматы, например, PDF-версии. Если бы мы создавали свой PDF для каждой архитектуры и каждой конфигурации, нам приходилось бы поддерживать огромное количество PDF-файлов, отличающихся лишь парой разделов. Это — совершенно бесполезная трата ресурсов :).

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

Раздел «установка Gentoo» — не единственная часть настольной книги Gentoo. Он, конечно, находится в начале, но все разделы, следующие за ним, не зависят от пользовательского выбора. Реализация динамической подборки всего лишь из-за различий в указаниях по установке стала бы смертельной для проекта настольной книги.

Когда описание различных возможностей не вынесено в разные издания, пользователю хорошо видны последствия других вариантов выбора. Это приводит к большей наглядности указаний по установке.

Я не могу найти в настольной книге Gentoo сведения о stage1

Инструкции по установке из архива первой или второй стадии (stage1 или stage2) теперь находятся в сборнике распространенных вопросов Gentoo. Сейчас установка из архива stage3 — единственная, для которой предоставляется поддержка.

Настольные книги Gentoo для конкретных выпусков (например, книга по 2005.1) предназначены только для бессетевой установки. Для установки stage1 или stage2 требуется исходный код, отсутствующий на универсальном установочном диске, поэтому для выполнения установки stage1 или stage2 потребуется работоспособное подключение к интернету.

Я не согласен с ...

Пожалуйста, выскажите ваше предложение (по-английски); простым несогласием без конструктивного предложения делу не поможешь. Мы выпускаем документацию, рассчитанную на все сообщество, поэтому с благодарностью принимаем обратную связь от его членов.

Однако, не лишне понимать, что большинство решений, принимаемых при разработке документации, основано на нашем общем мнении. Невозможно составить или организовать документацию так, чтобы она устроила всех и каждого. Вы должны быть готовы и к ответу «нет» на свое предложение, если мы посчитаем, что текущий вариант и так устраивает большинство людей.



Для печати

Обновлено 1 сентября 2006

Исходный документ обновлен 26 апреля 2008

Аннотация: Настольная книга Gentoo — это попытка собрать накопленную документацию в связное руководство. В книге содержатся инструкции по различным способам установки с использованием интернета, а также части, посвященные работе с Gentoo и Portage.

Sven Vermeulen
автор

Analyzer
переводчик

Эльдар Цраев
переводчик

Алексей Чумаков
переводчик, редактор перевода

Donate to support our development efforts.

Support OSL

Support OSL

Gentoo Centric Hosting: vr.org

VR Hosted

Tek Alchemy

Tek Alchemy

SevenL.net

SevenL.net

Global Netoptex Inc.

Global Netoptex Inc.

Linux World Expo

Linux World Expo

Copyright 2001-2008 Gentoo Foundation, Inc. Questions, Comments? Contact us.