Leonardo | guia prático para o uso de feed (rss, atom)

guia prático para o uso de feed (rss, atom) - parte 2

Leonardo | 26 Fevereiro, 2006 16:42

Vocês acharam que eu havia me esquecido?? Nã nã nã nã ninha!! Promessa é dívida (quase todas!), por isto aqui estou com a segunda parte do artigo sobre "Feeds", agora explicando o lado do fornecedor de conteúdo.

É importante salientar que os "Feeds" são, em sua maioria, criados automaticamente por ferramentas incluídas em blogs, websites e afins, portanto, se você utiliza alguma ferramenta de blog a la "Blogger", "MSN Spaces", "Multiply", "Moveable Type" e outros, provalvemente este recurso já está disponível para você... prontinho, sem o menor esforço. Bastando ativá-lo em seu 'console de administrador' (ou seja lá como for chamada a interface de configuração de seu blog!) para que os "feeds" sejam automaticamente criados para você a cada vez que publicar novo conteúdo. Neste caso, você nem precisa continuar lendo se não quiser...

No entanto, caso você queira dominar, personalizar ou simplesmente ter uma noção sobre como os "feeds" funcionam, continue lendo.

Antes de seguir adiante, preciso fazer dois pequenos comentários:

a segunda parte deste artigo assume que você leu e entendeu a primeira e, provavelmente, está recebendo este post já em seu FeedReader!!
existem várias outras formas/recursos para utilizar "feeds" e o FeedReader não é mandatório! Caso esteja utilizando o Mozilla, você pode acessar seus "feeds" diretamente do web browser, ou utilizar on-line "feeds" como o FeedBurner. Pesquise internet afora e você se surpreenderá com as possibilidades!

Chega de blá, blá, blá e vamos botar as mãos na massa! O que faremos a seguir será criar, na munheca, um "feed" para o Indizível. Em seguida, você poderá portar este procedimento/arquivo para seu próprio blog/website.

Para facilitar o trabalho, ao invés de utilizarmos o "Notepad" (afinal de contas não sei se todo mundo têm os Dreamweaver's e FrontPage's da vida), usaremos o PHP Editor, que é um editor de XML gratuito (e feito por brasileiros!!) disponível no Tucows e outros sites. Antes que você tenha um 'faniquito', pode relaxar... não vamos discutir sobre XML, DTD's, Schema's... Aqui entre nós... se o seu negócio fosse estes acronismos atacados, não estaria lendo estas palavras, não é mesmo? O motivo para utilizarmos o PHP Editor é puramente visual, já que ele colore os "tags", aqueles comandinhos que vêm , automaticamente, facilitando a edição dos arquivos e evitando que você altere trechos indevidamente. Em bom Português, "naquele textinho colorido não se mexe!!!"

Na primeira parte deste artigo você aprendeu (provavelmente sempre soube) a baixar e instalar um programa da internet, portanto forneço aqui o link para download do PHP Editor. Baixe e instale o programa. Vejo você em alguns minutos!

Se você fez tudo certo, está com algo similar em sua tela após ter iniciado o PHP Editor:

Para montar nosso "feed" vamos utilizar um "feed template" que eu criei, a partir do qual faremos alterações conforme nosso interesse. Clique com o botão direito do mouse e escolha "Save Target As" ou "Save Link As" (conforme seu navegador) aqui. Tome nota da pasta onde estará salvando o arquivo de nome "exemplo_feed.rss".

Façamos alguns pequenos ajustes no PHP Editor. Em primeiro lugar, precisamos fazer com que ele reconheça e carregue arquivos com a extensão "*.rss". Para isto, clique em "Options" e escolha a opção "General".

Agora clique no tab "Files", insira o cursor no final (ou início) do campo "Files Bar" e digite a extensão que usaremos em nosso "feed", ou seja, "*.rss" (sem as áspas!), lembrando-se de separá-la das demais extensões com um ";". Em seguida, clique em "Ok".

Navegue na estrutura de pastas na janela esquerda até o local onde salvou o arquivo "exemplo_feed.rss" e dê um duplo clique sobre ele para carregá-lo.

Você logo notará uma interrogação marcada em amarelo, alertando para algo não muito desejável (pelo menos não é vermelho!!!).

Precisamos 'dizer' ao PHP Editor que se trata de um arquivo XML e não PHP/HTML, o que é bem simples. Basta clicar na setinha ao lado do ícone de quadradinhos coloridos para expandir o menu de coloração de tags e escolher XML. Voila!

Como regra básica, tenha em mente que na grande maioria das vezes editaremos apenas o texto em cor preta e que ao editarmos textos coloridos devemos ter atenção redobrada! O template que criei é quase auto-explicativo. Sugiro que antes de seguirmos adiante, você dê uma lida rápida para identificar chamadas do tipo "Insira aqui..."

Antes de qualquer alteração, porém, visando manter nosso arquivo original intacto (para que possamos retornar a ele no caso de qualquer problema) salvaremos o arquivo "exemplo_feed.rss", como apenas "feed.rss", à partir do menu "File".

Não deixe de digitar a extensão "*.rss"!

Editando o feed para incluir dados sobre o conteúdo originalmente publicado no site: Note que no canto esquerdo do arquivo as linhas são numeradas. Por enquanto, incluiremos os seguintes dados:

Linha 11: Insira o nome do site/blog
Linha 12: Insira o link para o site conforme digitado no navegador
Linha 13: Insira a descrição do site/blog
Linha 14: Insira seu nome
Linha 15: Insira a data e hora do em que o feed está sendo atualizado (z, para zulu, hora no meridiano de Greenwich ou GMT) ou da forma que você preferir
Linha 18: Insira o título do post
Linha 20: Insira o texto (ou parte) que deseja que seja visto sobre seu post. Por enquanto *não insira* imagens, apenas texto!
Linha 21: Insira a categoria ou assunto do seu post.
Linha 22: Insira a data e hora em que o post foi criado
Linho 23: Insira o nome do autor do post

Após as mudanças, salve o arquivo.

Agora vamos tratar das mudanças mais delicadas... É necessário que você saiba discernir tags HTML de tags XML, que são muito parecidas (em alguns casos idênticas!), portanto preste muita atenção no contexto em que elas aparecem. Por exemplo, no corpo de endereço web que leva diretamente ao meu post "Para Vender" no Indizível

Existem caracteres especiais em HTML que, se inseridos diretamente dentro do código XML se misturarão e o resultado será o famoso páu! Neste exemplo, o caracter especial é o "&" ("e comercial" ou ampersend, em Inglês) que precisa ser substituído pelo respectivo código HTML "&". Feito isto, termino com um novo endereço

que pode ser inserido no XML sem problemas!

Sei que esta parte é muito chatinha, mas precisa ser tratada com atenção. Além do que, se você estiver usando permalinks 'limpos' não terá estes caracteres especiais em seus links!

Linha 17: Insira o link (com carecteres HTML ajustados, se houver) direto para o post, cercado por áspas
Linha 19: Repita a operação anterior, desta vez sem usar áspas.

Salve seu arquivo e pronto!!

Para testar seu novo "feed", faça o upload do mesmo para o endereço web de sua preferência (provavelmente, seu próprio site), abra seu FeedReader e assine o novo "feed" que você acabou de criar! (Em caso de dúvidas, confira a primeira parte deste artigo).

Muito provavelmente você irá querer mais que uma chamada em seu feed e também adicionar imagens, certo?? Como fazer isto? Considerando o conhecimento que você já acumulou sobre "feeds" é bem simples!

Adicionando imagens: Tudo o que você precisa fazer é inserir o código HTML necessário para a inserção de imagens, tomando o extremo cuidado de mudar TODOS os caracteres especiais presentes para que o XML não os tome erroneamente. Isto quer dizer que até precisa virar !! Portanto o endereço web da imagem Para Vender, inserida em uma divisão com alinhamento centralizado, originalmente descrito:

Vira:

E com o parágrafo para o texto restante, fica:

Um 'pain in the ass'??? Sim e não! Sim é chato. É por estas e outras que os feeds são criados automaticamente em sua maioria! Mas você não ter este recurso à sua disposição... E nem tão chato assim se você usar um pequeno truque no PHP Editor! Sempre que precisar transformar um texto em código HTML para XML, abra um novo arquivo no PHP Editor ou clique no tab "No title 1" e aproveite o arquivo em branco que o programa já deixa aberto à sua disposição. Cole o texto que precisa ser convertido.

Pressione CTRL+F12 ou escolha a opção "View using interpreter" no menu "View" (ícone com seta verde)

Note que na porção inferior da tela, a janela "Browser" se expandirá.

Clique no tab "HTML", selecione e copie (CTRL+C) o conteúdo convertido e retorne ao arquivo "feed.rss" substituindo o código de forma apropriada

Insira o código em cor cinza acima (ou crie seu próprio código com os ajustes para do HTML para XML conforme explicado), bem no início da descrição do "feed", na linha 20 e salve o arquivo.

Faça novamente o upload do arquivo "feed.rss" e atualize seu FeedReader para checar o resultado.

Para criar novas chamadas basta marcar e copiar (CTRL+C) tudo o que estiver dentro dos tags

Colando (CTRL+V) imediatamente abaixo do tag anterior. Então, faça as mudanças de conteúdo (não se esquecendo dos caracteres especiais do código HTML para o XML) e repita a operação tantas vezes quantas forem o total de chamadas desejadas. No exemplo abaixo, inclui mais duas chamadas. Fiz o upload deste "feed" que decidi renomear para "temp_feed" só para não confudir àqueles que já tenham assinado o "feed" automático do Indizível. Aqui está o link para o "feed" temporário. Utilize-o para teste ou estudo.

Se você conseguiu chegar até aqui, meus parabéns! Espero que este artigo lhe tenha sido útil.

PS: Siga este link para acessar uma completa tabela de conversão de caracteres especiais em HTML.

Ufa, [Responder]

Cansei.

Iara | 26/02/2006, 17:20

[Responder]

Ei Navegadora,

Decidi respondê-la aqui só prá manter a "casa arrumada".

O arquivo "exemplo_feed.rss" estava com o link quebrado. Já corrigi. Me avise caso encontre mais algum problema!

Abraço,

Leonardo | 21/03/2006, 12:09

[Responder]

Ok. Estou arrumando o arquivo. Mas já tenho uma dúvida: como faço para fazer o upload do feed para o Blogger? Atualmente ele cria o feed automaticamente e não faço idéia de como enviar este que eu fiz manualmente. Responda quando puder... não tem pressa (já estou sem graça de ficar te alugando). Bjs

Navegadora | 21/03/2006, 16:06

[Responder]

Ah, quanto a manter a casa arrumada: pode apagar os comentários que eu fiz no post de hoje perguntando sobre essa confusão toda aqui... Fique a vontade pra arrumar tudo. Bjs

Navegadora | 21/03/2006, 16:08

[Responder]

Oi Navegadora, olha... não uso blogger e por isso não sei como funciona o armazenamento de informações nele. Ele permite abrir uma sessão FTP??

Bom, de qualquer forma, se o Blogger for restritivo, você pode tentar passar a perna nele fazendo o upload de seu arquivo RSS como se fosse uma imagem.

Em último caso, lembre-se que desde que o conteúdo do feed tenha os links apontando para os lugares certos, o arquivo de feed em si, pode ficar em qualquer servidor web (não é necessário que fique exatamente onde você hospeda seu blog). Portanto, qualquer serviço destes que oferece armazenagem gratuita, por menor que seja, será mais que suficiente.

Por exemplo, não sei como você acessa a internet aí em sua cidade, mas provavelmente seu provedor de acesso lhe oferece, junto de sua conta, algum espaço para armazenagem de dados. Qualquer espacinho vale! Assim você poderá testar e hospedar seu feed. Depois vc vai pro blogger e coloca um ícone de feed apontando prá onde você tiver hospedado o arquivo RSS. Voila!!

Agora... acho estranho o blogger não ter suporte nativo para RSS... tem certeza que não tem??

Leonardo | 21/03/2006, 16:28

[Responder]

Olha Leonardo. Certeza eu não tenho não... Mas na minha santa ignorância não encontrei. Vou tentar vasculhar melhor e ver se estou enganada. Mas, de todo jeito, achei sua solução alternativa muito boa. Acho que não vou ter mais problemas agora. Obrigada e bjs.

Navegadora | 22/03/2006, 07:48

[Responder]

Que ótimo, Navegadora! Agora, vc não me disse se seu RSS funcionou. Se tiver mais alguma dúvida, pode perguntar ou até mesmo me mandar seu arquivo que eu dou uma conferida e testo.

Leonardo | 22/03/2006, 10:25