[gentoo-doc-ru] Давно обещанное - комментарии к редактуре Азамата Хакимова

[gentoo-doc-ru] Давно обещанное - комментарии к редактуре Азамата Хакимова

[achumakov]

Как я обещал когда-то, разбираю первый редакторский опыт Азамата.
В целом все отлично, и я почти придираюсь ;-)

Ниже - diff с комментариями. Думаю, что будет полезно всем!


Спасибо, Азамат! (если, конечно, ты дочитал до сюда ;)
Буду рад и дальше видеть тебя в активных участниках!

Алексей Чумаков



--- D:\Cay\hobby\?\gentoo\gentoo-doc\doc\ru\handbook\hb-working-use.xml
2006-03-20 19:02:20.000000000 +0000
+++ hb-working-use.xml	2006-03-24 17:11:40.000000000 +0000
-<title>Суть USE-флагов</title>
+<title>Смысл USE-флагов</title>

Дело вкуса...


-Когда вы устанавливаете Gentoo (или любой другой дистрибутив, или даже
-операционную систему вообще), вы выбираете те или иные возможности в
зависимости
-от среды, с которой работаете. Установка сервера отличается от установки
рабочей
-станции, а установка игровой станции &mdash; от платформы 3D-рендеринга.
+Устанавливая Gentoo (или любой другой дистрибутив, или даже операционную 
+систему вообще), вы выбираете те или иные возможности в зависимости от
среды, с 
+которой работаете. Установка сервера отличается от установки рабочей
станции, а 
+установка игровой станции &mdash; от платформы 3D-рендеринга.

Лишние слова-связки "когда, который, было, будет" лучше устранять,
перефразируя
предложение.


 Это касается не только того, какие пакеты устанавливать, но и какие функции
-должны поддерживаться. Если вам не нужен OpenGL, то зачем вам его ставить
-и собирать поддержку OpenGL в большинстве программ? Если вы не собираетесь
-использовать KDE, зачем вам собирать пакеты с его поддержкой, если они
работают
-и без этого?
+определенных пакетов должны поддерживаться. Если вам не нужен OpenGL, то
зачем 
+вам его ставить и встраивать поддержку OpenGL в большинство программ? Если
вы 
+не собираетесь использовать KDE, зачем собирать пакеты с его поддержкой,
если 
+они работают и без этого?
 
Поправка в сторону оригинала; лишнее "вам"


 Чтобы помочь пользователям в выборе того, что устанавливать/активировать, а
что
-нет, мы предоставляем им простой способ описания рабочей среды. Это
позволяет
-пользователю решить, что же ему на самом деле надо и облегчить работу с
Portage,
-нашей системой управления пакетами.
+&mdash; нет, мы захотели дать им простой способ описания рабочей среды. Это

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

Тире.


-
-Рассмотрим USE-флаги. USE-флаг представляет собой ключевое слово,
описывающие
-поддержку и зависимости той или иной функции или концепции. Если вы
определяете
-какой-то USE-флаг, то Portage будет знать, что вы хотите активировать
поддержку
-данной функции. Конечно, это изменит также и информацию о зависимостях для
-пакета.
+Рассмотрим USE-флаги. USE-флаг &mdash; это ключевое слово, включающее
сведения 
+о поддержке и зависимостях определенного понятия или функции. При
определении
+какого-либо USE-флага, Portage узнает, что вам нужна поддержка
соответствующей
+функции. Конечно, это также влияет на сведения о зависимостях пакета.

Лишняя пустая строка удалена
Текст переведен ближе к оригиналу (см. первое предложение)

 
-Давайте рассмотрим конкретный пример &mdash; ключевое слово <c>kde</c>.
Если у
-вас нет этого слова в переменной <c>USE</c>, то все пакеты, где поддержка
KDE
-является <e>необязательной</e>, будут собраны <e>без</e> нее. Все пакеты,
где
-зависимость от KDE является <e>необязательной</e>, будут установлены
<e>без</e>
-установки библиотек KDE в качестве зависимости. Если же вы определили
ключевое
-слово <c>kde</c>, то эти пакеты будут собраны с поддержкой KDE, и KDE будет
-установлен как необходимая зависимость.
+Давайте рассмотрим конкретный пример &mdash; ключевое слово <c>kde</c>.
Если в
+вашей переменной <c>USE</c> нет этого слова, то все пакеты, где поддержка
KDE
+является <e>необязательной</e>, собрираются <e>без</e> нее. Все пакеты, где
+зависимость от KDE является <e>необязательной</e>, устанавливаются
<e>без</e>
+установки библиотек KDE (по зависимости). Если же вы определите ключевое
+слово <c>kde</c>, то эти пакеты будут собираться <e>с поддержкой</e> KDE, а
KDE 
+будет установлен в качестве необходимого.

Слова-паразиты "будут", чуть короче.


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

В оригинале - tailored

 
-<title>Какие существуют USE-флаги?</title>
+<title>Какие USE-флаги существуют?</title>

Построение фразы по-русски и по-английски иногда прямо противоположное


-Существует два типа USE-флагов: <e>глобальный</e> и <e>локальный</e>.
+Есть два типа USE-флагов: <e>глобальные</e> и <e>локальные</e>.

"Существуют" указано выше


     <e>Глобальный</e> USE-флаг используется несколькими пакетами и является
-    системным. Это и есть то, что видят большинство пользователей в
качестве
-    USE-флагов.
+    системным. Это то, что большинство видит в качестве USE-флагов.

Лишние слова


-    <e>Локальный</e> USE-флаг используется одним пакетом для каких-то
-    специфичных для него настроек.
+    <e>Локальный</e> USE-флаг используется единичным пакетом для настройки
+    определенных параметров самого пакета.

Все равно коряво, но мне показалось лучше.

 
 Список доступных глобальных USE-флагов можно найти <uri
 link="/dyn/use-index.xml">в сети</uri> или локально в
-<path>/usr/portage/profiles/use.desc</path>. Вот небольшая (<e>далеко</e>
не
-полная) выдержка:
+<path>/usr/portage/profiles/use.desc</path>.
 </p>
 
-<pre caption="Короткая выдержка из списка доступных USE-флагов">
-gtk     - поддержка x11-libs/gtk+ (The GIMP Toolkit)
-gtk2    - использовать gtk+-2.0 вместо gtk+-1.2 если программа поддерживает
оба
-gtkhtml - поддержка gnome-extra/gtkhtml
-guile   - поддержка dev-util/guile (интерпретатор для Scheme)
-icc     - использовать компилятор Intel C++ если пакет поддерживает его
-icc-pgo - включить генерацию данных PGO или использовать при использовании
icc
-imap    - поддержка протокола IMAP
-</pre>
 <p>
-Список локальных USE-флагов можно найти в
+Список локальных USE-флагов находится в вашей системе в
 <path>/usr/portage/profiles/use.local.desc</path>.
 </p>

Какой-то кусок случайно попал из более старой версии; удален

 
-<title>Использование USE-флагов.</title>
+<title>Использование USE-флагов</title>
-<title>Определение постоянных USE-флагов.</title>
+<title>Объявление постоянных USE-флагов</title>

Точки в заголовках не нужны


-Надеемся, что теперь у вас нет сомнений в необходимости USE-флагов, и мы
можем
-вам рассказать, как их установить.
+В надежде, что вы убедились в важности USE-флагов, теперь мы расскажем, как
их 
+объявлять.

Просто ближе к оригиналу


-Как было ранее сказано, все USE-флаги определяются в переменной <c>USE</c>.
-Чтобы упростить пользователям поиск и выбор флагов, мы предоставляем
настройки
-USE <e>по умолчанию</e>, которые представляют собой список USE-флагов,
которые,
-как нам кажется, наиболее часто используются пользователями Gentoo. Эти
-настройки прописаны в файле <path>make.defaults</path> вашего профиля.
+Как сказано ранее, все USE-флаги объявляются в переменной <c>USE</c>.
+Чтобы упростить пользователям поиск и выбор флагов, мы предлагаем значение
+USE <e>по умолчанию</e>, которое представляют собой список USE-флагов,
+как нам кажется, наиболее часто используемых пользователями Gentoo. Это
+значение приведено в файле <path>make.defaults</path> вашего профиля.

Здесь и часто далее слово setting надо переводить как "значение" а не как
"установка".

 
-Профиль вашей системы <path>/etc/make.profile</path> является
-символической ссылкой. Каждый профиль работает на основе предыдущего, более
-крупного, а в конце получается результат сложения всех профилей. Верхний
профиль
-является <path>базовым</path> (<path>/usr/portage/profiles/base</path>).
+Профиль, на который ориентируется ваша система, указывается символьной
ссылкой
+<path>/etc/make.profile</path>. Каждый профиль основывается на предыдущем, 
+более крупном, а итоговый складывается из всех профилей. Верхним является
+<path>базовый</path> профиль (<path>/usr/portage/profiles/base</path>).

Перефразировал ближе к оригиналу


-В качестве примера, мы уберем java из настроек USE на время установки
mozilla.
+Например, уберем java из значения USE на время установки mozilla.

Короче


-<pre caption="Запускаем emerge --info">
+<pre caption="Запуск emerge --info">

Заголовки лучше передавать так, а главное - однородно в документе


-Если вы изменили свои USE-фалги и хотите обновить всю систему под новое
значение
-USE, запустите <c>emerge</c> с опцией <c>--newuse</c>
+Если вы изменили свои USE-флаги и хотите обновить всю систему в
соответствии с 
+новым значением USE, запустите <c>emerge</c> с параметром <c>--newuse</c>:

Слово "опция" - ругательное; НЕ ОБСУЖДАЕТСЯ!

 
-<title>Специфичные для пакетов USE-флаги</title>
+<title>USE-флаги отдельных пакетов</title>

Слово specific тонко переводится: и как конкретный, и как определенный,
и как специфичный, и как просто "относящийся к ..."



-- 
gentoo-doc-ru@gentoo.org mailing list

[gentoo-doc-ru] Re: Давно обещанное - комментарии к редактуре Азамата Хакимова

[Azamat H. Hackimov]

Эээ, типа пинг. Жива рассылка-то еще? С правкой и замечаниями согласен, но! 
Это было почти год назад, одна из моих первых работ :), так что не шпуняйте, 
а то сам у кого угодно понайду всего :).
-- 
With Love from Syberia!

-- 
gentoo-doc-ru@gentoo.org mailing list

Re: [gentoo-doc-ru] Re: Давно обещанное - комментарии к редактуре Азамата Хакимова

[Alex Korshunov]

Azamat H. Hackimov wrote:

>Эээ, типа пинг. Жива рассылка-то еще? С правкой и замечаниями согласен, но! 
>Это было почти год назад, одна из моих первых работ :), так что не шпуняйте, 
>а то сам у кого угодно понайду всего :).
>  
>
Интересно, на неё подписаны полторы калеки или больше? Я только сегодня 
подписался, не знал, что она чуть жива.

-- 
gentoo-doc-ru@gentoo.org mailing list

[gentoo-doc-ru] RE: [gentoo-doc-ru] Re: Давно обещанное - комментарии к редактуре Азамата Хакимова

[info]

Вообще-то на нее подписано более сотни человек. 
Жива. Вас видно. 

-----Original Message-----
From: Alex Korshunov [mailto:akorshunov@hrs.ru] 
Sent: Wednesday, April 05, 2006 10:05 PM
To: gentoo-doc-ru@lists.gentoo.org
Subject: Re: [gentoo-doc-ru] Re: Давно обещанное - комментарии к редактуре
Азамата Хакимова

Azamat H. Hackimov wrote:

>Эээ, типа пинг. Жива рассылка-то еще? С правкой и замечаниями согласен, но!

>Это было почти год назад, одна из моих первых работ :), так что не 
>шпуняйте, а то сам у кого угодно понайду всего :).
>  
>
Интересно, на неё подписаны полторы калеки или больше? Я только сегодня
подписался, не знал, что она чуть жива.

--
gentoo-doc-ru@gentoo.org mailing list

-- 
gentoo-doc-ru@gentoo.org mailing list

[gentoo-doc-ru] RE: [gentoo-doc-ru] Re: Давно обещанное - комментарии к редактуре Азамата Хакимова

[achumakov]

Азамат!

Просто это был мой должок - прокомментировать.
Как планы на участие?

Алексей 

-----Original Message-----
From: Azamat H. Hackimov [mailto:azazello1984@mail.ru] 
Sent: Wednesday, April 05, 2006 9:53 PM
To: gentoo-doc-ru@lists.gentoo.org
Subject: [gentoo-doc-ru] Re: Давно обещанное - комментарии к редактуре
Азамата Хакимова

Эээ, типа пинг. Жива рассылка-то еще? С правкой и замечаниями согласен, но! 
Это было почти год назад, одна из моих первых работ :), так что не шпуняйте,
а то сам у кого угодно понайду всего :).
--
With Love from Syberia!

--
gentoo-doc-ru@gentoo.org mailing list

-- 
gentoo-doc-ru@gentoo.org mailing list