RSS - Elementos de Feed

ID do feed:

Ele identifica o feed usando um URI universalmente exclusivo e permanente. Se você tiver um contrato de arrendamento de longo prazo renovável em seu nome de domínio da Internet, sinta-se à vontade para usar o endereço do seu site.

Sintaxe

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

Requeridos

Requeridos.

Título do feed

Ele contém um título legível por humanos para o feed. Freqüentemente, o mesmo que o título do site associado. Este valor não deve ficar em branco.

Sintaxe

<title>Tutorials and Reference Manuals</title>

Requeridos

Requeridos.

Data de atualização de feed

Indica a última vez que o Feed foi modificado de forma significativa. Todos os carimbos de data / hora no Atom devem estar em conformidade com RFC 3339.

Sintaxe

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

Requeridos

Requeridos.

Autor do feed

Ele nomeia um autor do Feed. Um feed pode ter vários elementos de autor. Um feed deve conter pelo menos um elemento de autor, a menos que todos os elementos de entrada contenham pelo menos um elemento de autor.

Um elemento de autor pode ter tags <name>, <email> e <uri>.

Sintaxe

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

Requeridos

Opcional, mas recomendado.

Link de feed

Isso identifica uma página da Web relacionada. O tipo de relação é definido pelo atributo rel . Um feed é limitado a um alternativo por tipo e hreflang . Um feed deve conter um link para o próprio feed.

Sintaxe

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

Requeridos

Opcional, mas recomendado.

Categoria de feed

Isso especifica a categoria à qual o Feed pertence. Um feed pode ter vários elementos de categoria.

Sintaxe

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

Requeridos

Opcional.

Contribuidor de Feed

Isso nomeia um contribuidor do Feed. Um feed pode ter vários elementos contribuidores.

Sintaxe

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

Requeridos

Opcional.

Gerador de alimentação

Isso identifica o software usado para gerar o Feed, para depuração e outros fins. Os atributos uri e version são opcionais.

Sintaxe

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

Requeridos

Opcional.

ícone Tag

Isso identifica uma pequena imagem, que fornece uma identificação visual icônica para o Feed. Os ícones devem ser quadrados.

Sintaxe

<icon>/icon.jpg</icon>

Requeridos

Opcional.

Tag do logotipo

Isso identifica uma imagem maior, que fornece identificação visual para o Feed. As imagens devem ter o dobro da largura do que a altura.

Sintaxe

<logo>/logo.jpg</logo>

Requeridos

Opcional.

Tag de direitos

Isso transmite informações sobre direitos, por exemplo, direitos autorais, mantidos no feed e sobre ele.

Sintaxe

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

Requeridos

Opcional.

Tag de legenda

Contém uma descrição ou legenda legível para o Feed.

Sintaxe

<subtitle>A sub title </subtitle>

Elementos <entry>

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> história completa aqui </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&amp;T bought by SBC!</title>

Se type = "html" , então este elemento contém html com escape de entidade.

<title type="html">AT&amp;amp;T bought &lt;b&gt;by SBC&lt;/b&gt;!</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&amp;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.

what-is-atom.htm