RSS - Elementos de entrada
Um Atom Feed pode conter um ou mais elementos de entrada. Aqui está uma lista dos elementos de feed obrigatórios e opcionais.
ID de entrada
Isso identifica a entrada usando um URI universalmente exclusivo e permanente. Duas entradas em um feed podem ter o mesmo valor para id se representarem a mesma entrada em momentos diferentes.
Sintaxe
<id>http://example.com/blog/1234</id>
Requeridos
Requeridos.
Título da Entrada
Contém um título legível por humanos para a entrada. Este valor não deve ficar em branco.
Sintaxe
<title>Atom 1.0 Tutorial</title>
Requeridos
Requeridos.
Data de atualização de entrada
Isso indica a última vez que a entrada foi modificada de maneira significativa. Este valor não precisa ser alterado após a correção de um erro de digitação, apenas após uma modificação substancial. Geralmente, entradas diferentes em um Feed terão carimbos de data / hora atualizados diferentes.
Sintaxe
<updated>2007-07-13T18:30:02-05:00</updated>
Requeridos
Requeridos.
Autor de entrada
Isso nomeia um autor da entrada. Uma entrada pode ter vários autores. Uma entrada deve conter pelo menos um elemento de autor, a menos que haja um elemento de autor no feed delimitador ou haja um elemento de autor no elemento de origem delimitado.
Sintaxe
<author>
<name>Mohtashim</name>
</author>
Requeridos
Opcional, mas recomendado.
Conteúdo de entrada
Este contém ou links para o conteúdo completo da entrada. O conteúdo deve ser fornecido se não houver um link alternativo e deve ser fornecido se não houver um resumo.
Sintaxe
<content>complete story here</content>
Requeridos
Opcional, mas recomendado.
Link de entrada
Isso identifica uma página da Web relacionada. O tipo de relação é definido pelo atributo rel . Uma entrada é limitada a uma alternativa por tipo e hreflang . Uma entrada deve conter um link alternativo se não houver nenhum elemento de conteúdo.
Sintaxe
<link rel="alternate" href="/blog/1234"/>
Requeridos
Opcional, mas recomendado.
Resumo da entrada
Isso representa um breve resumo, resumo ou trecho da entrada. O resumo deve ser fornecido se não houver conteúdo fornecido para a entrada ou se o conteúdo não estiver embutido.
Sintaxe
<summary>Some text.</summary>
Requeridos
Opcional, mas recomendado.
Categoria de entrada
Isso especifica a categoria à qual a entrada pertence. Uma entrada pode ter vários elementos de categoria.
Sintaxe
<category term="education"/>
Requeridos
Opcional.
Entrada no distribuidor
Isso nomeia um contribuidor da entrada. Uma entrada pode ter vários elementos de contribuidor.
Sintaxe
<contributor>
<name>Mohtashim</name>
</contributor>
Requeridos
Opcional.
Tag Publicado
Contém a hora da criação inicial ou a primeira disponibilidade da entrada.
Sintaxe
<published>2007-07-13T09:17:51-08:00</published>
Requeridos
Opcional.
Fonte de entrada
Se uma entrada for copiada de um Feed para outro Feed, os metadados do Feed de origem (todos os elementos filho do Feed, exceto os elementos de entrada) devem ser preservados se o Feed de origem contiver qualquer um dos elementos filho autor, contribuidor, direitos ou categoria e esses elementos filho não estão presentes na entrada de origem.
Sintaxe:
<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>
Requeridos
Opcional.
Direitos de entrada
Isso transmite informações sobre direitos, por exemplo, direitos autorais, mantidos em e sobre a inscrição.
Sintaxe
<rights type="html">© 2007 TutorialsPoint.com</rights>
Requeridos
Opcional.
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 de conteúdo é definido de forma idêntica a outras construções de texto.
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>
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.