[svnbook] r3752 committed - * trunk/src/de/book/ch03-advanced-topics.xml...
svnbook at googlecode.com
svnbook at googlecode.com
Thu Jul 1 14:55:44 CDT 2010
Revision: 3752
Author: jmfelderhoff at gmx.eu
Date: Thu Jul 1 12:54:55 2010
Log: * trunk/src/de/book/ch03-advanced-topics.xml
- Fixes ticket #131 (cf. http://www.svnbook.de/report/6).
http://code.google.com/p/svnbook/source/detail?r=3752
Modified:
/trunk/src/de/book/ch03-advanced-topics.xml
=======================================
--- /trunk/src/de/book/ch03-advanced-topics.xml Mon Jun 21 11:41:05 2010
+++ /trunk/src/de/book/ch03-advanced-topics.xml Thu Jul 1 12:54:55 2010
@@ -668,15 +668,27 @@
<!-- ===============================================================
-->
<sect2 id="svn.advanced.props.why">
+<!--
<title>Why Properties?</title>
-
+-->
+ <title>Warum Propertys?</title>
+
+<!--
<para>Just as Subversion uses properties to store extra
information about the files, directories, and revisions that
it contains, you might also find properties to be of similar
use. You might find it useful to have a place
close to your versioned data to hang custom metadata about
that data.</para>
-
+-->
+ <para>Ebenso wie Subversion Propertys verwendet, um zusätzliche
+ Informationen über die enthaltenen Dateien, Verzeichnisse und
+ Revisionen zu speichern, könnten Propertys auch für Sie
+ ähnlich von Nutzen sein. Sie werden es vielleicht als nützlich
+ ansehen, wenn Sie in der Nähe Ihrer versionierten Daten
+ spezielle Metadaten dazu unterbringen können.</para>
+
+<!--
<para>Say you wish to design a web site that houses many digital
photos and displays them with captions and a datestamp. Now,
your set of photos is constantly changing, so you'd like to
@@ -684,7 +696,15 @@
can be quite large, so as is common with sites of this nature,
you want to provide smaller thumbnail images to your site
visitors.</para>
-
+-->
+ <para>Nehmen wir mal an, Sie möchten eine Webpräsenz entwerfen,
+ die viele digitale Fotos mit Bildunterschrift und Zeitstempel
+ anzeigen soll. Da sich die Menge Ihrer Fotos ständig ändert,
+ möchten Sie soviel wie möglich automatisieren. Die Fotos
+ können ziemlich groß werden, so dass Sie den Besuchern Ihrer
+ Seite Miniaturvorschaubilder anbieten möchten.</para>
+
+<!--
<para>Now, you can get this functionality using traditional
files. That is, you can have your
<filename>image123.jpg</filename> and an
@@ -696,7 +716,21 @@
separated from the original image file. But the problem here
is that your collection of files multiplies with each new
photo added to the site.</para>
-
+-->
+ <para>Natürlich können Sie diese Funktionalität auch mit
+ herkömmlichen Dateien hinbekommen. Das bedeutet, Sie haben
+ <filename>image123.jpg</filename> und
+ <filename>image123-thumbnail.jpg</filename> gemeinsam in einem
+ Verzeichnis. Oder Sie speichern die Vorschaubildchen in einem
+ anderen Verzeichnis, etwa
+ <filename>thumbnails/image123.jpg</filename>, falls Sie die
+ gleichen Dateinamen beibehalten möchten. Sie können auch die
+ Bildunterschriften und Zeitstempel auf ähnliche Weise
+ speichern, ebenso vom Originalbild getrennt. Das Problem
+ hierbei ist jedoch, dass sich Ihre Ansammlung an Dateien mit
+ jedem neu hinzugefügten Bild vervielfältigt.</para>
+
+<!--
<para>Now consider the same web site deployed in a way that
makes use of Subversion's file properties. Imagine having a
single image file, <filename>image123.jpg</filename>, with
@@ -711,8 +745,26 @@
linkend="svn.developer.usingapi" />) to dig out the extra
information that your site needs to display without having to
read an index file or play path manipulation games.</para>
+-->
+ <para>Betrachten Sie nun dieselbe Webpräsenz, eingerichtet unter
+ Verwendung der Datei-Propertys von Subversion. Stellen Sie
+ sich vor, sie hätten eine einzelne Bilddatei
+ <filename>image123.jpg</filename> mit Propertys namens
+ <literal>Unterschrift</literal>,
+ <literal>Zeitstempel</literal> und sogar
+ <literal>Vorschaubild</literal>. Jetzt sieht Ihr Verzeichnis
+ viel überschaubarer aus – tatsächlich sieht es für den
+ flüchtigen Betrachter aus, als befänden sich dort nur
+ Bilddateien. Ihre Automatisierungs-Scripte wissen es jedoch
+ besser. Sie wissen, dass sie <command>svn</command> verwenden
+ können (oder noch besser, die Subversion-Sprachschnittstellen
+ – siehe <xref linkend="svn.developer.usingapi" />), um
+ die von Ihrer Webpräsenz zusätzlich benötigten Informationen
+ herauszuholen, ohne eine Indexdatei lesen oder
+ Pfad-Umbennennungs-Spielereien machen zu müssen.</para>
<note>
+<!--
<para>While Subversion places few restrictions on the names
and values you use for properties, it has not been designed
to optimally carry large property values or large sets of
@@ -721,8 +773,20 @@
with a single item in memory at the same time, which can
cause detrimental performance or failed operations when
extremely large property sets are used.</para>
+-->
+ <para>Obwohl Subversion kaum Einschränkungen für die von Ihnen
+ verwendeten Namen und Werte für Propertys macht, ist es
+ nicht entworfen worden, um optimal mit großen
+ Property-Werten oder umgfangreichen Property-Mengen für eine
+ bestimmte Datei oder ein Verzeichnis umgehen zu können.
+ Gewöhnlich behält Subversion gleichzeitig alle
+ Property-Namen und -Werte im Speicher, die zu einem
+ einzelnen Objekt gehören, was bei umfangreichen
+ Property-Mengen zu erheblichen Leistungseinbußen oder
+ fehlgeschlagenen Operationen führen kann.</para>
</note>
+<!--
<para>Custom revision properties are also frequently used. One
common such use is a property whose value contains an issue
tracker ID with which the revision is associated, perhaps
@@ -733,18 +797,45 @@
if there's, say, a <literal>test-results</literal> property on
that revision with the value <literal>all passing</literal>,
that's meaningful information to have.</para>
+-->
+ <para>Spezielle Revisions-Propertys sind auch sehr verbreitet.
+ Eine übliche Verwendung ist es, ein Property zu benutzen,
+ dessen Wert die Kennzeichnung eines Fehlers in einem
+ Fehlerverwaltungssystems ist, mit dem die Revision in
+ Beziehung gebracht wird, etwa weil eine mit dieser Revision
+ vorgenommene Änderung den entsprechenden Fehler behebt. Andere
+ Anwendungsfälle beinhgalten die Vergabe anwenderfreundlicher
+ Namen für die Revision – es könnte schwierig sein, sich
+ zu erinnern, dass Revision 1935 vollständig getestet war. Wenn
+ es jedoch ein Property <literal>Testergebnis</literal> mit dem
+ Wert <literal>alles bestanden</literal> für diese Revision
+ gibt, ist das eine durchaus nützliche Information.</para>
<sidebar>
+<!--
<title>Searchability (or, Why <emphasis>Not</emphasis>
Properties)</title>
-
+-->
+ <title>Suchbarkeit (oder, warum <emphasis>nicht</emphasis> bei
+ Propertys)</title>
+
+<!--
<para>For all their utility, Subversion properties—or,
more accurately, the available interfaces to them—have
a major shortcoming: while it is a simple matter to
<emphasis>set</emphasis> a custom property,
<emphasis>finding</emphasis> that property later is a whole
different ball of wax.</para>
-
+-->
+ <para>Bei allem Nutzen haben Subversion-Propertys – oder,
+ um genauer zu sein, die für sie verfügbaren Schnittstellen
+ – eine gravierende Schwäche: während es eine einfache
+ Sache ist, ein spezielles Property
+ <emphasis>anzulegen</emphasis>, ist das spätere
+ <emphasis>Auffinden</emphasis> dieses Propertys eine ganz
+ andere Geschichte.</para>
+
+<!--
<para>Trying to locate a custom revision property generally
involves performing a linear walk across all the revisions
of the repository, asking of each revision, "Do you have the
@@ -757,7 +848,23 @@
likelihood of success, especially if the scope of your
search would require a working copy from the root of your
repository.</para>
-
+-->
+ <para>Der Versuch, ein spezielles Revisions-Property
+ aufzufinden, bedeutet im Allgemeinen ein lineares
+ Durchwandern aller Revisionen im Projektarchiv, wobei jede
+ Revision gefragt wird <quote>Besitzt Du das Property, nach
+ dem ich suche?</quote> Auch die Suche nach einem
+ speziellen versionierten Property ist mühsam und erfordert
+ oft ein rekursives <command>svn propget</command> über eine
+ vollständige Arbeitskopie. Es kann sein, dass es bei Ihnen
+ nicht ganz so schlimm ist wie eine lineare Durchwanderung
+ aller Revisionen. Jedoch bleiben viele Wünsche in Bezug auf
+ Leistung und Erfolgswahrscheinlichkeit offen; besonders
+ dann, wenn der Suchbereich Ihrer Abfrage eine Arbeitskopie
+ vom Wurzelverzeichnis Ihres Projektarchivs erfordern
+ würde.</para>
+
+<!--
<para>For this reason, you might choose—especially in
the revision property use case—to simply add your
metadata to the revision's log message using some
@@ -765,6 +872,15 @@
formatting that is designed to be quickly parsed from the
output of <command>svn log</command>. It is quite common to
see the following in Subversion log messages:</para>
+-->
+ <para>Aus diesem Grund sollten Sie – besonders im
+ Anwendungsfall mit dem Revisions-Property – einfach
+ Ihre Metadaten der Protokollnachricht hinzufügen, wobei ein
+ vorgegebenes (und vielleicht programmtechnisch erzwungenes)
+ Format verwendet wird, das es erlaubt, die Metadaten schnell
+ aus der Ausgabe von <command>svn log</command>
+ herauszulesen. Das Folgende zeigt eine weit verbreitete Form
+ von Protokollnachrichten in Subversion:</para>
<programlisting>
Issue(s): IZ2376, IZ1919
@@ -774,10 +890,17 @@
…
</programlisting>
+<!--
<para>But here again lies some misfortune. Subversion doesn't
yet provide a log message templating mechanism, which would
go a long way toward helping users be consistent with the
formatting of their log-embedded revision metadata.</para>
+-->
+ <para>Allerdings haben wir hier auch wieder Pech. Subversion
+ verfügt noch nicht über einen Vorlagenmechanismus für
+ Protokollnachrichten, der Benutzern sehr behilflich beim
+ konsistenten Formatieren Ihrer in der Protokollnachricht
+ eingebetteten Revisions-Metadaten sein würde.</para>
</sidebar>
More information about the svnbook-dev
mailing list