Comparar revisiones

Marcado XML en los microresúmenes

Revisión 262775:

Revisión 262775 de Superruzafa el

Revisión 230249:

Revisión 230249 de Superruzafa el

Título:
Marcado XML en los microresúmenes
Marcado XML en los microresúmenes
Enlace amigable (slug):
Marcado_XML_en_los_microresúmenes
Marcado_XML_en_los_microresúmenes
Etiquetas:
Todas_las_Categorías, Microresúmenes, Esbozos
Contenido:

Revisión 262775
Revisión 230249
t7    <p>t
8      {{ Esbozo() }}
9    </p>
10    <h2 id="Introducci.C3.B3n" name="Introducci.C3.B3n">
11      Introducción
12    </h2>
13    <p>
14      Un generador de microrresúmenes es un documento XML que des
>cribe la forma de recuperar información específica desde una pági 
>na web para ser presentada de forma resumida como un marcador cuy 
>o título cambia basándose en el contenido de la página que refere 
>ncia. 
15    </p>
16    <p>
17      Este artículo proporciona información detallada sobre la gr
>amática XML usada para construir generadores de microrresúmenes,  
>describiendo cada elemento y sus atributos. Puedes ver una introd 
>ucción de cómo crear un microrresumen leyendo el artículo <a href 
>="es/Crear_un_microrresumen">Crear un microrresumen</a>. 
18    </p>
19    <h2 id="Ejemplo" name="Ejemplo">
20      Ejemplo
21    </h2>
22    <p>
23      A continuación se muestra el generador de microrresúmenes c
>reado en el tutorial <a href="es/Crear_un_microrresumen">Crear un 
> microrresumen</a>. 
24    </p>
25    <pre class="eval">
26&lt;?xml version="1.0" encoding="UTF-8"?&gt;
27&lt;generator xmlns="<span class="nowiki">http://www.mozilla.org/
>microsummaries/0.1</span>" name="Firefox Download Count"&gt; 
28  &lt;template&gt;
29    &lt;transform xmlns="<span class="nowiki">http://www.w3.org/1
>999/XSL/Transform</span>" version="1.0"&gt; 
30      &lt;output method="text"/&gt;
31      &lt;template match="/"&gt;
32        &lt;value-of select="id('download-count')"/&gt;
33        &lt;text&gt; Fx downloads&lt;/text&gt;
34      &lt;/template&gt;
35    &lt;/transform&gt;
36  &lt;/template&gt;
37  &lt;pages&gt;
38    &lt;include&gt;<span class="nowiki">http://(www\.)?spreadfire
>fox\.com/(index\.php)?</span>&lt;/include&gt; 
39  &lt;/pages&gt;
40&lt;/generator&gt;
41</pre>
42    <h2 id="Espacio_de_nombres" name="Espacio_de_nombres">
43      Espacio de nombres
44    </h2>
45    <p>
46      El URI del espacio de nombres para los documentos XML gener
>adores de microrresúmenes es: 
47    </p>
48    <pre class="eval">
49<span class="nowiki">http://www.mozilla.org/microsummaries/0.1</s
>pan> 
50</pre>
51    <p>
52      Todos los elementos en un documento generador de microrresú
>menes deben de estar en este espacio de nombres excepto los desce 
>ndientes del elemento <code><a href="#The_.3Ctemplate.3E_element" 
>>&lt;template&gt;</a></code>, el cual debe de estar en el espacio 
> de nombres de XSLT: 
53    </p>
54    <pre class="eval">
55<span class="nowiki">http://www.w3.org/1999/XSL/Transform</span>
56</pre>
57    <h2 id="El_elemento_.3Cgenerator.3E" name="El_elemento_.3Cgen
>erator.3E"> 
58      El elemento <code>&lt;generator&gt;</code>
59    </h2>
60    <p>
61      El elemento <code>&lt;generator&gt;</code> es la etiqueta r
>aíz para todos los generadores de microrresúmenes y debe de conte 
>ner el resdo del código XML que describen al generador. 
62    </p>
63    <p>
64      <b>Atributos:</b>
65    </p>
66    <dl>
67      <dt>
68        <code>name</code> (requirido)
69      </dt>
70      <dd>
71        Un nombre descriptibo y legible para el microrresumen cre
>ado por el generador. 
72      </dd>
73      <dt>
74        <code>uri</code> (opcional)
75      </dt>
76      <dd>
77        Un URI único válido que identifique al generador. Sólo es
> relevante para los generadores creados dinámicamente por el códi 
>go y las extensiones de Firefox. Los generadores instalados desde 
> el web vía <code>nsSidebar::addMicrosummaryGenerator</code> son  
>identificados por la URL remota desde la que son descargados. Par 
>a éstos, Firefox ignorará el valor de este atributo. 
78      </dd>
79    </dl>
80    <p>
81      <b>Elementos hijos:</b>
82    </p>
83    <dl>
84      <dt>
85        <code><a href="#The_.3Ctemplate.3E_element">&lt;template&
>gt;</a></code> (requerido) 
86      </dt>
87      <dd>
88        Especifica cómo transformar páginas en sus microrresúmene
>s. 
89      </dd>
90      <dt>
91        <code><a href="#The_.3Cpages.3E_element">&lt;pages&gt;</a
>></code> (requerido) 
92      </dt>
93      <dd>
94        Identifica el conjunto de páginas que el generador es cap
>az de resumir. 
95      </dd>
96      <dt>
97        <code><a href="#The_.3Cupdate.3E_element">&lt;update&gt;<
>/a></code> (opcional) 
98      </dt>
99      <dd>
100        Especifica cada cuanto tiempo debe Firefox actualizar los
> microrresúmenes. 
101      </dd>
102    </dl>
103    <h2 id="El_elemento_.3Ctemplate.3E" name="El_elemento_.3Ctemp
>late.3E"> 
104      El elemento <code>&lt;template&gt;</code>
105    </h2>
106    <p>
107      El elemento <code>&lt;template&gt;</code> contiene la hoja 
>de estilos XSLT que transforma páginas web en sus microrresúmenes 
>. 
108    </p>
109    <p>
110      <b>Atributos:</b>
111    </p>
112    <p>
113      <i>Ninguno.</i>
114    </p>
115    <p>
116      <b>Elementos hijos:</b>
117    </p>
118    <dl>
119      <dt>
120        <code>&lt;stylesheet&gt;</code> o <code>&lt;transform&gt;
></code> (requeridos) 
121      </dt>
122      <dd>
123        La hoja de estilos XSLT que realiza la transformación.
124      </dd>
125    </dl>
126    <p>
127      Para cada <a href="es/XSLT">XSLT</a>, debes especificar el 
>elemento hijo de hojas de estilo usando o bien <code>&lt;styleshe 
>et&gt;</code> o bien la etiqueta <code>&lt;transform&gt;</code>,  
>las cuales son intercambiables. 
128    </p>
129    <div class="note">
130      <p>
131        <b>Nota:</b> Aunque el elemento &lt;template&gt; debe de 
>estar en el espacio de nombres del microrresumen (<span class="no 
>wiki">http://www.mozilla.org/microsummaries/0.1</span>), sus elem 
>entos <code>&lt;stylesheet&gt;</code>/<code>&lt;transform&gt;</co 
>de> deben de estar en el espacio de nombres de XSLT (<span class= 
>"nowiki">http://www.w3.org/1999/XSL/Transform</span>). 
132      </p>
133    </div>
134    <h2 id="El_elemento_.3Cpages.3E" name="El_elemento_.3Cpages.3
>E"> 
135      El elemento <code>&lt;pages&gt;</code>
136    </h2>
137    <p>
138      El elemento <code>&lt;pages&gt;</code> identifica el conjun
>to de páginas que el generador es capaz de resumir. 
139    </p>
140    <p>
141      <b>Atributos:</b>
142    </p>
143    <p>
144      <i>Ninguno.</i>
145    </p>
146    <p>
147      <b>Elementos hijo:</b>
148    </p>
149    <dl>
150      <dt>
151        <code><a href="#The_.3Cinclude.3E_element">&lt;include&gt
>;</a></code> (opcional) 
152      </dt>
153      <dd>
154        Una expresión regular que coincide con las URLs de las pá
>ginas que el generador es capaz de resumir. 
155      </dd>
156      <dt>
157        <code><a href="#The_.3Cexclude.3E_element">&lt;exclude&gt
>;</a></code> (opcional) 
158      </dt>
159      <dd>
160        Una expresión regular que coincide con las URLs de las pá
>ginas que el generador es incapaz de resumir. 
161      </dd>
162    </dl>
163    <p>
164      El elemento <code>&lt;pages&gt;</code> puede contener cero 
>o más elementos hijos <code>&lt;include&gt;</code> y <code>&lt;ex 
>clude&gt;</code>, cada uno de los cuales puede contener una expre 
>sión regular compatible con JavaScript. No debe de contener ningú 
>n otro elemento y no tiene ningún attributo. 
165    </p>
166    <p>
167      Cuando un generador es examinado para determinar si es capa
>z o no de resumir una página, las expresiones regulares proporcio 
>nadas por los elementos hijos son evaluadas con la URL de la pági 
>na. Un generador es considerado capaz de resumir una página si al 
> menos una de las expresiones <code>&lt;include&gt;</code> coinci 
>de con la URL de la página y ninguna de las expresiones <code>&lt 
>;exclude&gt;</code> coincide con la URL de la página. 
168    </p>
169    <p>
170      El orden en el que los elementos hijos aparecen en el eleme
>nto <code>&lt;pages&gt;</code> no es relevante. Los espacios en b 
>lanco entre los elementos hijos y las expresiones regulares tampo 
>co importan; no se consideran parte de la expresión regular y no  
>afectan a la evaluación de dichas expresiones. 
171    </p>
172    <p>
173      El siguiente ejemplo identifica un generador como aquel cap
>az de resumir todas las páginas del sitio web <code>www.example.c 
>om</code> excepto las páginas llamadas <code>about.html</code>: 
174    </p>
175    <pre class="eval">
176&lt;pages&gt;
177  &lt;include&gt;
178    <span class="nowiki">^http://www\.example\.com/</span>
179  &lt;/include&gt;
180  &lt;exclude&gt;/about\.html&lt;/exclude&gt;
181&lt;/pages&gt;
182</pre>
183    <div class="note">
184      <b>Nota:</b> Las expresiones regulares diseñadas para coinc
>idir con el comienzo de las URLs de las páginas deberían de empez 
>ar con el acento circunflejo(^) para asegurar que no coinciden po 
>r error con las URLs que simplemente contienen la URL con la que  
>pretenden coincidir. Por ejemplo, la expresión regular <code><spa 
>n class="nowiki">http://www\.example\.com/</span></code> coincidi 
>rá tanto con la URL <code><span class="nowiki">http://www.example 
>.com/</span></code> como en la URL <code><span class="nowiki">htt 
>p://www.evil.com/http://www.example.com/</span></code>, pero la e 
>xpresión regular <code><span class="nowiki">^http://www\.example\ 
>.com/</span></code> sólo coincidirá con la primera de las anterio 
>res dos URLs. 
185    </div>
186    <p>
187      Véase la referencia <a href="es/Core_JavaScript_1.5_Referen
>ce/Global_Objects/RegExp">Core_JavaScript_1.5_Reference:Global_Ob 
>jects:RegExp</a> para detalles sobre la sintaxis válida de las ex 
>presiones regulares para los generadores y el tutorial <a href="e 
>s/Crear_expresiones_regulares_para_generadores_de_microrres%c3%ba 
>menes">Crear expresiones regulares para generadores de microrresú 
>menes</a> para seguir paso a paso las instrucciones sobre cómo es 
>cribir expresiones regulares que coincidan con URLs. 
188    </p>
189    <h2 id="El_elemento_.3Cinclude.3E" name="El_elemento_.3Cinclu
>de.3E"> 
190      El elemento <code>&lt;include&gt;</code>
191    </h2>
192    <p>
193      El elemento <code>&lt;include&gt;</code> identifica un conj
>unto de páginas que el generador es capaz de resumir. Debe de ser 
> hijo del elemento <code>&lt;pages&gt;</code> y debe de contener  
>una expresión regular compatible con JavaScript. 
194    </p>
195    <p>
196      Para más información sobre el uso de este elemento, véase l
>a entrada para <a href="#The_.3Cpages.3E_element">#The_&lt;pages& 
>gt;_element</a>. 
197    </p>
198    <h2 id="El_elemento_.3Cexclude.3E" name="El_elemento_.3Cexclu
>de.3E"> 
199      El elemento <code>&lt;exclude&gt;</code>
200    </h2>
201    <p>
202      El elemento <code>&lt;exclude&gt;</code> identifica un conj
>unto de páginas que el generador no es capaz de resumir. Debe ser 
> hijo del elemento <code>&lt;pages&gt;</code> y debe de contener  
>una expresión regular compatible con JavaScript. 
203    </p>
204    <p>
205      Para más información sobre el uso de este elemento, véase l
>a entrada para <a href="#The_.3Cpages.3E_element">#The_&lt;pages& 
>gt;_element</a>. 
206    </p>
207    <h2 id="El_elemento_.3Cupdate.3E" name="El_elemento_.3Cupdate
>.3E"> 
208      El elemento <code>&lt;update&gt;</code>
209    </h2>
210    <p>
211      El elemento opcional <code>&lt;update&gt;</code> especifica
> cada cuánto tiempo debe Firefox actualizar los microrresúmenes g 
>enerados por el generador. El elemento puede ser usado para espec 
>ificar tanto un intervalo absoluto de actualización como una seri 
>e de intervalos condicionales basados en el contenido de la págin 
>a que está siendo resumida. 
212    </p>
213    <p>
214      <b>Atributos:</b>
215    </p>
216    <dl>
217      <dt>
218        <code>interval</code> (opcional)
219      </dt>
220      <dd>
221        Es el intervalo de tiempo absoluto (en minutos) que debe 
>de transcurrir entre las actualizaciones. 
222      </dd>
223    </dl>
224    <p>
225      <b>Child Elements:</b>
226    </p>
227    <dl>
228      <dt>
229        <code><a href="#The_.3Ccondition.3E_element">&lt;conditio
>n&gt;</a></code> (opcional) 
230      </dt>
231      <dd>
232        Una expresión XPath booleana junto con el intervalo de ti
>empo (en minutos) que debe de transcurrir entre las actualizacion 
>es si la expresión se evalua a true. 
233      </dd>
234    </dl>
235    <p>
236      El atributo <code>interval</code> define un intervalo absol
>uto en minutos. Su valor debe de ser un número mayor o igual que  
>1. Los valores decimales (p.e.: 5.5 minutos) están permitidos aun 
>que probablemente no sean útiles. 
237    </p>
238    <p>
239      El elemento <code>&lt;update&gt;</code> puede contener cual
>quier número de elementos hijos <code>&lt;condition&gt;</code>. 
240    </p>
241    <p>
242      Firefox determina qué intervalo aplicar a un microrresumen 
>generado por un generador de acuerdo a las siguiente reglas: 
243    </p>
244    <ol>
245      <li>Firefox procesa cada elemento hijo <code>&lt;condition&
>gt;</code> en el orden en el que aparecen en el documento. Para c 
>ada uno, Firefox evalúa la expresión XPath booleana del elemento  
>contra la página que va a ser resumida. Si la expresión se evalúa 
> a <code>true</code>, Firefox aplicará el intervalo de ese elemen 
>to y detendrá el procesado de los elementos hijos. Así, la primer 
>a <code>&lt;condition&gt;</code> que coincida determinará el inte 
>rvalo de actualización. 
246      </li>
247    </ol>
248    <ol>
249      <li>Si no hay elementos hijos <code>&lt;condition&gt;</code
>> o si ninguna de sus expresiones se evalúa a <code>true</code>,  
>Firefox aplicará el valor del atributo <code>interval</code> del  
>elemento <code>&lt;update&gt;</code>. 
250      </li>
251    </ol>
252    <ol>
253      <li>Si el elemento <code>&lt;update&gt;</code> no incluye u
>n atributo <code>interval</code>, Firefox aplicará el intervalo e 
>specificado por la entrada browser.microsummary.updateInterval en 
> las preferencias. 
254      </li>
255    </ol>
256    <ol>
257      <li>Si esa entrada no ha sido establecida, Firefox aplicará
> su intervalo de actualización por defecto, el cual dura 30 minut 
>os. 
258      </li>
259    </ol>
260    <p>
261      <b>Notas:</b>
262    </p>
263    <ul>
264      <li>Independientemente del intervalo absoluto o condicional
> de actualización especificado por este elemento, Firefox nunca a 
>ctualizará los microrresúmenes con una frecuencia superior a un m 
>inuto. 
265      </li>
266      <li>Dado que Firefox comprueba los microrresúmenes caducado
>s cada 15 segundos, es posible que la actualización de un microrr 
>esumen comience hasta 15 segundos después de lo que indica su int 
>ervalo. 
267      </li>
268      <li>Firefox respeta la caché del navegador cuando actualiza
> los microrresúmenes por lo que no recargará una página para actu 
>alizar su microrresumen si la caché contiene una copia reciente d 
>e la página. 
269      </li>
270    </ul>
271    <h2 id="El_elemento_.3Ccondition.3E" name="El_elemento_.3Ccon
>dition.3E"> 
272      El elemento <code>&lt;condition&gt;</code>
273    </h2>
274    <p>
275      El elemento opcional <code>&lt;condition&gt;</code> especif
>ica una expresión XPath booleana junto con un intervalo de tiempo 
> condicional (en minutos) que debe de transcurrir entre las actua 
>lizaciones si la expresión se evalúa a true cuando se evalúa cont 
>ra la página que va a ser resumida. Debe de ser hijo del elemento 
> <code>&lt;update&gt;</code>. 
276    </p>
277    <p>
278      <b>Atributos:</b>
279    </p>
280    <dl>
281      <dt>
282        <code>expression</code> (requerido)
283      </dt>
284      <dd>
285        Una expresión XPath booleana para ser evaluada contra la 
>página que va a ser resumida. 
286      </dd>
287      <dt>
288        <code>interval</code> (requerido)
289      </dt>
290      <dd>
291        Un intervalo de tiempo, en minutos, que debe de transcurr
>ir entre las actualizaciones si la expresión se evalúa a <code>tr 
>ue</code>. 
292      </dd>
293    </dl>
294    <p>
295      <b>Elementos hijos:</b>
296    </p>
297    <p>
298      <i>Ninguno.</i>
299    </p>
300    <p>
301      Para más información acerca del uso de este elemento, véase
> la entrada para <a href="#The_.3Cupdate.3E_element">#The_&lt;upd 
>ate&gt;_element</a>. 
302    </p>
303    <h2 id="Ver_tambi.C3.A9n" name="Ver_tambi.C3.A9n">
304      Ver también
305    </h2>
306    <ul>
307      <li>
308        <a href="es/Crear_un_microrresumen">Crear un microrresume
>n</a> 
309      </li>
310      <li>
311        <a href="es/XSLT">XSLT</a>
312      </li>
313    </ul>

Volver al historial