[svnbook commit] r2812 - trunk/src/ru/book
Maverick.Crank.GRey
noreply at red-bean.com
Fri Jun 29 07:16:44 CDT 2007
Author: Maverick.Crank.GRey
Date: Fri Jun 29 07:16:44 2007
New Revision: 2812
Log:
* src/ru/book/ch-advanced-topics.xml - Vladimir Serdyuk vserd(at)inbox.ru: russian translation syntax fix.
Modified:
trunk/src/ru/book/ch-advanced-topics.xml
Modified: trunk/src/ru/book/ch-advanced-topics.xml
==============================================================================
--- trunk/src/ru/book/ch-advanced-topics.xml (original)
+++ trunk/src/ru/book/ch-advanced-topics.xml Fri Jun 29 07:16:44 2007
@@ -39,7 +39,7 @@
@ENGLISH }}} -->
<para>Однако предоставляемый Subversion набор возможностей не
ограничивается <quote>типовыми операциями управления
- версиями</quote>. У Subversion есть функциональнось, выходящая за пределы
+ версиями</quote>. У Subversion есть функциональность, выходящая за пределы
простого обмена различиями с центральным хранилищем.
</para>
@@ -113,7 +113,6 @@
specific revision numbers by Subversion:</para>
<variablelist>
-
<varlistentry>
<term>HEAD</term>
<listitem>
@@ -232,8 +231,9 @@
</sect2>
- <!-- =============================================================== -->
+ <!-- =============================================================== -->
<sect2 id="svn.tour.revs.dates">
+
<!-- @ENGLISH {{{
<title>Revision Dates</title>
@ENGLISH }}} -->
@@ -693,7 +693,6 @@
change your basic processes to accomodate them.</para>
@ENGLISH }}} -->
<title>Свойства</title>
-
<para>Мы уже рассмотрели как Subversion сохраняет и получает
разные версии файлов и директорий из хранилища. Целые главы были
посвящены этой самой фундаментальной части функциональных
@@ -716,7 +715,7 @@
И лучшим из всего является то, что они тоже версионированы
также как и текстовое содержимое файлов. Можно также просто как и
для текстовых изменений изменять, фиксировать и отменять изменения
- свойств. Отправка и получение редактирований свойств происходит точно
+ свойств. Отправка и получение измененных свойств происходит точно
так же как и обычные фиксации и обновления — для этого нет
необходимости менять обычный порядок действий.</para>
@@ -738,7 +737,7 @@
— читаемое имя и любое бинарное значение. Главное отличие в том,
что свойства правок не версионируются. Другими словами, если изменить
значение свойства правки или удалить такое свойство, у Subversion нет
- возможностей для востановления предыдущего значения.</para>
+ возможностей для восстановления предыдущего значения.</para>
<para>Subversion has no particular policy regarding the use of
properties. It asks only that you not use property names that
@@ -851,7 +850,7 @@
<literal>caption</literal>, <literal>datestamp</literal> и даже
<literal>thumbnail</literal>. В этом случае рабочая копия выглядит
гораздо более управляемо — фактически она будет выглядеть
- так, как-будто она ничего кроме графических файлов не содержит.
+ так, как будто она ничего кроме графических файлов не содержит.
Однако ваш скрипт автоматизации знает больше. Он знает, что может
воспользоваться <command>svn</command> (а еще лучше языковой обвязкой
Subversion — см. <xref
@@ -977,8 +976,8 @@
(<literal>_</literal>); after that, you can also use digits,
hyphens (<literal>-</literal>), and periods
(<literal>.</literal>).
- <footnote>
- <para>If you're familiar with XML, this is pretty much the
+ <footnote>
+ <para>If you're familiar with XML, this is pretty much the
ASCII subset of the syntax for XML "Name".</para>
</footnote>
</para>
@@ -1271,7 +1270,7 @@
как модификация свойств влияет на привычный порядок работы с
Subversion. Как мы уже говорили, так же как и содержимое файлов,
свойства файлов и директорий версионированы. В результате,
- Subversion предоставляет те-же возможности по слиянию
+ Subversion предоставляет те же возможности по слиянию
— в случае конфликтных ситуаций — чужих изменений
с вашими собственными.</para>
@@ -1420,10 +1419,10 @@
@ENGLISH }}} -->
<para>Кроме того нужно помнить о нестандартном подходе, используемом
Subversion при выводе различий для свойств. Безусловно, можно
- запустить <command>svn diff</command> перенправить вывод, для создания
- работоспособного файла отличий. Програма <command>patch</command>
+ запустить <command>svn diff</command> перенаправить вывод, для создания
+ работоспособного файла отличий. Программа <command>patch</command>
будет просто игнорировать различия свойств — как правило,
- она игнорирует любой мусор, который неможет обработать. К сожалению,
+ она игнорирует любой мусор, который не может обработать. К сожалению,
это значит, что для полного применения отличий, сгенерированных
<command>svn diff</command>, изменения свойств нужно вносить в
ручную.</para>
@@ -1431,7 +1430,7 @@
<para>Как видите, наличие измененных свойств никак не отражается
на привычном рабочем цикле. Операции обновления рабочей копии,
проверки статуса файлов и директорий, вывод сообщений о сделанных
- изменениях и фиксация этих измениий в хранилище никак не зависят от
+ изменениях и фиксация этих изменений в хранилище никак не зависят от
наличия или отсутствия свойств. У <command>svn</command> просто
имеется несколько дополнительных подкоманд для внесения изменений в
свойства однако это просто достойное внимания отличие.</para>
@@ -1649,13 +1648,13 @@
как команды определяется битом разрешения выполнения. Обычно по
умолчанию этот бит не установлен и для файлов которым это
необходимо, он должен быть явно установлен пользователем.
- Однако слишком сложно помнить какие именно файлы в только что соданой
- рабочей копии должны иметь установленый бит выполнения, и
+ Однако слишком сложно помнить какие именно файлы в только что созданной
+ рабочей копии должны иметь установленный бит выполнения, и
устанавливать этот бит. Для таких случаев Subversion предлагает
использовать свойство <literal>svn:executable</literal>, как способ
показать для каких файлов бит исполнения должен быть установлен, а
- Subversion в свою очередь, при создании рабочей копии самомстоятельно
- обрабытывает такой запрос для подобных файлов.</para>
+ Subversion в свою очередь, при создании рабочей копии самостоятельно
+ обрабатывает такой запрос для подобных файлов.</para>
<!-- @ENGLISH {{{
<para>This property has no effect on filesystems that have no
@@ -2720,7 +2719,6 @@
Need to make a quick tweak to this image.
$
</screen>
-
<para>Just as <command>svn info</command> can be used to examine
objects in the working copy, it can also be used to examine
objects in the repository. If the main argument to
@@ -2996,8 +2994,12 @@
<!-- ================================================================= -->
<!-- ================================================================= -->
<sect1 id="svn.advanced.externals">
+ <!-- @ENGLISH {{{
<title>Externals Definitions</title>
+ @ENGLISH }}} -->
+ <title>Внешние определения</title>
+ <!-- @ENGLISH {{{
<para>Sometimes it is useful to construct a working copy that is
made out of a number of different checkouts. For example, you
may want different subdirectories to come from different
@@ -3008,7 +3010,17 @@
to achieve. But if this layout is important for everyone who
uses your repository, every other user will need to perform the
same checkout operations that you did.</para>
-
+ @ENGLISH }}} -->
+ <para>Иногда полезно сконструировать рабочую копию так, чтобы делать
+ несколько различных извлечений. Например, вы хотите иметь
+ различные подпапки соответствующие различным путям в
+ хранилище, или возможно из различных хранилищ. Конечно, вы можете
+ выполнить этот сценарий вручную — используя <command>svn
+ checkout</command> для создания требуемой вложенной структуры рабочей
+ копии. Но если этот формат важен для всех кто использует
+ хранилище, каждый новый пользователь нуждается в выполнении тех
+ же операций извлечения что делали и вы.</para>
+ <!-- @ENGLISH {{{
<para>Fortunately, Subversion provides support for
<firstterm>externals definitions</firstterm>. An externals
definition is a mapping of a local directory to the
@@ -3022,6 +3034,21 @@
a multi-line table of subdirectories (relative to the versioned
directory on which the property is set) and fully qualified,
absolute Subversion repository URLs.</para>
+ @ENGLISH }}} -->
+ <para>Ксчастью, Subversion предоставляет поддержку
+ <firstterm>внешних определений</firstterm>. Внешние определения
+ это отображение локальной папки в URL — и возможно
+ конкретной ревизии — версионировнанного ресурса. В
+ Subversion вы декларируете внешние определения в группах используя
+ свойство <literal>svn:externals</literal>. Вы можете создать или
+ изменить это свойство используя <command>svn propset</command> или
+ <command>svn propedit</command> (смотри <xref
+ linkend="svn.advanced.props.manip"
+ />). Оно может быть установлено на любой версионированной папке,
+ и его значение многостроковая таблица подпапок (относительно
+ версионированной папки для которой устанавливается значение) и
+ полные, абсолютные URL в хранилище Subversion.</para>
+
<screen>
$ svn propget svn:externals calc
@@ -3030,6 +3057,7 @@
third-party/skins/toolkit -r21 http://svn.red-bean.com/repos/skin-maker
</screen>
+ <!-- @ENGLISH {{{
<para>The convenience of the <literal>svn:externals</literal>
property is that once it is set on a versioned directory,
everyone who checks out a working copy with that directory also
@@ -3043,6 +3071,21 @@
someone checks out a working copy of the
<filename>calc</filename> directory, Subversion also continues
to checkout the items found in its externals definition.</para>
+ @ENGLISH }}} -->
+ <para>Удобство свойства <literal>svn:externals</literal> заключается
+ в том что однажды установленное на версионную папку, любой кто
+ извлекает рабочую копию с такой папкой также получает преимущества
+ внешнего представления. Другими словами, однажды один человек
+ сделал усилие для определения этих вложенных извлечений рабочих
+ копии, никто другой не беспокоится об этом — Subversion при
+ извлечении оригинальной рабочей копии, будет также извлекать
+ внешнии рабочие копии.</para>
+
+ <para>Примечание к предыдущему примеру внешнего определения. Когда
+ кто-то извлекает рабочую копию папки <filename>calc</filename>,
+ Subversion также продолжает извлекать элементы найденные в его
+ внешних определениях.</para>
+
<screen>
$ svn checkout http://svn.example.com/repos/calc
@@ -3065,6 +3108,7 @@
…
</screen>
+ <!-- @ENGLISH {{{
<para>If you need to change the externals definition, you can do
so using the regular property modification subcommands. When
you commit a change to the <literal>svn:externals</literal>
@@ -3080,8 +3124,24 @@
<command>svn propedit</command> instead of <command>svn
propset</command>.</para>
</tip>
+ @ENGLISH }}} -->
+ <para>Если вы нуждаетесь в изменении внешних определений, вы можете
+ их делать используя обычные подкоманды изменения свойств. Когда вы
+ фиксируете изменения в свойстве <literal>svn:externals</literal>,
+ Subversion будет синхронизировать извлекаемые элементы измененные
+ во внешнем определении при следующем выполнении <command>svn
+ update</command>. Тоже самое будет происходить когда другие
+ обновляют свои рабочие копии и получать ваши изменения во внешнем
+ определении.</para>
+
+ <para>Команда <command>svn status</command> также распознает внешние
+ определения, отображая код статуса <literal>X</literal> для
+ нарушающих структуру подпапок в которые внешние извлечены, и затем
+ рекурсивно по этим подпапкам для отображения статуса самих внешних
+ элементов.</para>
<tip>
+ <!-- @ENGLISH {{{
<para>You should strongly consider using explicit revision
numbers in all of your externals definitions. Doing so means
that you get to decide when to pull down a different snapshot
@@ -3097,6 +3157,22 @@
at that previous revision. For software projects, this could
be the difference between a successful and a failed build of
an older snapshot of your complex codebase.</para>
+ @ENGLISH }}} -->
+ <para>Вы должны тщательно подумать пред использованием конкретной
+ ревизии во всех ваших внешних определениях. Делая так, при
+ переходе к другому снимку внешней информации, вы должны решить к
+ какому конкретно снимку перейти. Помимо этого общего аспекта, вы
+ не должны удивляться изменениям происходящим в хранилищах над
+ которыми вы не имеете никакого контроля, использование
+ конкретной ревизии означает что если вы возвращаете вашу рабочую
+ копию к предыдущей ревизии задним числом, ваши внешние
+ определения также будут возвращены в тот вид, как они выглядели
+ в этой предыдущей ревизии, что в свою очередь означает что
+ внешние рабочие копии будут обновлены для соответствия тому как
+ <emphasis>они</emphasis> выглядели когда ваше хранилище было я
+ в предыдущей ревизии. Для программных проектов это может быть
+ различием между успешной и не успешной сборкой на старых снимках
+ вашей комплексной базы кода. </para>
</tip>
<para>The <command>svn status</command> command also recognizes
@@ -3105,7 +3181,7 @@
externals are checked out, and then recursing into those
subdirectories to display the status of the external items
themselves.</para>
-
+ <!-- @ENGLISH {{{
<para>The support that exists for externals definitions in
Subversion today can be a little misleading, though. First, an
externals definition can only point to directories, not files.
@@ -3139,15 +3215,57 @@
versioned objects in the <filename>project</filename> directory,
even though that directory no longer exists. Be aware, too,
that if you need to re-parent your working copy (using
- <command>svn switch --relocate</command>), externals definitions
+ <command>svn switch --><!--relocate</command>), externals definitions
will <emphasis>not</emphasis> also be re-parented.</para>
+ @ENGLISH }}} -->
+ <para>Поддержка существующих внешних определений в Subversion
+ сегодня может вводить в заблуждение. Во первых, внешние определения
+ могут указывать только на папки, не на файлы. Во вторых, внешние
+ определения не могут указывать на относительные пути (пути
+ подобные <filename>../../skins/myskin</filename>). В третьих,
+ рабочие копии созданные через внешние определения поддерживаются
+ отсоединенными от первичной рабочей копии (на чьи версионированные
+ папки установлено свойство <literal>svn:externals</literal>). И
+ Subversion продолжает по-прежнему оперировать на неотстоединенных
+ (non-disjoint) рабочих копиях. Та что, например, если вы хотите
+ зафиксировать изменения которые вы сделали в одной или более
+ внешней рабочей копии, вы должны явно выполнить <command>svn
+ commit</command> на этих рабочих копиях — фиксация
+ первичной рабочей копии не выполняется рекурсивно на любых внешних
+ определениях.</para>
+
+ <para>Также, так как определения используют абсолютные URL,
+ перемещение или копирование папки к которой они присоединены не
+ будет иметь влияния когда извлекаются как внешние (через
+ относительную локальную целевую подпапку, конечно, перемещение с
+ переименованием папки). Это может сбивать с толку — даже
+ потрясать — в некоторых ситуациях. Например, если вы
+ используете внешнее определение на папке в вашей линии разработки
+ <filename>/trunk</filename> которая указывает на другую область в
+ той же линии, и затем вы используете <command>svn copy</command>
+ для ветвления этой линии в некоторое новое место
+ <filename>/branches/my-branch</filename>, внешние определения на
+ элементах в вашей новой ветке будут продолжать ссылаться на
+ версионированные ресурсы в <filename>/trunk</filename>. Также
+ знайте, что если вы нуждаетесь в re-parent рабочей копии
+ (используя <command>svn switch --relocate</command>), внешние
+ определения <emphasis>не</emphasis> будут re-parented.</para>
+ <!-- @ENGLISH {{{
<para>Finally, there might be times when you would prefer that
<command>svn</command> subcommands would not recognize or
otherwise operate on the external working copies created as the
result of externals definition handling. In those instances,
- you can pass the <option>--ignore-externals</option> option to
+ you can pass the <option>--><!--ignore-externals</option> option to
the subcommand.</para>
+ @ENGLISH }}} -->
+ <para>В заключение может быть случаи когда вы будете предпочитать
+ чтобы подкоманды <command>svn</command> не распознавали или
+ оперировали другим способом с внешними рабочими копиями созданными
+ как результат обработки внешних определений. В этих случаях, вы
+ можете передавать параметр <option>--ignore-externals</option> в
+ подкоманду.</para>
+
</sect1>
</chapter>
More information about the svnbook-dev
mailing list