Google Custom Search limits - Pesquisa personalizada da Google tem limites diários

De mecanismo livre para pesquisa, a Google está começando a impor limites aos seus usuários.

Ao longo do tempo ela vem criando APIs, ou seja, serviços dedicados a determinados campos do conteúdo virtual.

O caso das pesquisas personalizadas (Custom Searches) é algo útil para quem faz pesquisas em um grupo limitado de sites (pois a proliferação absurda do número de sites e de artigos vem se tornando um empecilho perigoso para os leigos) a toda hora.

Ai você vai utilizando e descobre que depois de 100 (cem) pesquisas deste tipo, tem que pagar um valor para a Google. Absurdo. Que história é essa ? Se o Google se tornou uma biblioteca pública, e nós já pagamos os domínios e os provedores, vamos pagar pro Google por quê ? Nós, os internautas, construímos a Google. Se ele se tornou o que é hoje, foi graças a nós.

Parece que teremos, num futuro bem próximo, migrar para outras ferramentas de pesquisa, como Bing da Microsoft, Yahoo, Ask, etc. Ou então, a comunidade livre terá que tomar a frente e fazer um novo, com base na experiência dos já existentes.

Hoje, ao pesquisar um assunto sério, encontramos páginas desde aquelas feitas por pirralhos de 12 anos, até as produzidas seriamente por verdadeiros PhD's.

Os critérios para se filtrar o que é realmente é bom estão mais ou menos descritos no artigo:

Como é um texto bem escrito.

Conclusão

Se não forem tomadas providências, em algum tempo o Google começará a restringir o número de resultados a duas páginas, ou cobrar para mostrar resultados de sites de universidades, ou outros critérios espúrios.

Divulgue este artigo, pois O CONHECIMENTO É LIVRE.

Estrutura básica de uma extensão XUL para o Mozilla Firefox

As extensões Firefox são uma forma de se publicar aplicativos cliente para navegadores.

As extensões do Chrome tem muitas limitações, devido às políticas de proteção e de contabilização do Google. Portanto, se for fazer extensões, faça para Firefox.

Estrutura de diretórios

As extensões apresentam a seguinte estrutura de diretório dentro do Windows:

Função dos diretórios

content - Armazena os arquivos XUL de extensão, bem como bibliotecas JAR e Javascript a que estes arquivos XUL façam referência;
locale - Armazena as constantes, nomes de labels e outros parâmetros que dependem da língua na qual a extensão será utilizada;
skin - Armazena as folhas de estilo (CSS) a serem intercambiadas para adaptação da interface da extensão.

Função dos arquivos

content/Hello.xul - Arquivo funcional principal da extensão. Poderia ter outro nome, mas precisa, obrigatoriamente, levar a extensão XUL;
chrome.manifest - Os desenvolvedores convencionaram chamar este tipo de arquivo de "manifesto", ou seja, a "placa" de referências dos caminhos onde estão os principais arquivos da aplicação. A origem de tal terminologia remonta aos programadores Java;
install.rdf - Contém informações básicas para registro da extensão no Firefox, como nome do projeto da extensão e informações de versão pouco importantes para o funcionamento, mas muito importantes para o controle da evolução da extensão.

Explicação detalhada dos conteúdos

install.rdf

<?xml version="1.0"?>

<RDF xmlns="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
  xmlns:em="http://www.mozilla.org/2004/em-rdf#">

  <Description about="urn:mozilla:install-manifest">
    <em:id>hello@meyer.com</em:id>
    <em:name>XUL Hello</em:name>
    <em:description>Welcome to XUL!</em:description>
    <em:version>0.1</em:version>
    <em:creator>Meyer</em:creator>
    <em:homepageURL>https://www.dvelopment.com.br</em:homepageURL>
    <em:type>2</em:type>

    <!-- Mozilla Firefox -->
    <em:targetApplication>
      <Description>
        <em:id>{ec8030f7-c20a-464f-9b0e-13a3a9e97384}</em:id>
        <em:minVersion>4.0</em:minVersion>
        <em:maxVersion>10.*</em:maxVersion>
      </Description>
    </em:targetApplication>
  </Description>
</RDF>

Como o leitor mesmo pode ver, não existem informações que possam influir no funcionamento da extensão. As mais importantes para o controle do projeto estão destacadas em vermelho. O código em fonte azul corresponde ao Firefox, e NÃO PODE SER ALTERADO.

chrome.manifest

Apesar de levar o nome chrome, este arquivo não carrega em si nenhuma compatibilidade com o navegador deste nome.

content hello content/

Apenas esta linha é necessária em nosso exemplo mínimo de extensão Firefox. Ela associa o "content" (conteúdo) ao caminho content/ do diretório que contém a nossa extensão, a partir da sua raiz.

content/Hello.xul

Este é o nome de um dos arquivos XUL utilizados em nossa extensão e, no nosso caso, o único.

<?xml version="1.0"?>
<?xml-stylesheet href="chrome://global/skin/" type="text/css"?>

<window
id="findfile-window"
title="Find Files"
orient="horizontal"
xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">
<!-- Other elements go here --> 
<label value="This is some text"/>
</window>

Nesta estrutura de código, as tags Windows delimitam o mesmo objeto Windows que conhecemos do DOM (Document Object Model) do HTML.

Empacotamento da extensão

A extensão precisa ser compactada em arquivo ZIP (marque os diretórios e arquivos do mesmo nível que o diretório content) e sua extensão precisa ser alterada para XPI. Proceda a estas ações. Se não possuir um compactador, instale o 7zip, ou Windows RAR.

Instalação da extensão

Uma vez que você tenha compactado e renomeado o pacote de arquivos da extensão, execute o Firefox. Acione o menu à direita do navegador, e escolha a opção "Complementos".

Na tela seguinte, clique sobre a engrenagem mais à direita da tela.

Escolha a opção de instalação.

Será exibido o diálogo de arquivos do Explorer, e você deverá achar o diretório onde colocou o pacote renomeado para a extensão XPI.

Serão exibidas as mensagens de confirmação.

O Firefox vai avisar que você está tentando instalar um complemento não assinado. Mesmo assim, clique no botão "Instalar".

Se ele se recusar, assim mesmo, acione a configuração do Firefox (about:config).

Clique em "Serei Cuidadoso". Depois localize a chave "xpinstall".

Altere o valor desta opção para false, desta forma o Firefox vai desprezar esta segurança de assinaturas.

Em seguida ao instalar, conforme vinhamos em nosso roteiro, será dado um aviso, para reiniciar o Firefox.

Faça isso.

Teste da extensão

Lembre-se sempre que o teste e a execução desta extensão SÓ PODE SER FEITO NO NAVEGADOR FIREFOX. Muita gente se esquece disso, e perde tempo precioso, achando que fez algo errado, experimentando a extensão em outro navegador.

Digite o seguinte caminho no navegador Firefox:

chrome://hello/content/Hello.xul

e veja o resultado de todo o nosso esforço:

De onde veio esta frase que aparece no navegador ?

A frase veio da tag Label, colocada no arquivo Hello.xul:

E as tags Window delimitam o objeto que define a janela do navegador.

Como funciona o jQuery - O que ele é - Hacking jQuery - II

Nesta continuação de "Hacking jQuery", vamos modificar a classe jQuery mínima para admitir o reuso de métodos:

tQuery.js

(function( window, undefined ) {

var
// Referência à raiz jQuery(document)
rootjQuery,

// Usa o documento correto de acordo com a chamada (sandbox)
document = window.document,
location = window.location,
core_version = "a.0.0",
init_selector,
jQuery = function( selector, context ) {
// O objeto jQuery é realmente o construtor init 'melhorado'
return new jQuery.fn.init( selector, context, rootjQuery );
}
jQuery.fn = jQuery.prototype = {
// Versão corrente do jQuery
jquery: core_version,

constructor: jQuery,
init: function( selector, context, rootjQuery ) {
var match, elem;
init_selector = selector;
// Manipula: $(""), $(null), $(undefined), $(false)
if ( !selector ) {
return this;
}
},
size: function() {
if( typeof(this) == 'object' ){
var len = 0;
for (var o in this) {
len++;
}
}
this.context = document;
this.size = len; 
return this; 
},
version: function() {
this.versao = this.jquery;
return this;
}
}

window.jQuery = window.$ = jQuery;
jQuery.fn.init.prototype = jQuery.fn;
rootjQuery = jQuery(document);

})( window );

Agora vamos executar o arquivo HTML alterado:

rtQuery.html

<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1" />

<title>jQuery Demo</title>

<script type="text/javascript" src="tQuery.js"></script>

</head>
<body id="b1" name="nb1" OnLoad="inicia();">
<p id="p1" name="np1">xxx xxx xxx</p>
</body>
<script>
function inicia(){
var a = $("#p1").version().size();
}
</script>
</html>

Vamos exibir apenas a fase de debug ao chegar no método "version":

Como "version" devolve "this", que é um ponteiro para a instância jQuery, quando o método "size" é invocado ...

e processado ...

o erro não mais ocorre.

No entanto, existe um erro de concepção. O método "size" deveria ser método de "version", portanto deveria estar dentro da sua definição. Fizemos esta "gambiarra" apenas para mostrar a concepção que possibilita métodos chamarem métodos dentro do objeto jQuery.

Como funciona o jQuery - O que ele é - Hacking jQuery - I

Para explicar o que é, e como funciona o jQuery, reproduzimos aqui um código mínimo do mínimo, com o essencial do essencial para melhor compreendê-lo:

tQuery.js

(function( window, undefined ) {

var

      // Referência à raiz jQuery(document)

      rootjQuery,

     // Usa o documento correto de acordo com a chamada (sandbox)

     document = window.document,

location = window.location,

core_version = "a.0.0",

jQuery = function( selector, context ) {

     // O objeto jQuery é realmente o construtor init 'melhorado'

     return new jQuery.fn.init( selector, context, rootjQuery );

     }

jQuery.fn = jQuery.prototype = {

     // Versão corrente do jQuery

     jquery: core_version,

     constructor: jQuery,

     init: function( selector, context, rootjQuery ) {

         var match, elem;

          // Manipula: $(""), $(null), $(undefined), $(false)

          if ( !selector ) {

               return this;

               }

      },

      size: function() {

      return this.length;

      },

      version: function() {

         return this.jquery;

         }

   }

   window.jQuery = window.$ = jQuery;

   jQuery.fn.init.prototype = jQuery.fn;

})( window );

E o código HTML que chama este objeto (porque realmente é um objeto).

rtQuery.html

<!DOCTYPE html>

    <html>

        <head>

            <meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1" />

            <title>jQuery Demo</title>

                <script type="text/javascript" src="tQuery.js"></script>

       </head>

       <body id="b1" name="nb1" OnLoad="inicia();">

             <p id="p1" name="np1">xxx xxx xxx</p>

       </body>

       <script>

              function inicia(){

                  var a = $("#p1").version();

                   }

       </script>

</html>

Explicação:

Definimos um breakpoint na linha da instrução da função inicia (var a = $("#p1").version()):

Instanciação da classe jQuery no interior do arquivo tQuery.js

Ao utilizarmos a diiretiva "new", criamos uma nova instância do objeto jQuery.

A classe jQuery tem um protótipo para as funções (fn)

O protótipo da classe possui um construtor (constructor) e seus métodos: init, size e version (em nosso caso reduzido para melhor compreensão).

Como o método chamado foi "init", foi nele que o debug entrou, com o parâmetro "selector" tendo carregado o valor "#p1". O teste "! selector" devolve verdadeiro se nenhum seletor tiver sido fornecido. Como existe um seletor fornecido ("#p1"), 

o processamento pula para a segunda chave, se preparando para retornar. E o retorno se dá na linha posterior ao método "init":

 

O retorno posterior se dará de volta ao html (rtQuery.html):

E como mágica, o processamento avança para o método após o ponto (".") do seletor, ao invés de avançar para a linha 17.

Desta vez, não há nova instanciação da classe jQuery. O método "init", que é uma abstração da classe jQuery, se confunde com ele mesmo, devolvendo a própria instância obtida nos passos anteriores (this). E o processamento vai direto ao método "version" chamado.

E no passo seguinte, o processamento vai para a chave que fecha o método "version". E desta forma,

é devolvido o valor da versão que demos ao jQuery, e o processamento avança para a chave da linha 17 no HTML que provocou a instanciação do jQuery.

É basicamente este o mecanismo e a filosofia do jQuery que utilizamos, e que "quebra tanto o nosso galho".

Uncaught TypeError: $(...). ... is not a function

Vamos demonstrar qual é a natureza dos retornos do jQuery. Vamos tentar reaproveitar métodos do jQuery após um retorno de método. Vamos acrescentar uma chamada ao método "size" na linha 16:

var a = $("#p1").version().size();

Por que este erro ocorreu ?

O método "size" é um método de jQuery. O método 'version" nos devolveu uma string (this.jquery). Quando tentamos usar o método "size" sobre uma string, obtivemos o erro. Mas o debug não avisa, por exemplo que "...version().size is not a string", e sim que "version(...).size is not a function". O debug está se referindo a "version()". O método "version", para possibilitar o reuso do objeto jQuery, deveria devolver um objeto da classe jQuery.