RSS - Elementos de entrada
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 universalmente. 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>complete story here</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, 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 el feed.
- self : El Feed en sí.
- 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 a 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&T bought by SBC!</title>Si type = "html" , entonces este elemento contiene la entidad de escape html.
<title type="html">
AT&amp;T bought <b>by SBC</b>!
</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&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.