[svnbook-pt-br commit] r65 - trunk/book

codesite-noreply at google.com codesite-noreply at google.com
Thu Mar 20 18:18:22 CDT 2008


Author: brunolmfg
Date: Thu Mar 20 16:17:38 2008
New Revision: 65

Modified:
   trunk/book/ch03-advanced-topics.xml

Log:
Tradução do capítulo 3 - Tópicos Avançados, seção:
  * Substituição de Palavra-Chave (em progresso...)


Modified: trunk/book/ch03-advanced-topics.xml
==============================================================================
--- trunk/book/ch03-advanced-topics.xml	(original)
+++ trunk/book/ch03-advanced-topics.xml	Thu Mar 20 16:17:38 2008
@@ -1360,112 +1360,112 @@
   <!-- ================================================================= -->
   <!-- ================================================================= -->
   <sect1 id="svn.advanced.props.special.keywords">
-    <title>Keyword Substitution</title>
+    <title>Substituição de Palavra-Chave</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 provide
-      information about the last modification made to the file.
-      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>All keywords are case-sensitive where they appear as
-      anchors in files: you must use the correct capitalization in
-      order for the keyword to be expanded.  You should consider the
-      value of the <literal>svn:keywords</literal> property to be
-      case-sensitive too—certain keyword names will be recognized
-      regardless of case, but this behavior is deprecated.</para>
-
-    <para>Subversion defines the list of keywords available for
-      substitution.  That list contains the following five keywords, 
-      some of which have aliases that you can also use:</para>
+    <para>O Subversion possui a capacidade de substituir
+      <firstterm>palavras-chave</firstterm>—pedaços de informação
+      úteis e dinâmicos sobre um arquivo versionado—dentro do
+      conteúdo do próprio arquivo.  As palavras-chave geralmente fornece
+      informação sobre a última modificação realizada no arquivo.
+      Pelo fato desta informação modificar toda vez que o arquivo
+      é modificado, e mais importante, apenas
+      <emphasis>depois</emphasis> que o arquivo é modificado, isto é um aborrecimento
+      para qualquer processo a não ser que o sistema de controle de versão mantenha
+      os dados completamente atualizados.  Se deixada para os autores humanos, a
+      informação se tornaria inevitavelmente obsoleta.</para>
+
+    <para>Por exemplo, digamos que você tem um documento no qual gostaria
+      de mostrar a última data em que ele foi modificado.  Você
+      poderia obrigar que cada autor deste documento que, pouco antes de
+      submeter suas alterações, também ajustasse a parte do
+      documento que descreve quando ele fez a última alteração.  Porém,
+      mais cedo ou mais tarde, alguém esqueceria de fazer isto.  Em vez disso,
+      basta solicitar ao Subversion que efetue a substituição da palavra-chave
+      <literal>LastChangedDate</literal> pelo valor adequado.  Você controla
+      onde a palavra-chave é inserida em seu documento colocando uma
+      <firstterm>âncora de palavra-chave</firstterm> no local desejado
+      dentro do arquivo.  Esta âncora é apenas uma sequência de texto
+      formatada como
+      <literal>$</literal><replaceable>NomeDaPalavraChave</replaceable><literal>$</literal>.</para>
+
+    <para>Todas as palavras-chave são sensíveis a minúsculas e maiúsculas onde aparecem como
+      âncoras em arquivos: você deve usar a capitalização correta para
+      que a palavra-chave seja expandida.  Você deve considerar que o
+      valor da propriedade <literal>svn:keywords</literal> esteja ciente da
+      capitalização também—certos nomes de palavras-chave serão reconhecidos,
+      independentemente do caso, mas este comportamento está desaprovado.</para>
+
+    <para>O Subversion define a lista de palavras-chave disponíveis para
+      substituição.  Esta lista contém as seguintes cinco palavras-chave, 
+      algumas das quais possuem apelidos que você pode também utilizar:</para>
 
     <variablelist>
       <varlistentry>
         <term><literal>Date</literal></term>
         <listitem>
-          <para>This keyword describes the last time the file was
-            known to have been changed in the repository, and
-            is of the form <literal>$Date:
+          <para>Esta palavra-chave descreve a última vez conhecida em
+            que o arquivo foi modificado no repositório, e
+            está na forma <literal>$Date:
             2006-07-22 21:42:37 -0700 (Sat, 22 Jul 2006)
-            $</literal>.  It may also be specified as
+            $</literal>.  Ela também pode ser especificada como
             <literal>LastChangedDate</literal>.</para>
         </listitem>
       </varlistentry>
       <varlistentry>
         <term><literal>Revision</literal></term>
         <listitem>
-          <para>This keyword describes the last known revision in
-            which this file changed in the repository, and looks
-            something like <literal>$Revision: 144 $</literal>.  
-            It may also be specified as
-            <literal>LastChangedRevision</literal> or
+          <para>Esta palavra-chave descreve a última revisão conhecida em
+            que este arquivo foi modificado no repositório, e é apresentada
+            na forma <literal>$Revision: 144 $</literal>.  
+            Ela também pode ser especificada como
+            <literal>LastChangedRevision</literal> ou
             <literal>Rev</literal>.</para>
         </listitem>
       </varlistentry>
       <varlistentry>
         <term><literal>Author</literal></term>
         <listitem>
-          <para>This keyword describes the last known user to
-            change this file in the repository, and looks
-            something like <literal>$Author: harry $</literal>.  
-            It may also be specified as 
+          <para>Esta palavra-chave descreve o último usuário conhecido que
+            modificou este arquivo no repositório, e é apresentada
+            na forma <literal>$Author: harry $</literal>.  
+            Ela também pode ser especificada como 
             <literal>LastChangedBy</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 palavra-chave descreve a URL completa para a versão
+            mais recente do arquivo no repositório, e é apresentada
+            na forma <literal>$HeadURL:
             http://svn.collab.net/repos/trunk/README $</literal>.
-            It may be abbreviated as
+            Ela também pode 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
+          <para>Esta palavra-chave é uma combinação comprimida das
+            outras palavras-chave.  Sua substituição apresenta-se como
             <literal>$Id: calc.c 148 2006-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, 2006 by the user
+            $</literal>, e é interpretada no sentido de que o arquivo
+            <filename>calc.c</filename> foi modificado pela última vez na revisão
+            148 na noite de 28 de julho de 2006 pelo usuário
             <literal>sally</literal>.</para>
         </listitem>
       </varlistentry>
     </variablelist>
 
-    <para>Several of the previous descriptions use the phrase
-      <quote>last known</quote> or similar wording.  Keep in mind that
-      keyword expansion is a client-side operation, and your client
-      only <quote>knows</quote> about changes which have occurred in
-      the repository when you update your working copy to include
-      those changes.  If you never update your working copy, your
-      keywords will never expand to different values even if those
-      versioned files are being changed regularly in the
-      repository.</para>
+    <para>Muitas das descrições anteriores usam a frase <quote>último
+      valor conhecido</quote> ou algo parecido.  Tenha em mente que
+      a expansão da palavra-chave é uma operação no lado do cliente, e seu cliente
+      somente <quote>conhece</quote> sobre mudanças que tenham ocoridas no
+      repositório quando você atualiza sua cópia de trabalho para incluir
+      essas mudanças.  Se você nunca atualizar sua cópia de trabalho, suas
+      palavras-chave nunca expandirão para valores diferentes, mesmo que esses
+      arquivos versionados estejam sendo modificados regularmente no
+      repositório.</para>
 
     <para>Simply adding keyword anchor text to your file does
       nothing special.  Subversion will never attempt to perform




More information about the svn-pt_br mailing list