Construções Comuns
Categoria
<categoria> tem um atributo obrigatório, termo e dois atributos opcionais, esquema e rótulo .
termo identifica a categoria.
esquema identifica o esquema de categorização por meio de um URI.
rótulo fornece um rótulo legível para exibição.
Conteúdo
<content> contém ou se vincula ao conteúdo completo da entrada.
No caso mais comum, o atributo type é text , html , xhtml , caso em que o elemento content é definido de forma idêntica a outras construções de texto, que são descritas aqui.
Caso contrário, se o atributo src estiver presente, ele representa o URI de onde o conteúdo pode ser encontrado. O atributo type , se presente, é o tipo de mídia do conteúdo.
Caso contrário, se o atributo type terminar em + xml ou / xml , um documento xml desse tipo estará contido inline.
Caso contrário, se o atributo type começar com texto , um documento com escape desse tipo estará contido embutido.
Caso contrário, um documento codificado em base64 do tipo de mídia indicado está contido embutido.
Ligação
<link> é padronizado após o elemento de link do html . Ele tem um atributo obrigatório, href , e cinco atributos opcionais: rel , type , hreflang , title e length .
href é o URI do recurso referenciado (normalmente uma página da Web).
rel contém um único tipo de relacionamento de link. Pode ser um URI completo ou um dos seguintes valores predefinidos (padrão = alternativo) :
- alternativa : Uma representação alternativa da entrada ou Feed, por exemplo, um permalink para a versão html da entrada ou a página inicial do weblog.
- gabinete : um recurso relacionado, que é potencialmente grande em tamanho e pode exigir tratamento especial, por exemplo, uma gravação de áudio ou vídeo.
- related : um documento relacionado à entrada ou feed.
- self : o próprio feed.
- via : A fonte das informações fornecidas na entrada.
type indica o tipo de mídia do recurso.
hreflang indica o idioma do recurso referenciado.
title indica as informações legíveis por humanos sobre o link, normalmente para fins de exibição.
length indica o comprimento do recurso, em bytes.
Pessoa
<author> e <contributor> descrevem uma pessoa, corporação ou entidade semelhante. Ele tem um elemento obrigatório, nome e dois elementos opcionais: uri , email .
<name> transmite um nome legível para a pessoa.
<uri> contém uma página inicial para a pessoa.
<email> contém um endereço de e-mail da pessoa.
Texto
<title> , <summary> , <content> e <rights> contêm texto legível por humanos, geralmente em pequenas quantidades. O atributo type determina como essas informações são codificadas (default = "text").
Se type = "text" , então este elemento contém texto simples sem html com escape de entidade.
<title type="text">AT&T bought by SBC!</title>
Se type = "html" , então este elemento contém html com escape de entidade.
<title type="html">
AT&amp;T bought <b>by SBC</b>!
</title>
Se type = "xhtml" , então este elemento contém xhtml embutido, envolvido em um elemento div.
<title type="xhtml">
<div xmlns="http://www.w3.org/1999/xhtml">
AT&T bought <b>by SBC</b>!
</div>
</title>
Verifique a especificação completa para atom 1.0 RFC4287 .
Feed de exemplo Atom 1.0
O exemplo mostra como escrever um Feed usando 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>
Extensão de arquivo Atom1.0
Uma extensão de arquivo específica para um documento Atom 1.0 não é necessária. Mas .xml é recomendado.