cvs: phpdoc-it /reference/xml reference.xml
| From: | Andrioli Darvin | Date: | Mon, 30 Sep 2002 19:44:48 +0000 |
| Subject: | cvs: phpdoc-it /reference/xml reference.xml | ||
| Groups: | php.doc.it | ||
| Request: | Send a blank email to doc-it+get-119@lists.php.net to get a copy of this message | ||
darvina Mon Sep 30 15:44:48 2002 EDT
Modified files:
/phpdoc-it/reference/xml reference.xml
Log:
Update to En 1.6
Index: phpdoc-it/reference/xml/reference.xml
diff -u phpdoc-it/reference/xml/reference.xml:1.2 phpdoc-it/reference/xml/reference.xml:1.3
--- phpdoc-it/reference/xml/reference.xml:1.2 Fri Apr 26 16:11:34 2002
+++ phpdoc-it/reference/xml/reference.xml Mon Sep 30 15:44:48 2002
@@ -1,39 +1,60 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.4 Maintainer: darvina Status: ready -->
+<!-- EN-Revision: 1.6 Maintainer: darvina Status: ready -->
<reference id="ref.xml">
<title>Funzioni relative al parser XML</title>
<titleabbrev>XML</titleabbrev>
<partintro>
- <section id="xml.partintro">
- <title>Introduzione</title>
- <section id="xml.intro">
- <title>XML</title>
- <para>
- XML (eXtensible Markup Language) è un formato utilizzato per l'interscambio
- di documenti strutturati sul Web. Questo è uno standard definito da
- The World Wide Web consortium (W3C). Maggiori informazioni su XML e
- le relative tecnologie possono essere reperite all'indirizzo <ulink
- url="&url.xml;">&url.xml;</ulink>.
- </para>
- </section>
- <section id="xml.install">
- <title>Installazione</title>
- <para>
- Questa estensione utilizza il modulo <productname>expat</productname>, che può
- essere reperito all'indirizzo <ulink
url="&url.expat;">&url.expat;</ulink>. Il
- Makefile fornito con expat, per default, non compila la libreria,
- occorre utilizzare le seguenti istruzioni per il comando make:
- <programlisting role="makefile">
+
+ <section id="xml.intro">
+ &reftitle.intro;
+ <para>
+ XML (eXtensible Markup Language) è un formato utilizzato per l'interscambio
+ di documenti strutturati sul Web. Questo è uno standard definito da
+ The World Wide Web consortium (W3C). Maggiori informazioni su XML e
+ le relative tecnologie possono essere reperite all'indirizzo <ulink
+ url="&url.xml;">&url.xml;</ulink>.
+ </para>
+ <para>
+ Questo modulo del PHP offre il supporto del modulo
+ <productname>expat</productname> di James Clark. Questo tool
+ permette il parsing, ma non la validazione, di documenti XML. Sono supportati
+ tre tipi di <link linkend="xml.encoding">codifica di caratteri</link>,
+ supportati anche dal PHP:<literal>US-ASCII</literal>,
+ <literal>ISO-8859-1</literal> ed <literal>UTF-8</literal>.
+ La codifica <literal>UTF-16</literal> non è supportata.
+ </para>
+ <para>
+ Questo modulo permette di <link
+ linkend="function.xml-parser-create">creare parser XML</link>
+ e di definire dei <emphasis>gestori</emphasis> per i vari eventi
+ XML. Inoltre ogni singolo parser XML ha diversi <link
+ linkend="function.xml-parser-set-option">parametri</link> che possono
+ essere configurati in base alle varie esigenze.
+ </para>
+ </section>
+
+ <section id="xml.requirements">
+ &reftitle.required;
+ <para>
+ Questa estensione utilizza il modulo <productname>expat</productname>, che può
+ essere reperito all'indirizzo <ulink
url="&url.expat;">&url.expat;</ulink>. Il
+ Makefile fornito con expat, per default, non compila la libreria,
+ occorre utilizzare le seguenti istruzioni per il comando make:
+ <programlisting role="makefile">
<![CDATA[
libexpat.a: $(OBJS)
ar -rc $@ $(OBJS)
ranlib $@
]]>
- </programlisting>
- Il sorgente in formato package RPM può essere reperito all'indirizzo <ulink
- url="&url.expat.rpm;">&url.expat.rpm;</ulink>.
- </para>
+ </programlisting>
+ Il sorgente in formato package RPM può essere reperito all'indirizzo <ulink
+ url="&url.expat.rpm;">&url.expat.rpm;</ulink>.
+ </para>
+ </section>
+
+ <section id="xml.installation">
+ &reftitle.install;
<para>
Si noti che se si usa Apache 1.3.7 o successive, la libreria
expat è già presente. In questo caso configurare PHP utilizzando
@@ -57,25 +78,20 @@
</para>
</section>
- <section id="xml.about">
- <title>Note su questa estensione</title>
- <para>
- Questa estensione di PHP implementa il supporto per il modulo
- <productname>expat</productname> di James Clark in PHP. Questo strumento permette
- il parsing, ma non la validazione, di documenti XML. Il modulo supporta
- tre tipi di <link linkend="xml.encoding">codifica di caratteri</link>
- già presenti in PHP: <literal>US-ASCII</literal>,
- <literal>ISO-8859-1</literal> e <literal>UTF-8</literal>.
- La codifica <literal>UTF-16</literal> non è supportata.
- </para>
- <para>
- Questa estensione permette di <link
- linkend="function.xml-parser-create">creare un parser XML</link>
- e di definire dei <emphasis>gestori</emphasis> per i differenti
- eventi di XML. Ciascun parser XML ha diversi <link
- linkend="function.xml-parser-set-option">parametri</link>
- configurabili.
- </para>
+ <section id="xml.configuration">
+ &reftitle.runtime;
+ &no.config;
+ </section>
+
+ <section id="xml.resources">
+ &reftitle.resources;
+ &no.resource;
+ </section>
+
+ &reference.xml.constants;
+
+ <section id="xml.eventhandlers">
+ <title>Event Handlers</title>
<para>
I gestori di eventi XML definiti sono:
<table>
@@ -215,6 +231,7 @@
</simplelist>
</para>
</section>
+
<section id="xml.encoding">
<title>Codifica dei caratteri</title>
<para>
@@ -246,7 +263,7 @@
gestione del XML. Quando viene creato un parser XML, la codifica
per il destinatario viene posta uguale alla codifica del sorgente, ma ciò può
essere variato. La codifica per il destinatario viene applicata ai caratteri dei dati,
- ai nomi delle tag e alle istruzioni di processamento.
+ ai nomi dei tag e alle istruzioni di processamento.
</para>
<para>
Se il parser XML incontra caratteri esterni al range dei caratteri
@@ -260,10 +277,9 @@
carattere in questione con un punto interrogativo.
</para>
</section>
- </section>
<section id="xml.examples">
- <title>Alcuni esempi</title>
+ &reftitle.examples;
<para>
Di seguito verranno illustrati alcuni esempi di script PHP per il parsing di documenti XML.
</para>
@@ -320,7 +336,7 @@
<title>Conversione da XML a HTML</title>
<para>
Il seguente esempio converte i tag di un documento XML in
- tag HTML. Gli elementi non trovati nella matrice delle tag saranno ignorati.
+ tag HTML. Gli elementi non trovati nella matrice dei tag saranno ignorati.
Ovviamente questo esempio funziona solo con uno specifico tipo di
documento XML:
<programlisting role="php">
@@ -379,8 +395,8 @@
<para>
Questo esempio evidenzia il codice XML. Si illustrerà come utilizzare
il riferimento ad entità esterne per includere ed analizzare altri
- documenti, sarà illustrato anche come processare le PIs, ed il modo
- per determinare l'affidabilità del codice contenuto dalle PIs.
+ documenti, sarà illustrato anche come processare le PI, ed il modo
+ per determinare l'affidabilità del codice contenuto delle PI.
</para>
<para>
I documenti XML che possono essere usati per questo esempio sono