[svnbook commit] r1204 - trunk/src/es/book
gradha
svnbook-dev at red-bean.com
Sat Apr 2 14:18:15 CST 2005
Author: gradha
Date: Sat Apr 2 14:18:14 2005
New Revision: 1204
Modified:
trunk/src/es/book/ch07.xml
Log:
Book Spanish. Translated 16 paragraphs.
Modified: trunk/src/es/book/ch07.xml
==============================================================================
--- trunk/src/es/book/ch07.xml (original)
+++ trunk/src/es/book/ch07.xml Sat Apr 2 14:18:14 2005
@@ -1422,118 +1422,119 @@
<sect3 id="svn-ch-7-sect-2.3.4">
<title><literal>svn:keywords</literal></title>
- <para>Subversion has the ability to substitute
- <firstterm>keywords</firstterm>—pieces of useful,
- dynamic information about a versioned file—into the
- contents of the file itself. Keywords generally describe
- information about the last time the file was known to be
- modified. Because this information changes each time the
- file changes, and more importantly, just
- <emphasis>after</emphasis> the file changes, it is a hassle
- for any process except the version control system to keep
- the data completely up-to-date. Left to human authors, the
- information would inevitably grow stale.</para>
-
- <para>For example, say you have a document in which you would
- like to display the last date on which it was modified. You
- could burden every author of that document to, just before
- committing their changes, also tweak the part of the
- document that describes when it was last changed. But
- sooner or later, someone would forget to do that. Instead
- simply ask Subversion to perform keyword substitution on the
- <literal>LastChangedDate</literal> keyword. You control
- where the keyword is inserted into your document by placing
- a <firstterm>keyword anchor</firstterm> at the desired
- location in the file. This anchor is just a string of text
- formatted as
- <literal>$</literal><replaceable>KeywordName</replaceable><literal>$</literal>.</para>
-
- <para>Subversion defines the list of keywords available for
- substitution. That list contains the following five
- keywords, some of which have shorter aliases that you can
- also use:</para>
+ <para>Subversion tiene la capacidad de sustituír
+ <firstterm>palabras clave</firstterm>—trozos dinámicos
+ de información útil sobre un fichero versionado—en
+ el contenido de los propios ficheros. Las palabras clave
+ generalmente describen información sobre la última vez que
+ el fichero fue modificado. Dado que esta información cambia
+ cada vez que el fichero es modificado, y más importante aun,
+ justo <emphasis>después</emphasis> de la modificación, es
+ tarea difícil para todo proceso excepto el sistema de control
+ de versiones, mantener los datos completamente actualizados.
+ Si esta tarea fuese delegada en los autores humanos, la
+ información inevitablemente quedaría desfasada.</para>
+
+ <para>Por ejemplo, digamos que posee un documento en el cual le
+ gustaría mostrar la última fecha en la que fue
+ modificado. Podría obligar a cada autor de ese documento
+ a que, justo antes de enviar sus cambios al repositorio,
+ también modifiquen la parte del documento que describe
+ la última fecha de modificación. Pero tarde o temprano,
+ alguien se olvidará de hacer eso. En su lugar, indique a
+ Subversion que realice la sustitución de la palabra clave
+ <literal>LastChangedDate</literal>. Puede controlar
+ el lugar donde figura esta palabra clave colocando
+ una <firstterm>marca de palabra clave</firstterm>
+ en el lugar apropiado del fichero. Esta marca no
+ es más que una cadena de texto formateada como
+ <literal>$</literal><replaceable>PalabraClave</replaceable><literal>$</literal>.</para>
+
+ <para>Subversion una lista de palabras clave disponibles para ser
+ sustituídas. Esta lista contiene las cinco siguientes palabras
+ clave, algunas de las cuales tienen sinónimos más cortos que
+ también puede usar:</para>
<variablelist>
<varlistentry>
<term><literal>LastChangedDate</literal></term>
<listitem>
- <para>This keyword describes the last time the file was
- known to have been changed in the repository, and
- looks something like <literal>$LastChangedDate:
- 2002-07-22 21:42:37 -0700 (Mon, 22 Jul 2002)
- $</literal>. It may be abbreviated as
- <literal>Date</literal>.</para>
+ <para>Esta palabra clave describe el último momento en
+ que el fichero fue modificado en el repositorio, y tiene
+ el aspecto <literal>$LastChangedDate: 2002-07-22 21:42:37
+ -0700 (Mon, 22 Jul 2002) $</literal>. Puede ser abreviada
+ como <literal>Date</literal>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>LastChangedRevision</literal></term>
<listitem>
- <para>This keyword describes the last known revision in
- which this file changed in the repository, and looks
- something like <literal>$LastChangedRevision: 144
- $</literal>. It may be abbreviated as
- <literal>Revision</literal> or
+ <para>Esta palabra clave describe la última revisión
+ conocida en la que este fichero fue
+ modificado en el repositorio, y tiene el aspecto
+ <literal>$LastChangedRevision: 144 $</literal>. Puede
+ ser abreviada como <literal>Revision</literal> o
<literal>Rev</literal>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>LastChangedBy</literal></term>
<listitem>
- <para>This keyword describes the last known user to
- change this file in the repository, and looks
- something like <literal>$LastChangedBy: harry
- $</literal>. It may be abbreviated as
- <literal>Author</literal>.</para>
+ <para>Esta palabra clave describe el último usuario conocido
+ que modificó este fichero en el repositorio, y tiene
+ el aspecto <literal>$LastChangedBy: harry $</literal>.
+ Puede ser abreviada como <literal>Author</literal>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>HeadURL</literal></term>
<listitem>
- <para>This keyword describes the full URL to the latest
- version of the file in the repository, and looks
- something like <literal>$HeadURL:
+ <para>Esta palabra clave describe la URL completa a la
+ última versión de este fichero en el
+ repositorio, y tiene el aspecto <literal>$HeadURL:
http://svn.collab.net/repos/trunk/README $</literal>.
- It may be abbreviated as
- <literal>URL</literal>.</para>
+ Puede ser abreviada como <literal>URL</literal>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>Id</literal></term>
<listitem>
- <para>This keyword is a compressed combination of the
- other keywords. Its substitution looks something like
- <literal>$Id: calc.c 148 2002-07-28 21:30:43Z sally
- $</literal>, and is interpreted to mean that the file
- <filename>calc.c</filename> was last changed in revision
- 148 on the evening of July 28, 2002 by the user
- <literal>sally</literal>.</para>
+ <para>Esta palabra clave es una combinación comprimida de
+ las otras palabras clave. Su sustitución tiene el
+ siguiente aspecto other keywords. Its substitution
+ looks something like <literal>$Id: calc.c 148 2002-07-28
+ 21:30:43Z carmen $</literal>, y su interpretación
+ indica que el fichero <filename>calc.c</filename>
+ fue modificado por última vez en la revisión 148
+ de la tarde del 28 de Julio del 2002 por el usuario
+ <literal>carmen</literal>.</para>
</listitem>
</varlistentry>
</variablelist>
- <para>Simply adding keyword anchor text to your file does
- nothing special. Subversion will never attempt to perform
- textual substitutions on your file contents unless
- explicitly asked to do so. After all, you might be writing
- a document
+ <para>Añadir únicamente la marca con la palabra clave a su
+ fichero no hace nada especial. Subversion nunca intentará
+ realizar sustituciones textuales en sus ficheros a no ser que
+ usted lo pida explícitamente. Después de todo, quizás esté
+ escribiendo un documento
<footnote>
- <para>… or maybe even a section of a book …</para>
+ <para>… o quizás incluso una sección de un libro …</para>
</footnote>
- about how to use keywords, and you don't want Subversion to
- substitute your beautiful examples of un-substituted keyword
- anchors!</para>
-
- <para>To tell Subversion whether or not to substitute keywords
- on a particular file, we again turn to the property-related
- subcommands. The <literal>svn:keywords</literal> property,
- when set on a versioned file, controls which keywords will
- be substituted on that file. The value is a space-delimited
- list of the keyword names or aliases found in the previous
- table.</para>
-
- <para>For example, say you have a versioned file named
- <filename>weather.txt</filename> that looks like
- this:</para>
+ sobre cómo usar palabras clave, ¡y no desea que Subversion
+ sustituya sus bonitos ejemplos de marcas de palabras claves
+ no sustituídas!</para>
+
+ <para>Para indicar a Subversion si desea o nó sustituir palabras
+ clave en un fichero particular, de nuevo volvemos a usar
+ los subcomandos relacionados con propiedades. La propiedad
+ <literal>svn:keywords</literal>, una vez activada en un fichero
+ versionado, controla qué palabras clave serán sustituídas. El
+ valor es una lista delimitada por espacios con las palabras
+ clave o sinónimos de la tabla anterior.</para>
+
+ <para>Por ejemplo, digamos que tiene un fichero llamado
+ <filename>weather.txt</filename> que tiene el siguiente
+ aspecto:</para>
<programlisting>
Here is the latest report from the front lines.
@@ -1542,10 +1543,10 @@
Cumulus clouds are appearing more frequently as summer approaches.
</programlisting>
- <para>With no <literal>svn:keywords</literal> property set on
- that file, Subversion will do nothing special. Now, let's
- enable substitution of the
- <literal>LastChangedDate</literal> keyword.</para>
+ <para>Sin haber activado la propiedad
+ <literal>svn:keywords</literal> en ese fichero, Subversion
+ no hará nada especial. Ahora, activemos la sustitución de la
+ palabra clave <literal>LastChangedDate</literal>.</para>
<screen>
$ svn propset svn:keywords "LastChangedDate Author" weather.txt
@@ -1553,45 +1554,47 @@
$
</screen>
- <para>Now you have made a local property modification on the
- <filename>weather.txt</filename> file. You will see no
- changes to the file's contents (unless you made some of your
- own prior to setting the property). Notice that the file
- contained a keyword anchor for the <literal>Rev</literal>
- keyword, yet we did not include that keyword in the property
- value we set. Subversion will happily ignore requests to
- substitute keywords that are not present in the file, and
- will not substitute keywords that are not present in the
- <literal>svn:keywords</literal> property value.</para>
+ <para>Ahora acaba de realizar una modificación local de propiedad
+ sobre el fichero <filename>weather.txt</filename>. No verá
+ cambios en el contenido del fichero (a no ser que haya realizado
+ algunos antes de activar la propiedad). Fíjese que el fichero
+ contenía la marca de la palabra clave <literal>Rev</literal>,
+ y no obstante no incluímos esta palabra clave en el valor de
+ la propiedad. Subversion ignorará felizmente peticiones para
+ sustituir palabras clave que no están presentes en el fichero,
+ y no sustituirá palabras clave que no están presentes en el
+ valor de la propiedad <literal>svn:keywords</literal>.</para>
<sidebar>
- <title>Keywords and Spurious Differences</title>
+ <title>Palabras clave y diferencias espurias</title>
- <para>The user-visible result of keyword substitution might
- lead you to think that every version of a file with that
- feature in use differs from the previous version in at
- least the area where the keyword anchor was placed.
- However, this is actually not the case. While checking
- for local modifications during <command>svn
- diff</command>, and before transmitting those local
- modifications during <command>svn commit</command>,
- Subversion <quote>un-substitutes</quote> any keywords that
- it previously substituted. The result is that the
- versions of the file that are stored in the repository
- contain only the real modifications that users make to the
- file.</para>
+ <para>El resultado de la sustitución de palabras clave
+ visible por usuarios finales puede levarle a pensar que
+ cada versión de un fichero que use esta característica
+ diferirá de la versión anterior en almenos el área donde
+ fue colocada la marca de la palabra clave. No obstante,
+ este no es el caso. Mientras se buscan modificaciones
+ locales durante <command>svn diff</command>, y antes de
+ transmitir esas modificaciones locales durante <command>svn
+ commit</command>, Subversion <quote>de-sustituye</quote>
+ <!-- Quizás resustituye? -->palabras clave anteriormente
+ sustituídas. El resultado es que las versiones del fichero
+ que están almacenadas en el repositorio contienen únicamente
+ las modificaciones reales que los usuarios realizan en el
+ fichero.</para>
</sidebar>
- <para>Immediately after you commit this property change,
- Subversion will update your working file with the new
- substitute text. Instead of seeing your keyword anchor
- <literal>$LastChangedDate$</literal>, you'll see its
- substituted result. That result also contains the name of
- the keyword, and continues to be bounded by the dollar sign
- (<literal>$</literal>) characters. And as we predicted, the
- <literal>Rev</literal> keyword was not substituted because
- we didn't ask for it to be.</para>
+ <para>Inmediatamente después de que envíe al repositorio la
+ modificación de esta propiedad, Subversion actualizará
+ la copia local de su fichero con el nuevo texto
+ sustituído. En lugar de ver su marca de palabra clave
+ <literal>$LastChangedDate$</literal>, verá el resultado de
+ su sustitución. El resultado también contendrá el nombre de
+ la palabra clave, y continuará estando rodeado por carácteres
+ de dólar (<literal>$</literal>). Y tal y como predijimos,
+ la palabra clave <literal>Rev</literal> no fue sustituída
+ porque no solicitamos hacerlo.</para>
<screen>
Here is the latest report from the front lines.
@@ -1600,13 +1603,14 @@
Cumulus clouds are appearing more frequently as summer approaches.
</screen>
- <para>If someone else now commits a change to
- <filename>weather.txt</filename>, your copy of that file
- will continue to display the same substituted keyword value
- as before—until you update your working copy. At that
- time the keywords in your <filename>weather.txt</filename>
- file will be re-substituted with information that
- reflects the most recent known commit to that file.</para>
+ <para>Si alguna otra persona envia al repositorio cambios sobre
+ el fichero <filename>weather.txt</filename>, su copia de ese
+ fichero continuará mostrando el mismo valor de la sustitución de
+ la palabra clave—hasta que actualice su copia de trabajo
+ local. Durante ese instante las palabras clave de su fichero
+ <filename>weather.txt</filename> serán re-sustituídas para
+ reflejar la información más reciente de ese fichero enviada
+ al repositorio.</para>
</sect3>
More information about the svnbook-dev
mailing list