Skip to content

Commit 7a8b7b5

Browse files
GirgiasGirgias
committed
exif : fix XML by converting para to simpara tags via script
1 parent 7871327 commit 7a8b7b5

File tree

9 files changed

+94
-102
lines changed

9 files changed

+94
-102
lines changed

‎reference/exif/book.xml‎

Lines changed: 6 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,31 +1,29 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 762fd781b63e37a13eb616602f715898dd237955 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 6a08181be1706dfebdb3ad6e45620bceb08019ba Maintainer: takagi Status: ready -->
44
<!-- Credits: mumumu -->
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>Exchangeable image information</title>
98
<titleabbrev>Exif</titleabbrev>
10-
9+
1110
<!-- {{{ preface -->
1211
<preface xml:id="intro.exif">
1312
&reftitle.intro;
14-
<para>
13+
<simpara>
1514
exif 拡張モジュールを使用すると、画像のメタデータを扱うことが可能と
1615
なります。例えば、デジタルカメラで撮影した画像ファイルから
1716
画像のヘッダ情報を読み込むために exif 関数を使用することができます。
1817
こうした情報は、通常 <acronym>JPEG</acronym> や <acronym>TIFF</acronym> 画像で見つかります。
19-
</para>
18+
</simpara>
2019
</preface>
2120
<!-- }}} -->
22-
21+
2322
&reference.exif.setup;
2423
&reference.exif.constants;
2524
&reference.exif.reference;
2625

2726
</book>
28-
2927
<!-- Keep this comment at the end of the file
3028
Local variables:
3129
mode: sgml
@@ -46,4 +44,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
4644
vim: et tw=78 syn=sgml
4745
vi: ts=1 sw=1
4846
-->
49-

‎reference/exif/configure.xml‎

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,21 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: takagi Status: ready -->
4-
<section xml:id="exif.installation" xmlns="http://docbook.org/ns/docbook">
3+
<!-- EN-Revision: 6a08181be1706dfebdb3ad6e45620bceb08019ba Maintainer: takagi Status: ready -->
4+
<section xmlns="http://docbook.org/ns/docbook" xml:id="exif.installation">
55
&reftitle.install;
6-
<para>
6+
<simpara>
77
exif サポートを有効にするには、PHP の configure 時に
88
<option role="configure">--enable-exif</option> を指定します。
9-
</para>
10-
<para>
9+
</simpara>
10+
<simpara>
1111
Windows ユーザーは、&php.ini; で <filename>php_mbstring.dll</filename>
1212
および <filename>php_exif.dll</filename> の両方の DLL を有効にする
1313
必要があります。<filename>php_mbstring.dll</filename> DLL は、必ず
1414
<filename>php_exif.dll</filename> DLL より <emphasis>先に</emphasis>
1515
読み込まれていなければなりません。そうなるように &php.ini; で設定
1616
してください。
17-
</para>
17+
</simpara>
1818
</section>
19-
20-
2119
<!-- Keep this comment at the end of the file
2220
Local variables:
2321
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: takagi Status: ready -->
3+
<!-- EN-Revision: 6a08181be1706dfebdb3ad6e45620bceb08019ba Maintainer: takagi Status: ready -->
44
<appendix xmlns="http://docbook.org/ns/docbook" xml:id="exif.constants">
55
&reftitle.constants;
66
&extension.constants;
@@ -19,10 +19,10 @@
1919
</listitem>
2020
</varlistentry>
2121
</variablelist>
22-
<para>
22+
<simpara>
2323
<function>exif_imagetype</function> は、関連するいくつかの組み込み定数を
2424
一覧表示します。
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,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: b090c4476884e5dbce1f3cc2adf28c65b04d9de9 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 6a08181be1706dfebdb3ad6e45620bceb08019ba Maintainer: takagi Status: ready -->
44
<!-- Credits: mumumu -->
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> を画像の先頭バイトを読み
1818
そのサインを調べます。
19-
</para>
20-
<para>
19+
</simpara>
20+
<simpara>
2121
<function>exif_imagetype</function> は、他の
2222
<link linkend="ref.exif">exif</link> 関数がサポートしていないファイル形式で
2323
コールされるの防いだり、<varname>$_SERVER['HTTP_ACCEPT']</varname>
2424
と組み合わせて閲覧者が画像を見る権限を持っているかどうかを調べたりするために
2525
使用可能です。
26-
</para>
26+
</simpara>
2727
</refsect1>
2828
<refsect1 role="parameters">
2929
&reftitle.parameters;
@@ -40,12 +40,12 @@
4040
</refsect1>
4141
<refsect1 role="returnvalues">
4242
&reftitle.returnvalues;
43-
<para>
43+
<simpara>
4444
正しいサインが見つかった場合は適切な定数、それ以外の場合は &false;
4545
を返します。戻り値は <function>getimagesize</function> がインデックス
4646
2 に対して返す値と同じですが、<function>exif_imagetype</function>
4747
のほうがずっと早く動作します。
48-
</para>
48+
</simpara>
4949
<para>
5050
以下の定数が定義されており、<function>exif_imagetype</function>
5151
の戻り値を表しています。
@@ -143,13 +143,13 @@
143143
</para>
144144

145145
<note>
146-
<para>
146+
<simpara>
147147
画像の形式を判別するために必要なだけのバイト数を読み込めない場合、
148148
<function>exif_imagetype</function> は <constant>E_NOTICE</constant>
149149
を発行して &false; を返します。
150150
<!-- If the function finds an incomplete PNG header then it may emit an
151151
<constant>E_WARNING</constant> instead. - Is this worth including? -->
152-
</para>
152+
</simpara>
153153
</note>
154154
</refsect1>
155155
<refsect1 role="changelog">

‎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: takagi Status: ready -->
3+
<!-- EN-Revision: 6a08181be1706dfebdb3ad6e45620bceb08019ba Maintainer: takagi Status: ready -->
44
<!-- Credits: mumumu -->
55
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.exif-read-data">
66
<refnamediv>
@@ -18,26 +18,26 @@
1818
<methodparam choice="opt"><type>bool</type><parameter>as_arrays</parameter><initializer>&false;</initializer></methodparam>
1919
<methodparam choice="opt"><type>bool</type><parameter>read_thumbnail</parameter><initializer>&false;</initializer></methodparam>
2020
</methodsynopsis>
21-
<para>
21+
<simpara>
2222
<function>exif_read_data</function> は、
2323
画像ファイルから <acronym>EXIF</acronym>
2424
ヘッダを読み込みます。この方法で、デジタルカメラが生成したメタデータを
2525
読み込むことが可能です。
26-
</para>
27-
<para>
26+
</simpara>
27+
<simpara>
2828
<acronym>EXIF</acronym> ヘッダは、デジタルカメラが作成した JPEG/TIFF
2929
画像によく含まれています。しかし残念なことに、
3030
そのタグ付けの方法はメーカーによって異なります。
3131
したがって、特定の Exif ヘッダが常に存在すると仮定することはできません。
32-
</para>
33-
<para>
32+
</simpara>
33+
<simpara>
3434
<literal>Height</literal> および <literal>Width</literal>
3535
は、<function>getimagesize</function> と同じ方法で計算されます。
3636
よって、これらの値は決してヘッダの一部として返してはいけません。
3737
また、<literal>html</literal> は高さ/幅を表すテキスト文字列で、
3838
通常の <acronym>HTML</acronym> の中で用いられます。
39-
</para>
40-
<para>
39+
</simpara>
40+
<simpara>
4141
Exif ヘッダに著作権表示が含まれている場合、それ自身には 2 つの値を
4242
含めることが可能です。Exif 2.10 のこの矛盾した規格に対応するため、
4343
<literal>COMPUTED</literal> セクションは <literal>Copyright.Photographer</literal>
@@ -47,33 +47,33 @@
4747
かえします（Exif の通常の挙動）。<literal>COMPUTED</literal> には、元の著作権文字列あるいは
4848
カンマで区切られた写真と編集者の著作権表示のどちらかを
4949
<literal>Copyright</literal> エントリに含めることが可能です。
50-
</para>
51-
<para>
50+
</simpara>
51+
<simpara>
5252
<literal>UserComment</literal> タグにも Copyright タグと同様の問題があります。ここにも
5353
2 つの値を格納することが可能です。それは使用しているエンコーディングと
5454
値自身の 2 つです。そうなると、<literal>IFD</literal> セクションにはエンコーディングのみを
5555
含めるか、あるいはバイト配列を格納することになります。<literal>COMPUTED</literal> セクションは
5656
<literal>UserCommentEncoding</literal> および <literal>UserComment</literal>
5757
を両方格納することができます。<literal>UserComment</literal> はどちらの
5858
場合でも有効なので、<literal>IFD0</literal> セクションではこちらを優先すべきです。
59-
</para>
60-
<para>
59+
</simpara>
60+
<simpara>
6161
<function>exif_read_data</function> は、EXIF 仕様（<link xlink:href="&url.exifspec;">&url.exifspec;</link>, 20 ページ）に基づいて
6262
EXIF データタグの検証も行います。
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
画像ファイルの位置。
7373
ファイルのパス
7474
(ストリームラッパーもいつもどおりサポートされています)
7575
またはストリーム<type>resource</type>。
76-
</para>
76+
</simpara>
7777
</listitem>
7878
</varlistentry>
7979
<varlistentry>
@@ -140,43 +140,43 @@
140140
<varlistentry>
141141
<term><parameter>as_arrays</parameter></term>
142142
<listitem>
143-
<para>
143+
<simpara>
144144
各セクションを配列とするかどうかを指定します。
145145
<parameter>required_sections</parameter> の
146146
<literal>COMPUTED</literal>、
147147
<literal>THUMBNAIL</literal> および <literal>COMMENT</literal>
148148
は常に配列となります。これは、これらのセクションに
149149
含まれる値の名前が他のセクションと衝突する可能性があるからです。
150-
</para>
150+
</simpara>
151151
</listitem>
152152
</varlistentry>
153153
<varlistentry>
154154
<term><parameter>read_thumbnail</parameter></term>
155155
<listitem>
156-
<para>
156+
<simpara>
157157
&true; を指定すると、サムネイル本体を読み込みます。それ以外の場合は
158158
タグつきデータのみを読み込みます。
159-
</para>
159+
</simpara>
160160
</listitem>
161161
</varlistentry>
162162
</variablelist>
163163
</refsect1>
164164
<refsect1 role="returnvalues">
165165
&reftitle.returnvalues;
166-
<para>
166+
<simpara>
167167
ヘッダ名がキー・ヘッダの内容が値となる連想配列を返します。
168168
返されるデータがない場合は
169169
<function>exif_read_data</function> は &false; を返します。
170-
</para>
170+
</simpara>
171171
</refsect1>
172172

173173
<refsect1 role="errors">
174174
&reftitle.errors;
175-
<para>
175+
<simpara>
176176
サポートされていないタグや、エラーが起きうる条件が指定された場合は、
177177
<constant>E_WARNING</constant> かつ/または <constant>E_NOTICE</constant> が発生します。
178178
警告が発生しても、この関数は対応する情報を全て読み取ろうとします。
179-
</para>
179+
</simpara>
180180
</refsect1>
181181

182182
<refsect1 role="changelog">
@@ -249,9 +249,9 @@ foreach ($exif as $key => $section) {
249249
?>
250250
]]>
251251
</programlisting>
252-
<para>
252+
<simpara>
253253
最初のコールは失敗します。画像がヘッダ情報を有していないためです。
254-
</para>
254+
</simpara>
255255
&example.outputs.similar;
256256
<screen role="php">
257257
<![CDATA[
@@ -337,7 +337,7 @@ EXIF Headers:
337337
<refsect1 role="notes">
338338
&reftitle.notes;
339339
<note>
340-
<para>
340+
<simpara>
341341
<link linkend="ref.mbstring">mbstring</link> が有効な場合、
342342
exif はUnicodeを処理し、
343343
<link linkend="ini.exif.decode-unicode-motorola">exif.decode_unicode_motorola</link> および
@@ -347,14 +347,14 @@ EXIF Headers:
347347
<function>exif_read_data</function> を呼ぶ前に、
348348
これらの ini ディレクティブのうちのひとつに
349349
どのエンコーディングをデコードに使うかを適切に設定するのはユーザーの責任です。
350-
</para>
350+
</simpara>
351351
</note>
352352
<note>
353-
<para>
353+
<simpara>
354354
この関数にストリームを渡すために <parameter>file</parameter> を使った場合、
355355
ストリームはシーク可能でなければなりません。
356356
ファイルポインタの位置は、関数から戻った後でも変化しないことに注意してください。
357-
</para>
357+
</simpara>
358358
</note>
359359
</refsect1>
360360

‎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: takagi Status: ready -->
3+
<!-- EN-Revision: 6a08181be1706dfebdb3ad6e45620bceb08019ba Maintainer: takagi Status: ready -->
44
<!-- Credits: mumumu -->
55
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.exif-tagname">
66
<refnamediv>
@@ -20,20 +20,20 @@
2020
<varlistentry>
2121
<term><parameter>index</parameter></term>
2222
<listitem>
23-
<para>
23+
<simpara>
2424
名前を調べたいタグの ID。
25-
</para>
25+
</simpara>
2626
</listitem>
2727
</varlistentry>
2828
</variablelist>
2929
</refsect1>
3030
<refsect1 role="returnvalues">
3131
&reftitle.returnvalues;
32-
<para>
32+
<simpara>
3333
ヘッダ名を返します。もし <parameter>index</parameter> が
3434
EXIF タグ ID として未定義の場合は
3535
&false; を返します。
36-
</para>
36+
</simpara>
3737
</refsect1>
3838
<refsect1 role="examples">
3939
&reftitle.examples;

0 commit comments

Comments
 (0)