RSS - Elementos de alimentación

ID de feed:

Identifica el feed mediante un URI permanente y único universalmente. Si tiene un contrato de arrendamiento renovable a largo plazo de su nombre de dominio de Internet, puede utilizar la dirección de su sitio web.

Sintaxis

<id>http://tutorialspoint.com/</id>

Necesario

Necesario.

Título del feed

Contiene un título legible por humanos para el feed. A menudo, el mismo que el título del sitio web asociado. Este valor no debe estar en blanco.

Sintaxis

<title>Tutorials and Reference Manuals</title>

Necesario

Necesario.

Fecha de actualización del feed

Indica la última vez que se modificó el Feed de manera significativa. Todas las marcas de tiempo en Atom deben cumplir con RFC 3339.

Sintaxis

<updated>2007-07-13T18:30:02Z</updated>

Necesario

Necesario.

Autor del feed

Nombra un autor del Feed. Un feed puede tener varios elementos de autor. Un feed debe contener al menos un elemento de autor, a menos que todos los elementos de entrada contengan al menos un elemento de autor.

Un elemento de autor puede tener etiquetas <name>, <email> y <uri>.

Sintaxis

<author>
   <name>Mohtashim</name>
   <email>[email protected]</email>
   <uri>http://tutorialspoint.com/</uri>
</author>

Necesario

Opcional, pero recomendado.

Enlace de alimentación

Esto identifica una página web relacionada. El tipo de relación está definido por el atributo rel . Un feed está limitado a una alternativa por tipo y hreflang . Un feed debe contener un enlace al feed en sí.

Sintaxis

<link>rel="self" href="/feed"</link>

Necesario

Opcional, pero recomendado.

Categoría de alimentación

Esto especifica una categoría a la que pertenece el Feed. Un feed puede tener varios elementos de categoría.

Sintaxis

<category>category term="sports"</category>

Necesario

Opcional.

Colaborador de feed

Esto nombra a un colaborador del Feed. Un feed puede tener varios elementos contribuyentes.

Sintaxis

<contributor>
   <name>Mohtashim</name>
</contributor>

Necesario

Opcional.

Generador de alimento

Esto identifica el software utilizado para generar el Feed, para depuración y otros fines. Tanto los atributos de uri como de versión son opcionales.

Sintaxis

<generator uri="/myblog.php" version="1.0">Example Toolkit</generator>

Necesario

Opcional.

etiqueta de icono

Esto identifica una imagen pequeña, que proporciona una identificación visual icónica para el Feed. Los iconos deben ser cuadrados.

Sintaxis

<icon>/icon.jpg</icon>

Necesario

Opcional.

etiqueta del logotipo

Esto identifica una imagen más grande, que proporciona una identificación visual para el Feed. Las imágenes deben ser dos veces más anchas que altas.

Sintaxis

<logo>/logo.jpg</logo>

Necesario

Opcional.

etiqueta de derechos

Esto transmite información sobre los derechos, por ejemplo, derechos de autor, que se encuentran en y sobre el Feed.

Sintaxis

<rights> © 2007 TutorialsPoint.com </rights>

Necesario

Opcional.

etiqueta de subtítulo

Contiene una descripción o un subtítulo legibles por humanos para el feed.

Sintaxis

<subtitle>A sub title </subtitle>

<entry> Elementos

Una fuente Atom puede contener uno o más elementos de entrada. A continuación, se muestra una lista de los elementos de feed obligatorios y opcionales.

ID de entrada

Esto identifica la entrada mediante un URI permanente y único universal. Dos entradas en un feed pueden tener el mismo valor para id si representan la misma entrada en diferentes momentos.

Sintaxis

<id>http://example.com/blog/1234</id>

Necesario

Necesario.

Título de la entrada

Contiene un título legible por humanos para la entrada. Este valor no debe estar en blanco.

Sintaxis

<title>Atom 1.0 Tutorial</title>

Necesario

Necesario.

Fecha de actualización de la entrada

Esto indica la última vez que se modificó la entrada de manera significativa. Este valor no necesita cambiar después de que se corrige un error tipográfico, solo después de una modificación sustancial. Por lo general, las distintas entradas de un feed tendrán diferentes marcas de tiempo actualizadas.

Sintaxis

<updated>2007-07-13T18:30:02-05:00</updated>

Necesario

Necesario.

Autor de entrada

Esto nombra a un autor de la entrada. Una entrada puede tener varios autores. Una entrada debe contener al menos un elemento de autor, a menos que haya un elemento de autor en el Feed adjunto, o un elemento de autor en el elemento fuente adjunto.

Sintaxis

<author>
   <name>Mohtashim</name>
</author>

Necesario

Opcional, pero recomendado.

Contenido de la entrada

Este contiene o enlaza con el contenido completo de la entrada. El contenido debe proporcionarse si no hay un enlace alternativo y debe proporcionarse si no hay un resumen.

Sintaxis

<content> historia completa aquí </content>

Necesario

Opcional, pero recomendado.

Enlace de entrada

Esto identifica una página web relacionada. El tipo de relación está definido por el atributo rel . Una entrada está limitada a una alternativa por tipo y hreflang . Una entrada debe contener un enlace alternativo si no hay ningún elemento de contenido.

Sintaxis

<link rel="alternate" href="/blog/1234"/>

Necesario

Opcional, pero recomendado.

Resumen de entrada

Esto transmite un breve resumen, resumen o extracto de la entrada. Se debe proporcionar un resumen si no se proporciona contenido para la entrada o si el contenido no está en línea.

Sintaxis

<summary>Some text.</summary>

Necesario

Opcional, pero recomendado.

Categoría de entrada

Esto especifica una categoría a la que pertenece la entrada. Una entrada puede tener varios elementos de categoría.

Sintaxis

<category term="education"/>

Necesario

Opcional.

Entrada al distribuidor

Esto nombra a un colaborador de la entrada. Una entrada puede tener varios elementos contribuyentes.

Sintaxis

<contributor>
   <name>Mohtashim</name>
</contributor>

Necesario

Opcional.

Etiqueta publicada

Contiene la hora de la creación inicial o la primera disponibilidad de la entrada.

Sintaxis

<published>2007-07-13T09:17:51-08:00</published>

Necesario

Opcional.

Fuente de entrada

Si una entrada se copia de un Feed a otro Feed, entonces los metadatos del Feed de origen (todos los elementos secundarios del Feed que no sean los elementos de entrada) deben conservarse si el feed de origen contiene alguno de los elementos secundarios autor, colaborador, derechos o categoría. y esos elementos secundarios no están presentes en la entrada de origen.

Sintaxis

<source>
   <id>http://moretutorials.org/</id>
   <title>Tutorials and Reference Manuals</title>
   <updated>2007-07-13T18:30:02Z</updated>
   <rights>© 2007 More Tutorials.</rights>
</source>

Necesario

Opcional.

Derechos de entrada

Esto transmite información sobre los derechos, por ejemplo, los derechos de autor, que se encuentran en y sobre la entrada.

Sintaxis

<rights type="html">© 2007 TutorialsPoint.com</rights>

Necesario

Opcional.

Construcciones comunes

Categoría

<category> tiene un atributo obligatorio, término y dos atributos opcionales, esquema y etiqueta .

término identifica la categoría.

esquema identifica el esquema de categorización a través de un URI.

etiqueta proporciona una etiqueta legible por humanos para su visualización.

Contenido

<content> contiene o enlaza con el contenido completo de la entrada.

En el caso más común, el atributo de tipo es texto , html , xhtml , en cuyo caso el elemento de contenido se define de manera idéntica a otras construcciones de texto.

De lo contrario, si el atributo src está presente, representa el URI de donde se puede encontrar el contenido. El atributo de tipo , si está presente, es el tipo de medio del contenido.

De lo contrario, si el atributo de tipo termina en + xml o / xml , entonces un documento xml de este tipo se incluye en línea.

De lo contrario, si el atributo de tipo comienza con texto , entonces un documento de escape de este tipo se incluye en línea.

De lo contrario, un documento codificado en base64 del tipo de medio indicado se incluye en línea.

Enlace

<link> sigue el patrón del elemento de enlace de html . Tiene un atributo obligatorio, href , y cinco atributos opcionales: rel , type , hreflang , title y length .

href es el URI del recurso referenciado (normalmente una página web).

rel contiene un tipo de relación de enlace único. Puede ser un URI completo o uno de los siguientes valores predefinidos (predeterminado = alternativo) :

  • alternativo : Una representación alternativa de la entrada o Feed, por ejemplo, un enlace permanente a la versión html de la entrada, o la página principal del weblog.
  • recinto : un recurso relacionado, que es potencialmente de gran tamaño y puede requerir un manejo especial, por ejemplo, una grabación de audio o video.
  • relacionado : un documento relacionado con la entrada o Feed.
  • self : el Feed mismo.
  • via : La fuente de la información proporcionada en la entrada.

type indica el tipo de medio del recurso.

hreflang indica el idioma del recurso referenciado.

El título indica la información legible por humanos sobre el enlace, normalmente con fines de visualización.

length indica la longitud del recurso, en bytes.

Persona

<autor> y <contribuidor> describen una persona, corporación o entidad similar. Tiene un elemento obligatorio, nombre y dos elementos opcionales: uri , correo electrónico .

<nombre> transmite un nombre legible por humanos para la persona.

<uri> contiene una página de inicio para la persona.

<email> contiene una dirección de correo electrónico de la persona.

Texto

<title> , <summary> , <content> y <rights> contienen texto legible por humanos, generalmente en pequeñas cantidades. El atributo de tipo determina cómo se codifica esta información (predeterminado = "texto").

Si type = "text" , entonces este elemento contiene texto sin formato sin entidad de escape html.

<title type="text">AT&amp;T bought by SBC!</title>

Si type = "html" , entonces este elemento contiene la entidad de escape html.

<title type="html">AT&amp;amp;T bought &lt;b&gt;by SBC&lt;/b&gt;!</title>

Si type = "xhtml" , este elemento contiene xhtml en línea, envuelto en un elemento div.

<title type="xhtml">
   <div xmlns="http://www.w3.org/1999/xhtml">
      AT&amp;T bought <b>by SBC</b>!
   </div>
</title>

Feed de ejemplo de Atom 1.0

El ejemplo muestra cómo escribir un feed con Atom 1.0.

<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">

   <title>Example Feed</title>
   <subtitle>Insert witty or insightful remark here</subtitle>
   <link href="http://example.org/"/>
   <updated>2003-12-13T18:30:02Z</updated>
   
   <author>
      <name>Mohtashim</name>
      <email>[email protected]</email>
   </author>
   
   <id>urn:uuid:60a76c80-d399-11d9-b93C-0003939e0af6</id>
   
   <entry>
      <title>Tutorial on Atom</title>
      <link href="http://example.org/2003/12/13/atom03"/>
      
      <id>urn:uuid:1225c695-cfb8-4ebb-aaaa-80da344efa6a</id>
      <updated>2003-12-13T18:30:02Z</updated>
      <summary>Some text.</summary>
   </entry>
   
</feed>

Extensión de archivo Atom1.0:

No se requiere una extensión de archivo específica para un documento Atom 1.0. Pero se recomienda .xml.

que-es-atom.htm