Documentação do Rails

Quando se vai estudar uma nova linguagem a primeira pergunta que se vem é: “Onde encontra a documentação ?”

O Rails possui uma documentação muito boa. Logo que você instala o rails em sua máquina (alguns tutoriais de como instalar: Revista TI Digital nº 10 ou na Apostila do Curso de Rails da Caelum disponibilizada gratuitamente) pode-se estar digitando no console:

gem server

Com este código você estará iniciando um serviço no seu servidor com o provável endereço http://localhost:8808/ com todas as suas gem listadas e links para os rdocs, acesso local, e documentação online. Porém muitos podem achar a documentação um pouco cansativa devido a inexistência de busca (apenas a do próprio browser).

Para quem tiver sempre com acesso a internet temos:

• APIdock – documentação de ruby e ruby on rails
• Rails Searchable API Doc (beta)

Este último vale uma ressalva devido a possibilidade de poder baixar o código fonte. Existem outras fontes tão boas quanto as indicadas. Porém não irei comentar aqui, caso você conheça alguma, por favor, comente!

Rebuild em aplicações e sites

Hoje conversando com um um profissional de web foi me perguntado:

Caso eu tenha um site com mais de um idioma, tomando que as urls sejam iguais, como faço para que ele dentro de uma parte do site, por exemplo a página institucional, o usuário clicar para mudar o idioma como faço para retornar para a página institucional ?

Por um momento pensei rápido e logo de cara respondi:

Guardar na session a página atual e quando for modificar o idioma é só recuperar o valor.

Porém lendo o livro Ruby on Rails do Urubatan ele menciona o cabeçalho HTTP_REFERER. Após uma pesquisa no pai verifiquei que existem ferramentas que passamos todos dias que se utilizam deste cabeçalho e nem percebemos: os localizadores dos blogs. Por exemplo: ao entrar em um blog apresenta a seguinta frase: “você veio do www.google.com.br”.

Fazendo um teste no PHP para ver os dados do cabeçalho percebi a veracidade da informação. Uma solução mais refinada e com melhor desempenho.

Outras funcionalidades: retaliar links indesejáveis, exposições de mensagens, manter o usuário no site logado, etc.

Leitura(s) complementar(es):

http://php.net/manual/pt_BR/reserved.variables.server.php