Skip to content

Commit 8ed3739

Browse files
GirgiasGirgias
committed
exif : fix XML by converting para to simpara tags via script
1 parent fa233e3 commit 8ed3739

9 files changed

Lines changed: 94 additions & 100 deletions

File tree

‎reference/exif/book.xml‎

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,21 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 762fd781b63e37a13eb616602f715898dd237955 Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe,leonardolara -->
3-
4-
<book xml:id="book.exif" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
2+
<!-- EN-Revision: 6a08181be1706dfebdb3ad6e45620bceb08019ba Maintainer: leonardolara Status: ready -->
3+
<!-- CREDITS: felipe,leonardolara -->
4+
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.exif">
55
<?phpdoc extension-membership="bundled" ?>
66
<title>Informações de imagem</title>
77
<titleabbrev>Exif</titleabbrev>
88

99
<!-- {{{ preface -->
1010
<preface xml:id="intro.exif">
1111
&reftitle.intro;
12-
<para>
12+
<simpara>
1313
Com a extensão exif pode-se trabalhar com metadados de imagem. Por
1414
exemplo, pode-se usar funções exif para ler metadados de fotografias obtidas
1515
de câmeras digitais com informações armazenadas no cabeçalho do aqruivo.
1616
Estas informações são usualmente encontradas em imagens <acronym>JPEG</acronym> e
1717
<acronym>TIFF</acronym>.
18-
</para>
18+
</simpara>
1919
</preface>
2020
<!-- }}} -->
2121

@@ -24,7 +24,6 @@
2424
&reference.exif.reference;
2525

2626
</book>
27-
2827
<!-- Keep this comment at the end of the file
2928
Local variables:
3029
mode: sgml
@@ -45,4 +44,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
4544
vim: et tw=78 syn=sgml
4645
vi: ts=1 sw=1
4746
-->
48-

‎reference/exif/configure.xml‎

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,19 @@
11
<?xml version="1.0" encoding="UTF-8"?>
2-
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: felipe Status: ready -->
3-
<section xml:id="exif.installation" xmlns="http://docbook.org/ns/docbook">
2+
<!-- EN-Revision: 6a08181be1706dfebdb3ad6e45620bceb08019ba Maintainer: felipe Status: ready -->
3+
<section xmlns="http://docbook.org/ns/docbook" xml:id="exif.installation">
44
&reftitle.install;
5-
<para>
5+
<simpara>
66
Para habilitar suporte a exif configure o PHP com
77
<option role="configure">--enable-exif</option>
8-
</para>
9-
<para>
8+
</simpara>
9+
<simpara>
1010
Usuários Windows precisam habilitar as DLLs <filename>php_mbstring.dll</filename>
1111
e <filename>php_exif.dll</filename> no &php.ini;. A DLL
1212
<filename>php_mbstring.dll</filename> precisa ser carregada
1313
<emphasis>antes</emphasis> da <filename>php_exif.dll</filename> então
1414
ajuste seu &php.ini; corretamente.
15-
</para>
15+
</simpara>
1616
</section>
17-
18-
1917
<!-- Keep this comment at the end of the file
2018
Local variables:
2119
mode: sgml

‎reference/exif/constants.xml‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: b090c4476884e5dbce1f3cc2adf28c65b04d9de9 Maintainer: leonardolara Status: ready -->
2+
<!-- EN-Revision: 6a08181be1706dfebdb3ad6e45620bceb08019ba Maintainer: leonardolara Status: ready -->
33
<!-- CREDITS: felipe,leonardolara -->
44
<appendix xmlns="http://docbook.org/ns/docbook" xml:id="exif.constants">
55
&reftitle.constants;
@@ -19,10 +19,10 @@
1919
</listitem>
2020
</varlistentry>
2121
</variablelist>
22-
<para>
22+
<simpara>
2323
A função <function>exif_imagetype</function> lista várias constantes internas
2424
relacionadas.
25-
</para>
25+
</simpara>
2626
</appendix>
2727
<!-- Keep this comment at the end of the file
2828
Local variables:

‎reference/exif/functions/exif-imagetype.xml‎

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: b090c4476884e5dbce1f3cc2adf28c65b04d9de9 Maintainer: leonardolara Status: ready -->
2+
<!-- EN-Revision: 6a08181be1706dfebdb3ad6e45620bceb08019ba Maintainer: leonardolara Status: ready -->
33
<!-- CREDITS: felipe,leonardolara -->
44
<!-- splitted from ./en/functions/image.xml, last change in rev 1.81 -->
55
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.exif-imagetype">
@@ -13,16 +13,16 @@
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> lê os primeiros bytes de uma imagem e
1818
verifica sua assinatura.
19-
</para>
20-
<para>
19+
</simpara>
20+
<simpara>
2121
<function>exif_imagetype</function> pode ser usada para evitar chamadas a outras funções
2222
<link linkend="ref.exif">exif</link> que não têm suporte a certos tipos de arquivos
2323
ou um conjunção com <varname>$_SERVER['HTTP_ACCEPT']</varname> para verificar
2424
se o visualizador é capaz de mostrar uma imagem específica no navegador.
25-
</para>
25+
</simpara>
2626
</refsect1>
2727
<refsect1 role="parameters">
2828
&reftitle.parameters;
@@ -39,12 +39,12 @@
3939
</refsect1>
4040
<refsect1 role="returnvalues">
4141
&reftitle.returnvalues;
42-
<para>
42+
<simpara>
4343
Quando uma assinatura correta é encontrada, o valor da constante associada será
4444
retornado, caso contrário o valor de retorno será &false;. O valor retornado é o
4545
mesmo valor que <function>getimagesize</function> retorna no índice 2, mas
4646
<function>exif_imagetype</function> é bem mais rápida.
47-
</para>
47+
</simpara>
4848
<para>
4949
As seguintes constantes estão definidas, e representam os possíveis
5050
valores de retorno de <function>exif_imagetype</function>:
@@ -142,13 +142,13 @@
142142
</para>
143143

144144
<note>
145-
<para>
145+
<simpara>
146146
<function>exif_imagetype</function> emitirá um erro de nível <constant>E_NOTICE</constant>
147147
e retornará &false; se for incapaz de ler bytes suficientes do arquivo para
148148
determinar o tipo da imagem.
149149
<!-- If the function finds an incomplete PNG header then it may emit an
150150
<constant>E_WARNING</constant> instead. - Is this worth including? -->
151-
</para>
151+
</simpara>
152152
</note>
153153

154154
</refsect1>

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

Lines changed: 29 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: b090c4476884e5dbce1f3cc2adf28c65b04d9de9 Maintainer: leonardolara Status: ready -->
2+
<!-- EN-Revision: 6a08181be1706dfebdb3ad6e45620bceb08019ba Maintainer: leonardolara Status: ready -->
33
<!-- CREDITS: fernandoc,leonardolara -->
44
<!-- splitted from ./en/functions/image.xml, last change in rev 1.78 -->
55
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.exif-read-data">
@@ -16,24 +16,24 @@
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
A função <function>exif_read_data</function> lê os cabeçalhos
2121
<acronym>EXIF</acronym> de um arquivo de imagem. Desta forma é possível ler metadados
2222
gerados por câmeras digitais.
23-
</para>
24-
<para>
23+
</simpara>
24+
<simpara>
2525
Cabeçalhos <acronym>EXIF</acronym> tendem a estar presentes em imagens JPEG/TIFF geradas por camêras
2626
digitais, mas infelizmente, cada fabricante de camêra digital tem
2727
uma ideia diferente de como rotular suas imagens, então não se
2828
pode confiar sempre que um cabeçalho EXIF específico estará presente.
29-
</para>
30-
<para>
29+
</simpara>
30+
<simpara>
3131
Altura (<literal>Height</literal>) e largura (<literal>Width</literal>) sao computadas
3232
da mesma maneira que <function>getimagesize</function> faz, então seus valores não devem
3333
ser parte de nenhum cabeçalho retornado. Além disso, <literal>html</literal> é
3434
uma string de texto com altura/largura a ser usado dentro de um<acronym>HTML</acronym> normal.
35-
</para>
36-
<para>
35+
</simpara>
36+
<simpara>
3737
Quando um cabeçalho Exif contém uma nota de direitos autorais, esta nota pode conter dois
3838
valores. Como a solução é inconsistente com o padrão Exif 2.10 a seção
3939
<literal>COMPUTED</literal> irá retornar ambas as entradas
@@ -44,8 +44,8 @@
4444
do Exif). <literal>COMPUTED</literal> irá conter também a entrada
4545
<literal>Copyright</literal> que será a string original do copyright
4646
ou uma lista separada por vírgula dos direitos autorais da foto e do editor.
47-
</para>
48-
<para>
47+
</simpara>
48+
<simpara>
4949
A etiqueta <literal>UserComment</literal> tem o mesmo problema que a etiqueta de
5050
Copyright. Ela pode guardar dois valores. Primeiro a codificação usada e em segundo o valor
5151
em si. Então a seção <literal>IFD</literal> contém somente a codificação
@@ -54,23 +54,23 @@
5454
<literal>UserComment</literal>. A entrada <literal>UserComment</literal>
5555
está disponível em ambos os casos então deve ser usada em preferência ao
5656
valor da seção <literal>IFD0</literal>.
57-
</para>
58-
<para>
57+
</simpara>
58+
<simpara>
5959
<function>exif_read_data</function> também valida etiquetas de dados EXIF de acordo
6060
com a especificação EXIF (<link xlink:href="&url.exifspec;">&url.exifspec;</link>, página 20).
61-
</para>
61+
</simpara>
6262
</refsect1>
6363
<refsect1 role="parameters">
6464
&reftitle.parameters;
6565
<variablelist>
6666
<varlistentry>
6767
<term><parameter>file</parameter></term>
6868
<listitem>
69-
<para>
69+
<simpara>
7070
A localização do arquivo de imagem. Pode ser uma caminho para o arquivo
7171
(empacotadores de fluxo são também suportados)
7272
ou um fluxo do tipo <type>resource</type>.
73-
</para>
73+
</simpara>
7474
</listitem>
7575
</varlistentry>
7676
<varlistentry>
@@ -137,43 +137,43 @@
137137
<varlistentry>
138138
<term><parameter>as_arrays</parameter></term>
139139
<listitem>
140-
<para>
140+
<simpara>
141141
Especifica se cada seção se torna ou não um array. As seções
142142
<literal>COMPUTED</literal>, <literal>THUMBNAIL</literal> E
143143
<literal>COMMENT</literal> de <parameter>required_sections</parameter>
144144
sempre se toranm arrays por que contêm valores cujos nomes conflitam
145145
com outras seções.
146-
</para>
146+
</simpara>
147147
</listitem>
148148
</varlistentry>
149149
<varlistentry>
150150
<term><parameter>read_thumbnail</parameter></term>
151151
<listitem>
152-
<para>
152+
<simpara>
153153
Quando definida para &true; a miniatura em si é lida. Caso contrário, apenas
154154
os dados etiquetados são lidos.
155-
</para>
155+
</simpara>
156156
</listitem>
157157
</varlistentry>
158158
</variablelist>
159159
</refsect1>
160160
<refsect1 role="returnvalues">
161161
&reftitle.returnvalues;
162-
<para>
162+
<simpara>
163163
Retorna um <type>array</type> associativo onde os índices são
164164
os nomes dos cabeçalhos e os valores são os associados com
165165
esses cabeçalhos. Se nenhum dado puder ser retornado,
166166
<function>exif_read_data</function> retornará &false;.
167-
</para>
167+
</simpara>
168168
</refsect1>
169169

170170
<refsect1 role="errors">
171171
&reftitle.errors;
172-
<para>
172+
<simpara>
173173
Erros de nível <constant>E_WARNING</constant> e/ou <constant>E_NOTICE</constant>
174174
podem ser disparados para etiquetas não suportadas ou outras condições de erros potenciais, mas a
175175
função ainda tenta lêr toda a informação compreensível.
176-
</para>
176+
</simpara>
177177
</refsect1>
178178

179179
<refsect1 role="changelog">
@@ -246,9 +246,9 @@ foreach ($exif as $key => $section) {
246246
?>
247247
]]>
248248
</programlisting>
249-
<para>
249+
<simpara>
250250
A primeira chamada falha porque a imagem não tem informações no cabeçalho.
251-
</para>
251+
</simpara>
252252
&example.outputs.similar;
253253
<screen role="php">
254254
<![CDATA[
@@ -334,21 +334,21 @@ Cabeçalhos EXIF:
334334
<refsect1 role="notes">
335335
&reftitle.notes;
336336
<note>
337-
<para>
337+
<simpara>
338338
Se <link linkend="ref.mbstring">mbstring</link> estiver habilitado, exif tentará processar
339339
em codificação unicode e escolher um conjunto de caracteres como especificado por
340340
<link linkend="ini.exif.decode-unicode-motorola">exif.decode_unicode_motorola</link> e
341341
<link linkend="ini.exif.decode-unicode-intel">exif.decode_unicode_intel</link>. A extensão
342342
exif não tentará descobrir a codificação por si mesma, é responsabilidade do programador
343343
especificar corretamente a codificação a ser usada, configurando uma das duas
344344
diretivas ini antes de chamar <function>exif_read_data</function>.
345-
</para>
345+
</simpara>
346346
</note>
347347
<note>
348-
<para>
348+
<simpara>
349349
Se <parameter>file</parameter> for usado para passar um fluxo a esta função, o fluxo
350350
deve ser do tipo pesquisável. Note que a posição do ponteiro do arquivo não é alterada depois que esta função retorna.
351-
</para>
351+
</simpara>
352352
</note>
353353
</refsect1>
354354
<refsect1 role="seealso">

‎reference/exif/functions/exif-tagname.xml‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: b090c4476884e5dbce1f3cc2adf28c65b04d9de9 Maintainer: leonardolara Status: ready -->
2+
<!-- EN-Revision: 6a08181be1706dfebdb3ad6e45620bceb08019ba Maintainer: leonardolara Status: ready -->
33
<!-- CREDITS: felipe,leonardolara -->
44
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.exif-tagname">
55
<refnamediv>
@@ -19,19 +19,19 @@
1919
<varlistentry>
2020
<term><parameter>index</parameter></term>
2121
<listitem>
22-
<para>
22+
<simpara>
2323
O ID da etiqueta para o qual o nome do cabeçalho será pesquisado
24-
</para>
24+
</simpara>
2525
</listitem>
2626
</varlistentry>
2727
</variablelist>
2828
</refsect1>
2929
<refsect1 role="returnvalues">
3030
&reftitle.returnvalues;
31-
<para>
31+
<simpara>
3232
Retorna o nome do cabeçalho, ou &false; se <parameter>index</parameter> não
3333
for um id de etiqueta EXIF definido.
34-
</para>
34+
</simpara>
3535
</refsect1>
3636
<refsect1 role="examples">
3737
&reftitle.examples;

0 commit comments

Comments
 (0)