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, que se describen aquí.
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 está incluido en línea.
De lo contrario, se incluye en línea un documento codificado en base64 del tipo de medio indicado.
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.
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>
Verifique la especificación completa para atom 1.0 RFC4287 .
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.