Skip to content

Commit 50debd7

Browse files
committed
exif : fix XML by converting para to simpara tags via script
1 parent b6a681d commit 50debd7

File tree

9 files changed

+92
-98
lines changed

9 files changed

+92
-98
lines changed

reference/exif/book.xml

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,18 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 762fd781b63e37a13eb616602f715898dd237955 Maintainer: PhilDaiguille Status: ready -->
3+
<!-- EN-Revision: 6a08181be1706dfebdb3ad6e45620bceb08019ba Maintainer: PhilDaiguille Status: ready -->
44
<!-- Reviewed: no -->
5-
6-
<book xml:id="book.exif" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
5+
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.exif">
76
<?phpdoc extension-membership="bundled" ?>
87
<title>Información Exif</title>
98
<titleabbrev>Exif</titleabbrev>
109

1110
<!-- {{{ preface -->
1211
<preface xml:id="intro.exif">
1312
&reftitle.intro;
14-
<para>
13+
<simpara>
1514
Con la extensión exif, se puede trabajar con los datos meta de las imágenes. Por ejemplo, las funciones exif deben ser utilizadas para leer los datos meta de las imágenes tomadas por cámaras digitales, almacenados en el encabezado. Estos datos están comúnmente presentes en las imágenes <acronym>JPEG</acronym> y <acronym>TIFF</acronym>.
16-
</para>
15+
</simpara>
1716
</preface>
1817
<!-- }}} -->
1918

@@ -22,7 +21,6 @@
2221
&reference.exif.reference;
2322

2423
</book>
25-
2624
<!-- Keep this comment at the end of the file
2725
Local variables:
2826
mode: sgml

reference/exif/configure.xml

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,20 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: seros Status: ready -->
4-
<section xml:id="exif.installation" xmlns="http://docbook.org/ns/docbook">
3+
<!-- EN-Revision: 6a08181be1706dfebdb3ad6e45620bceb08019ba Maintainer: seros Status: ready -->
4+
<section xmlns="http://docbook.org/ns/docbook" xml:id="exif.installation">
55
&reftitle.install;
6-
<para>
6+
<simpara>
77
Para habilitar el soporte para exif configure PHP con
88
<option role="configure">--enable-exif</option>
9-
</para>
10-
<para>
9+
</simpara>
10+
<simpara>
1111
Los usuarios de Windows deben habilitar las DLL <filename>php_mbstring.dll</filename>
1212
y <filename>php_exif.dll</filename> en &php.ini;. La DLL
1313
<filename>php_mbstring.dll</filename> debe cargarse
1414
<emphasis>antes</emphasis> que la DLL <filename>php_exif.dll</filename>, así que
1515
ajuste su &php.ini; como corresponde.
16-
</para>
16+
</simpara>
1717
</section>
18-
19-
2018
<!-- Keep this comment at the end of the file
2119
Local variables:
2220
mode: sgml

reference/exif/constants.xml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: b090c4476884e5dbce1f3cc2adf28c65b04d9de9 Maintainer: PhilDaiguille Status: ready -->
3+
<!-- EN-Revision: 6a08181be1706dfebdb3ad6e45620bceb08019ba Maintainer: PhilDaiguille Status: ready -->
44
<!-- Reviewed: no -->
55
<appendix xmlns="http://docbook.org/ns/docbook" xml:id="exif.constants">
66
&reftitle.constants;
@@ -20,10 +20,10 @@
2020
</listitem>
2121
</varlistentry>
2222
</variablelist>
23-
<para>
23+
<simpara>
2424
La función <function>exif_imagetype</function> lista varias constantes
2525
relacionadas.
26-
</para>
26+
</simpara>
2727
</appendix>
2828
<!-- Keep this comment at the end of the file
2929
Local variables:

reference/exif/functions/exif-imagetype.xml

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: b090c4476884e5dbce1f3cc2adf28c65b04d9de9 Maintainer: PhilDaiguille Status: ready -->
3+
<!-- EN-Revision: 6a08181be1706dfebdb3ad6e45620bceb08019ba Maintainer: PhilDaiguille Status: ready -->
44
<!-- Reviewed: yes -->
55
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.exif-imagetype">
66
<refnamediv>
@@ -13,17 +13,17 @@
1313
<type class="union"><type>int</type><type>false</type></type><methodname>exif_imagetype</methodname>
1414
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
1515
</methodsynopsis>
16-
<para>
16+
<simpara>
1717
<function>exif_imagetype</function> lee los primeros octetos del fichero de imagen
1818
<parameter>filename</parameter>, y verifica su firma.
19-
</para>
20-
<para>
19+
</simpara>
20+
<simpara>
2121
<function>exif_imagetype</function> puede ser utilizada para evitar las llamadas
2222
a las otras funciones <link linkend="ref.exif">exif</link> para los formatos de ficheros que
2323
no son soportados, o en conjunción con
2424
<varname>$_SERVER['HTTP_ACCEPT']</varname> para verificar
2525
si el usuario podrá ver esta imagen en su navegador.
26-
</para>
26+
</simpara>
2727
</refsect1>
2828
<refsect1 role="parameters">
2929
&reftitle.parameters;
@@ -40,11 +40,11 @@
4040
</refsect1>
4141
<refsect1 role="returnvalues">
4242
&reftitle.returnvalues;
43-
<para>
43+
<simpara>
4444
Cuando se encuentra un valor válido, se devuelve la constante apropiada, y de lo contrario, &false;. El valor devuelto es el mismo
4545
que la función <function>getimagesize</function> en el índice 2, pero
4646
esta función es mucho más rápida.
47-
</para>
47+
</simpara>
4848

4949
<para>
5050
Las constantes siguientes están definidas y representan los valores
@@ -143,14 +143,14 @@
143143
</para>
144144

145145
<note>
146-
<para>
146+
<simpara>
147147
La función <function>exif_imagetype</function> emitirá una alerta de
148148
nivel <constant>E_NOTICE</constant> y devolverá &false; si no es
149149
capaz de leer suficientes octetos desde el fichero para determinar
150150
el tipo de imagen.
151151
<!-- If the function finds an incomplete PNG header then it may emit an
152152
<constant>E_WARNING</constant> instead. - Is this worth including? -->
153-
</para>
153+
</simpara>
154154
</note>
155155
</refsect1>
156156

reference/exif/functions/exif-read-data.xml

Lines changed: 29 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: b090c4476884e5dbce1f3cc2adf28c65b04d9de9 Maintainer: PhilDaiguille Status: ready -->
3+
<!-- EN-Revision: 6a08181be1706dfebdb3ad6e45620bceb08019ba Maintainer: PhilDaiguille Status: ready -->
44
<!-- Reviewed: yes -->
55
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.exif-read-data">
66
<refnamediv>
@@ -16,27 +16,27 @@
1616
<methodparam choice="opt"><type>bool</type><parameter>as_arrays</parameter><initializer>&false;</initializer></methodparam>
1717
<methodparam choice="opt"><type>bool</type><parameter>read_thumbnail</parameter><initializer>&false;</initializer></methodparam>
1818
</methodsynopsis>
19-
<para>
19+
<simpara>
2020
<function>exif_read_data</function> lee los encabezados <acronym>EXIF</acronym>
2121
de las imágenes.
2222
Con esta función, se pueden leer los datos meta generados por las cámaras
2323
digitales.
24-
</para>
25-
<para>
24+
</simpara>
25+
<simpara>
2626
Los encabezados <acronym>EXIF</acronym> tienden a estar presentes en las imágenes
2727
JPEG/TIFF generadas por las cámaras digitales, pero desafortunadamente,
2828
cada cámara digital tiene una idea diferente de cómo
2929
sus imágenes deben ser marcadas, por lo que no siempre se puede contar
3030
con un encabezado EXIF específico, aunque esté presente.
31-
</para>
32-
<para>
31+
</simpara>
32+
<simpara>
3333
Los parámetros <literal>Height</literal> y <literal>Width</literal>
3434
se calculan de la misma manera que para la función <function>getimagesize</function>,
3535
por lo que sus valores no formarán parte de ningún encabezado devuelto. De igual manera, el índice
3636
<literal>html</literal> es la representación textual de la altura/ancho
3737
utilizada en una etiqueta de imagen <acronym>HTML</acronym> clásica.
38-
</para>
39-
<para>
38+
</simpara>
39+
<simpara>
4040
Cuando un encabezado EXIF contiene una nota de Copyright, este encabezado
4141
puede contener a su vez dos valores. Como esta solución es inconsistente con los estándares EXIF 2.10, la sección <literal>COMPUTED</literal>
4242
devolverá los dos encabezados, <literal>Copyright.Photographer</literal>
@@ -47,32 +47,32 @@
4747
contendrá una entrada <literal>Copyright</literal>, que será ya sea la cadena original
4848
de copyright, o una lista de valores separados por comas de
4949
fotos y copyright del autor.
50-
</para>
51-
<para>
50+
</simpara>
51+
<simpara>
5252
La etiqueta <literal>UserComment</literal> presenta el mismo problema que la etiqueta Copyright.
5353
Puede almacenar dos valores: primero, el juego de caracteres utilizado, luego
5454
el valor en sí. Si es así, la sección <literal>IFD</literal> contendrá solo
5555
el juego de caracteres, o un array de bytes. La sección <literal>COMPUTED</literal>
5656
almacenará las dos entradas <literal>UserCommentEncoding</literal> y
5757
<literal>UserComment</literal>. El índice <literal>UserComment</literal>
5858
está disponible en ambos casos, y es preferible usarlo, en lugar del valor de la sección <literal>IFD0</literal>.
59-
</para>
60-
<para>
59+
</simpara>
60+
<simpara>
6161
<function>exif_read_data</function> valida los datos de las etiquetas EXIF de acuerdo
6262
con la especificación EXIF (<link xlink:href="&url.exifspec;">&url.exifspec;</link>, página 20).
63-
</para>
63+
</simpara>
6464
</refsect1>
6565
<refsect1 role="parameters">
6666
&reftitle.parameters;
6767
<variablelist>
6868
<varlistentry>
6969
<term><parameter>file</parameter></term>
7070
<listitem>
71-
<para>
71+
<simpara>
7272
La ubicación del archivo de imagen. Puede ser ya sea una ruta de acceso
7373
al archivo (los wrappers de flujo también son soportados como
7474
de costumbre), o un flujo <type>resource</type>.
75-
</para>
75+
</simpara>
7676
</listitem>
7777
</varlistentry>
7878
<varlistentry>
@@ -146,40 +146,40 @@
146146
<varlistentry>
147147
<term><parameter>as_arrays</parameter></term>
148148
<listitem>
149-
<para>
149+
<simpara>
150150
Especifica si cada sección debe convertirse en un array o no.
151151
Las <parameter>required_sections</parameter> <literal>COMPUTED</literal>,
152152
<literal>THUMBNAIL</literal> y <literal>COMMENT</literal> siempre serán
153153
convertidas en arrays, ya que contienen nombres que podrían entrar en conflicto.
154-
</para>
154+
</simpara>
155155
</listitem>
156156
</varlistentry>
157157
<varlistentry>
158158
<term><parameter>read_thumbnail</parameter></term>
159159
<listitem>
160-
<para>
160+
<simpara>
161161
Cuando se define como &true;, la miniatura misma es leída. De lo contrario,
162162
solo se leen los datos contenidos en el archivo.
163-
</para>
163+
</simpara>
164164
</listitem>
165165
</varlistentry>
166166
</variablelist>
167167
</refsect1>
168168
<refsect1 role="returnvalues">
169169
&reftitle.returnvalues;
170-
<para>
170+
<simpara>
171171
Devuelve un array asociativo donde los índices son los nombres de los encabezados y los valores
172172
son los valores asociados a estos encabezados. Si no se puede devolver ningún dato,
173173
<function>exif_read_data</function> devolverá &false;.
174-
</para>
174+
</simpara>
175175
</refsect1>
176176

177177
<refsect1 role="errors">
178178
&reftitle.errors;
179-
<para>
179+
<simpara>
180180
Pueden generarse errores de nivel <constant>E_WARNING</constant> y/o <constant>E_NOTICE</constant>
181181
para etiquetas no soportadas u otras condiciones de error potencial, pero la función intenta leer toda la información comprensible.
182-
</para>
182+
</simpara>
183183
</refsect1>
184184

185185
<refsect1 role="changelog">
@@ -245,9 +245,9 @@ foreach ($exif as $key => $section) {
245245
?>
246246
]]>
247247
</programlisting>
248-
<para>
248+
<simpara>
249249
La primera llamada falla porque la imagen no tiene encabezado de información.
250-
</para>
250+
</simpara>
251251
&example.outputs.similar;
252252
<screen role="php">
253253
<![CDATA[
@@ -334,7 +334,7 @@ EXIF Headers:
334334
<refsect1 role="notes">
335335
&reftitle.notes;
336336
<note>
337-
<para>
337+
<simpara>
338338
Si <link linkend="ref.mbstring">mbstring</link> está activado, EXIF intentará
339339
tratar el Unicode y elegir un juego de caracteres como se especifica por
340340
<link linkend="ini.exif.decode-unicode-motorola">exif.decode_unicode_motorola</link> y
@@ -343,15 +343,15 @@ EXIF Headers:
343343
responsabilidad del usuario especificar correctamente el codificado a usar
344344
para el decodificado definiendo una de las dos directivas INI antes
345345
de llamar a <function>exif_read_data</function>.
346-
</para>
346+
</simpara>
347347
</note>
348348
<note>
349-
<para>
349+
<simpara>
350350
Si el parámetro <parameter>file</parameter> se usa para pasar un
351351
flujo a la función, entonces el flujo debe ser reposicionable. Tenga en cuenta que la
352352
posición del puntero de un archivo no se modifica después del retorno de
353353
esta función.
354-
</para>
354+
</simpara>
355355
</note>
356356
</refsect1>
357357

reference/exif/functions/exif-tagname.xml

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: b090c4476884e5dbce1f3cc2adf28c65b04d9de9 Maintainer: agarzon Status: ready -->
3+
<!-- EN-Revision: 6a08181be1706dfebdb3ad6e45620bceb08019ba Maintainer: agarzon Status: ready -->
44
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.exif-tagname">
55
<refnamediv>
66
<refname>exif_tagname</refname>
@@ -19,19 +19,19 @@
1919
<varlistentry>
2020
<term><parameter>index</parameter></term>
2121
<listitem>
22-
<para>
22+
<simpara>
2323
La etiqueta ID correspondiente a la etiqueta Name que examinará.
24-
</para>
24+
</simpara>
2525
</listitem>
2626
</varlistentry>
2727
</variablelist>
2828
</refsect1>
2929
<refsect1 role="returnvalues">
3030
&reftitle.returnvalues;
31-
<para>
31+
<simpara>
3232
Devuelve el nombre de la cabecera, o &false; si <parameter>index</parameter> no está
3333
definido con un identificador de etiqueta EXIF.
34-
</para>
34+
</simpara>
3535
</refsect1>
3636
<refsect1 role="examples">
3737
&reftitle.examples;

0 commit comments

Comments
 (0)