1
0
mirror of https://github.com/php/doc-de.git synced 2026-03-23 23:02:13 +01:00

exif : fix XML by converting para to simpara tags via script

This commit is contained in:
Gina Peter Banyard
2026-01-18 22:12:12 +00:00
parent a89948e0d6
commit 342090ef8b
9 changed files with 97 additions and 104 deletions

View File

@@ -1,9 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 762fd781b63e37a13eb616602f715898dd237955 Maintainer: hholzgra Status: ready -->
<!-- EN-Revision: 6a08181be1706dfebdb3ad6e45620bceb08019ba Maintainer: hholzgra Status: ready -->
<!-- Credits: tihox -->
<book xml:id="book.exif" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.exif">
<?phpdoc extension-membership="bundled" ?>
<title>Exchangable Image Information (EXIF)</title>
<titleabbrev>Exif</titleabbrev>
@@ -11,14 +10,14 @@
<!-- {{{ preface -->
<preface xml:id="intro.exif">
&reftitle.intro;
<para>
<simpara>
Die Exif-Erweiterung ermöglicht es mit Metadaten von Bildern zu arbeiten,
&zb; kann man die Exif-Funktionen nutzen, um die Metadaten von Bildern
auszulesen, die mit Digitalkameras gemacht wurden, indem man die Header
ausliest.
Diese finden sich üblicherweise in <acronym>JPEG</acronym> und
<acronym>TIFF</acronym> Bildern.
</para>
</simpara>
</preface>
<!-- }}} -->
@@ -27,7 +26,6 @@
&reference.exif.reference;
</book>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

View File

@@ -1,22 +1,20 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nobody Status: ready -->
<section xml:id="exif.installation" xmlns="http://docbook.org/ns/docbook">
<!-- EN-Revision: 6a08181be1706dfebdb3ad6e45620bceb08019ba Maintainer: nobody Status: ready -->
<section xmlns="http://docbook.org/ns/docbook" xml:id="exif.installation">
&reftitle.install;
<para>
Um PHP mit Exif-Unterstützung nutzen zu können, muss man PHP mit der Option
<simpara>
Um PHP mit Exif-Unterstützung nutzen zu können, muss man PHP mit der Option
<option role="configure">--enable-exif</option> kompilieren.
</para>
<para>
Windows-Nutzer müssen die DLLs <filename>php_mbstring.dll</filename> und
<filename>php_exif.dll</filename> in der &php.ini; aktivieren. Die
<filename>php_mbstring.dll</filename> muss <emphasis>vor</emphasis> der
<filename>php_exif.dll</filename> geladen werden. Die &php.ini; muss entsprechend
</simpara>
<simpara>
Windows-Nutzer müssen die DLLs <filename>php_mbstring.dll</filename> und
<filename>php_exif.dll</filename> in der &php.ini; aktivieren. Die
<filename>php_mbstring.dll</filename> muss <emphasis>vor</emphasis> der
<filename>php_exif.dll</filename> geladen werden. Die &php.ini; muss entsprechend
angepasst werden.
</para>
</simpara>
</section>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b090c4476884e5dbce1f3cc2adf28c65b04d9de9 Maintainer: tihox Status: ready -->
<!-- EN-Revision: 6a08181be1706dfebdb3ad6e45620bceb08019ba Maintainer: tihox Status: ready -->
<appendix xmlns="http://docbook.org/ns/docbook" xml:id="exif.constants">
&reftitle.constants;
&extension.constants;
@@ -19,9 +19,9 @@
</listitem>
</varlistentry>
</variablelist>
<para>
<simpara>
<function>exif_imagetype</function> listet einige eingebaute Konstanten auf.
</para>
</simpara>
</appendix>
<!-- Keep this comment at the end of the file
Local variables:

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b090c4476884e5dbce1f3cc2adf28c65b04d9de9 Maintainer: nikic Status: ready -->
<!-- EN-Revision: 6a08181be1706dfebdb3ad6e45620bceb08019ba Maintainer: nikic Status: ready -->
<!-- Reviewed: yes -->
<!-- Rev-Revision: bfadfd1c4c3ba654b1d3324d9425dd1c07fea906 Reviewer: samesch -->
<!-- splitted from ./en/functions/image.xml, last change in rev 1.81 -->
@@ -16,18 +16,18 @@
<type class="union"><type>int</type><type>false</type></type><methodname>exif_imagetype</methodname>
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>exif_imagetype</function> liest die ersten Bytes eines Bildes aus
und überprüft dessen Signatur.
</para>
<para>
</simpara>
<simpara>
<function>exif_imagetype</function> kann benutzt werden, um Aufrufe
anderer <link linkend="ref.exif">exif</link>-Funktionen bei nicht
unterstützten Dateitypen zu vermeiden. Es kann in Verbindung mit
<varname>$_SERVER['HTTP_ACCEPT']</varname> auch dazu verwendet werden, zu
überprüfen, ob der Betrachter ein bestimmtes Bild in seinem Browser
angezeigt bekommt oder nicht.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -46,12 +46,12 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Bei einer korrekten Signatur wird die entsprechende Konstante als Wert
zurückgegeben, andernfalls &false;. Der Rückgabewert ist derselbe, der
auch von <function>getimagesize</function> als Index 2 zurückgegeben wird,
aber <function>exif_imagetype</function> ist deutlich schneller.
</para>
</simpara>
<para>
Die folgenden Konstanten sind definiert und repräsentieren die möglichen
Rückgabewerte von <function>exif_imagetype</function>:
@@ -148,14 +148,14 @@
</table>
</para>
<note>
<para>
<simpara>
<function>exif_imagetype</function> löst einen Fehler vom Typ
<constant>E_NOTICE</constant> aus und gibt &false; zurück, wenn die
Funktion nicht genügend Bytes aus der Datei lesen konnte, um den Bildtyp
zu bestimmen.
<!-- If the function finds an incomplete PNG header then it may emit an
<constant>E_WARNING</constant> instead. - Is this worth including? -->
</para>
</simpara>
</note>
</refsect1>

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b090c4476884e5dbce1f3cc2adf28c65b04d9de9 Maintainer: nobody Status: ready -->
<!-- EN-Revision: 6a08181be1706dfebdb3ad6e45620bceb08019ba Maintainer: nobody Status: ready -->
<!-- Reviewed: yes Maintainer: samesch -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.exif-read-data">
<refnamediv>
@@ -17,27 +17,27 @@
<methodparam choice="opt"><type>bool</type><parameter>as_arrays</parameter><initializer>&false;</initializer></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>read_thumbnail</parameter><initializer>&false;</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>exif_read_data</function> liest die
<acronym>EXIF</acronym>-Header aus einer Bilddatei aus. Auf diese Weise
können die Metadaten ausgelesen werden, die mit Digitalkameras erzeugt
wurden.
</para>
<para>
</simpara>
<simpara>
<acronym>EXIF</acronym>-Header kommen normalerweise bei JPEG/TIFF-Bildern
vor, die von Digitalkameras gemacht wurden. Leider hat jeder
Kamerahersteller eine andere Vorstellung davon, wie man die Bilder
beschreibt, sodass man sich nicht darauf verlassen kann, das ein bestimmter
Exif-Header vorhanden ist.
</para>
<para>
</simpara>
<simpara>
<literal>Height</literal> und <literal>Width</literal> werden genauso wie
<function>getimagesize</function> berechnet. Diese Werte dürfen also nicht
Teil von irgendwelchen Headern sein, die zurückgegeben werden. Ferner ist
<literal>html</literal> ein Höhen/Breiten-Textstring für den Gebrauch in
normalem <acronym>HTML</acronym>.
</para>
<para>
</simpara>
<simpara>
Wenn ein Exif-Header einen Copyrightvermerk beinhaltet, kann dieser selbst
aus zwei Werten bestehen. Da die Lösung im Exif-2.10 -Standard nicht
konsistent ist, liefert der <literal>COMPUTED</literal>-Bereich die beiden
@@ -50,8 +50,8 @@
<literal>Copyright</literal>-Eintrag. Dieser entspricht entweder dem
originalen Copyright-String oder er besteht aus einer kommaseparierten
Liste von Foto- und Herausgeber-Copyright.
</para>
<para>
</simpara>
<simpara>
Der Tag <literal>UserComment</literal> hat das gleiche Problem, wie das
Copyright-Tag. Er kann zwei Werte speichern. Als erstes die verwendete
Kodierung und als zweites den Wert selbst. Wenn dem so ist, enthält der
@@ -61,12 +61,12 @@
Der Eintrag <literal>UserComment</literal> ist in beiden Fällen verfügbar.
Er sollte also dem Eintrag im <literal>IFD0</literal>-Bereich vorgezogen
werden.
</para>
<para>
</simpara>
<simpara>
<function>exif_read_data</function> validiert auch EXIF-Datentags
entsprechend der EXIF-Spezifikationen
(<link xlink:href="&url.exifspec;">&url.exifspec;</link>, Seite 20).
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -75,11 +75,11 @@
<varlistentry>
<term><parameter>file</parameter></term>
<listitem>
<para>
<simpara>
Der Ort der Bilddatei. Dies kann entweder der Pfad der Datei
(Stream-Wrapper werden wie üblich ebenso unterstützt) oder eine
Stream-<type>&resource;</type> sein.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -152,22 +152,22 @@
<varlistentry>
<term><parameter>as_arrays</parameter></term>
<listitem>
<para>
<simpara>
Definiert ob jeder Bereich ein Array wird oder nicht. Die
<parameter>required_sections</parameter> <literal>COMPUTED</literal>,
<literal>THUMBNAIL</literal> und <literal>COMMENT</literal> werden
immer zu Arrays, da die Namen der Werte mit denen anderer Bereiche
kollidieren können.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>read_thumbnail</parameter></term>
<listitem>
<para>
<simpara>
Bei &true; wird das Miniaturbild ausgelesen, ansonsten nur die Daten
der Tags.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -175,22 +175,22 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Gibt ein assoziatives <type>&array;</type> zurück, bei dem der Arrayindex
den Headernamen entspricht und der Arraywert die Werte enthält, die mit
diesen Headern in Verbindung stehen. Wenn keine Daten zurückgegeben werden
können, gibt <function>exif_read_data</function> &false; zurück.
</para>
</simpara>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<para>
<simpara>
Fehler der Stufe <constant>E_WARNING</constant> und/oder
<constant>E_NOTICE</constant> können bei nicht unterstützten Tags oder
anderen potentiellen Fehlerbedingungen ausgelöst werden, aber die Funktion
versucht trotzdem, alle verständlichen Informationen zu lesen.
</para>
</simpara>
</refsect1>
<refsect1 role="changelog">
@@ -265,10 +265,10 @@ foreach ($exif as $key => $section) {
?>
]]>
</programlisting>
<para>
<simpara>
Der erste Aufruf schlägt fehl, da das Bild keine Headerinformationen
enthält.
</para>
</simpara>
&example.outputs.similar;
<screen role="php">
<![CDATA[
@@ -355,7 +355,7 @@ EXIF Header:
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
Ist <link linkend="ref.mbstring">mbstring</link> aktiviert, wird exif
versuchen den Unicode zu verarbeiten, und einen Zeichensatz gemäß
<link linkend="ini.exif.decode-unicode-motorola">exif.decode_unicode_motorola</link>
@@ -364,15 +364,15 @@ EXIF Header:
ermitteln, so dass es die Aufgabe des Benutzers ist, die gewünschte
Kodierung durch Setzen einer der beiden ini-Direktiven anzugeben, bevor
<function>exif_read_data</function> aufgerufen wird.
</para>
</simpara>
</note>
<note>
<para>
<simpara>
Wird der Parameter <parameter>file</parameter> verwendet, um einen Stream
an diese Funktion zu übergeben, dann muss der Stream suchbar sein. Es ist
zu beachten, dass die Position des Dateizeigers nach dem Aufruf dieser
Funktion unverändert ist.
</para>
</simpara>
</note>
</refsect1>

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b090c4476884e5dbce1f3cc2adf28c65b04d9de9 Maintainer: nobody Status: ready -->
<!-- EN-Revision: 6a08181be1706dfebdb3ad6e45620bceb08019ba Maintainer: nobody Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.exif-tagname">
<refnamediv>
<refname>exif_tagname</refname>
@@ -21,9 +21,9 @@
<varlistentry>
<term><parameter>index</parameter></term>
<listitem>
<para>
<simpara>
Die Tag-ID für welche ein Tag-Name nachgeschlagen wird.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -31,10 +31,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Gibt den Header-Namen oder &false; zurück, wenn der <parameter>index</parameter>
keine definierte EXIF-Tag-ID ist.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b090c4476884e5dbce1f3cc2adf28c65b04d9de9 Maintainer: nobody Status: ready -->
<!-- EN-Revision: 6a08181be1706dfebdb3ad6e45620bceb08019ba Maintainer: nobody Status: ready -->
<!-- Reviewed: yes Maintainer: samesch -->
<!-- splitted from ./en/functions/image.xml, last change in rev 1.78 -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.exif-thumbnail">
@@ -18,21 +18,21 @@
<methodparam choice="opt"><type>int</type><parameter role="reference">height</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter role="reference">image_type</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>exif_thumbnail</function> liest das eingebettete Miniaturbild
eines Bildes aus.
</para>
<para>
</simpara>
<simpara>
Wenn man das Miniaturbild mit dieser Funktion ausliefern möchte, sollte man
den Mimetype mit Hilfe der Funktion <function>header</function>
mitschicken.
</para>
<para>
</simpara>
<simpara>
Es kann passieren, dass <function>exif_thumbnail</function> das Bild nicht
erzeugen, aber dessen Größe bestimmen kann. In diesem Fall, ist der
Rückgabewert &false;, obwohl <parameter>width</parameter> und
<parameter>height</parameter> gesetzt sind.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -41,35 +41,35 @@
<varlistentry>
<term><parameter>file</parameter></term>
<listitem>
<para>
<simpara>
Der Ort der Bilddatei. Dies kann entweder ein Dateipfad oder eine
Stream-<type>&resource;</type> sein.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>width</parameter></term>
<listitem>
<para>
<simpara>
Die Breite des gelieferten Miniaturbildes als Rückgabewert.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>height</parameter></term>
<listitem>
<para>
<simpara>
Die Höhe des gelieferten Miniaturbildes als Rückgabewert.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>image_type</parameter></term>
<listitem>
<para>
<simpara>
Der Bildtyp des gelieferten Miniaturbildes als Rückgabewert. Dieser ist
entweder <acronym>TIFF</acronym> oder <acronym>JPEG</acronym>.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -77,10 +77,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Gibt das eingebettete Miniaturbild zurück oder &false;, wenn das Bild kein
Miniaturbild enthält.
</para>
</simpara>
</refsect1>
<refsect1 role="changelog">
@@ -131,12 +131,12 @@ if ($image!==false) {
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
Wird <parameter>file</parameter> verwendet, um einen Stream an diese
Funktion zu übergeben, dann muss der Stream durchsuchbar sein. Es ist zu
beachten, dass sich die Position des Dateizeigers nicht ändert, nachdem
diese Funktion aufgerufen wurde.
</para>
</simpara>
</note>
</refsect1>

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b090c4476884e5dbce1f3cc2adf28c65b04d9de9 Maintainer: wiesemann Status: ready -->
<!-- EN-Revision: 6a08181be1706dfebdb3ad6e45620bceb08019ba Maintainer: wiesemann Status: ready -->
<section xmlns="http://docbook.org/ns/docbook" xml:id="exif.configuration">
&reftitle.runtime;
&extension.runtime;
@@ -73,14 +73,14 @@
<type>string</type>
</term>
<listitem>
<para>
<simpara>
<literal>exif.encode_unicode</literal> definiert den Zeichensatz für
UNICODE-Nutzerkommentare. Der Standardwert ist ISO-8859-15, welcher für
die meisten nicht-asiatischen Länder funktionieren sollte. Der Wert darf
leer sein oder muss eine Kodierung enthalten, die von mbstring
unterstützt wird. Ist der Wert leer, wird die aktuelle, interne
Kodierung von mbstring genutzt.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.exif.decode-unicode-motorola">
@@ -89,13 +89,13 @@
<type>string</type>
</term>
<listitem>
<para>
<simpara>
<literal>exif.decode_unicode_motorola</literal> definiert den internen
Zeichensatz des Bildes für Unicode-kodierte Nutzerkommentare, sollte das
Bild in der Motorola-Bytefolge (big-endian) sein. Dieser Wert darf nicht
leer sein, sondern kann mit einer Liste von Kodierungen gefüllt werden,
die von mbstring unterstützt werden. Der Standard ist UCS-2BE.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.exif.decode-unicode-intel">
@@ -104,13 +104,13 @@
<type>string</type>
</term>
<listitem>
<para>
<simpara>
<literal>exif.decode_unicode_intel</literal> definiert den internen
Zeichensatz des Bildes für Unicode-kodierte Nutzerkommentare, sollte das
Bild in der Intel-Bytefolge (little-endian) sein. Dieser Wert darf nicht
leer sein, sondern kann mit einer Liste von Kodierungen gefüllt werden,
die von mbstring unterstützt werden. Der Standard ist UCS-2LE.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.exif.encode-jis">
@@ -119,12 +119,12 @@
<type>string</type>
</term>
<listitem>
<para>
<simpara>
<literal>exif.encode_jis</literal> definiert den Zeichensatz, mit dem
JIS-Nutzerkommentare behandelt werden. Der Standard ist leer und zwingt
die Funktionen dazu, die aktuelle interne Kodierung von mbstring zu
nutzen.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.exif.decode-jis-motorola">
@@ -133,13 +133,13 @@
<type>string</type>
</term>
<listitem>
<para>
<simpara>
<literal>exif.decode_jis_motorola</literal> definiert den internen
Zeichensatz des Bildes für JIS-kodierte Nutzerkommentare, sollte das
Bild in der Motorola-Bytefolge (big-endian) sein. Dieser Wert darf nicht
leer sein, sondern kann mit einer Liste von Kodierungen gefüllt werden,
die von mbstring unterstützt werden. Der Standard ist JIS.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.exif.decode-jis-intel">
@@ -148,13 +148,13 @@
<type>string</type>
</term>
<listitem>
<para>
<simpara>
<literal>exif.decode_jis_intel</literal> definiert den internen
Zeichensatz des Bildes für JIS-kodierte Nutzerkommentare, sollte das
Bild in der Intel-Bytefolge (little-endian) sein. Dieser Wert darf nicht
leer sein, sondern kann mit einer Liste von Kodierungen gefüllt werden,
die von mbstring unterstützt werden. Der Standard ist JIS.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>

View File

@@ -1,20 +1,19 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: c0af8c90a6b83faaadaebdfd22970bcb8b9c4057 Maintainer: wiesemann Status: ready -->
<chapter xml:id="exif.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 6a08181be1706dfebdb3ad6e45620bceb08019ba Maintainer: wiesemann Status: ready -->
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="exif.setup">
&reftitle.setup;
<!-- {{{ Requirements -->
<section xml:id="exif.requirements">
&reftitle.required;
<para>
<simpara>
PHP muss mit <literal>--enable-exif</literal> kompiliert werden.
Um Multibyte-Unterstützung in EXIF-Tags zu aktivieren, muss die Erweiterung
<link linkend="ref.mbstring">mbstring</link> durch Kompilieren von PHP mit
<literal>--enable-mbstring</literal> aktiviert sein.
PHP braucht keine weiteren Bibliotheken für das Exif-Modul.
</para>
</simpara>
</section>
<!-- }}} -->
@@ -27,7 +26,6 @@
<!-- }}} -->
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -48,4 +46,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->