Usuário:BraunOBruno/WebRef
Esta documentação foi traduzida na íntegra de en:User:V111P/js/WebRef. Frases em primeira pessoa não representam BraunOBruno, e sim o redator original.
WebRef é um script que automatiza o preenchimento da predefinição {{citar web}}. Você usa o script na página que deseja citar. Um formulário será exibido no topo dessa página com uma caixa de texto contendo o modelo de citação pré-preenchido. Você deve revisar os valores pré-preenchidos e preencher os que faltam e então pressionar o botão "Compactar e Copiar".
Nem todas as informações podem ser preenchidas automaticamente em todos os sites, mas é fácil arrastar ou copiar e colar as informações da página quando o formulário com a predefinição de citação estiver na mesma página.
Em alguns sites, para que o script possa preencher todas as informações (inclusive o nome do autor e a data do artigo), é necessário configurar o script para que ele saiba onde encontrar essas informações. Para fazer isso, pressione o botão "Configuração do site" e siga as instruções.
O script pode ser usado como um bookmarklet com o seguinte endereço:
javascript:(function(){var d=document,s=d.createElement('script');s.src='//pt.wikipedia.org/w/index.php?title=Usuário:BraunOBruno/WebRef.js&action=raw&ctype=text/javascript&smaxage=43200&maxage=86400';d.body.appendChild(s);})();
Para testar o script, usando um computador desktop/laptop, basta executar o código-fonte (ou o código acima, após remover a parte javascript:) no console JavaScript do seu navegador (que na maioria dos navegadores pode ser aberto pressionando a tecla F12). Certifique-se de estar em uma página com (apenas um) artigo, por exemplo, em um site de notícias.
Como criar o bookmarklet
editarDepende do seu navegador.
- No Firefox, clique em qualquer favorito no menu de favoritos.(Será mais conveniente se você ativar a barra de favoritos em Favoritos/Mostrar barra de favoritos e criar o bookmarklet lá) Selecione Novo favorito, insira um nome (por exemplo WebRef) no campo Nome, insira o script fornecido acima em o campo de endereço (URL).
- No Internet Explorer você pode criar um favorito de qualquer página da maneira usual (Adicionar aos favoritos), clicar com o botão direito no menu de favoritos, escolher Propriedades, inserir o JavaScript fornecido acima no campo URL, alterar o nome (no Seção geral) para WebRef .
- No Google Chrome e Opera (Windows e Linux) - pressione Ctrl+D e depois o botão Editar (para Chrome) ou Propriedades (para Opera), e altere o nome para WebRef e endereço para o script acima.
- No Google Chrome (Mac) – pressione Cmd-D e depois o botão Mais, e altere o nome para WebRef e endereço para o script acima.
Há um segundo conjunto de instruções mais abaixo, caso você tenha problemas com elas.
Citação
editarSe você selecionar o texto na página antes de ativar o bookmarklet WebRef, o texto selecionado será usado para o parâmetro de citação na predefinição Citar web. No Firefox, você pode selecionar vários intervalos de texto (mantendo pressionada a tecla Ctrl); eles serão unidos por [...] pelo script.
Salvando as configurações dos sites
editarPara que o script possa preencher todas as informações (inclusive o nome do autor e a data do artigo) na maioria dos sites, você precisa pressionar o botão Configuração do site e seguir as instruções para ajudar o script a determinar onde encontrar essas informações. (Por favor, informe-me se você não entender as instruções).
Depois de configurar o script para o site em que o está usando, você tem a opção de salvar as configurações no armazenamento local (isso não funciona com navegadores antigos, pois eles não têm armazenamento local). Infelizmente, esse não é o melhor lugar para armazenar as configurações, pois elas podem ser excluídas de lá por um script do site ou quando você excluir seu histórico de navegação/cookies/etc. das configurações do navegador. Além disso, você não poderá usá-las com outro navegador e em outros computadores.
Uma maneira melhor é salvá-los em uma subpágina da sua página de usuário da Wikipédia (use um nome de página com .js no final por motivos de segurança), faça com que essa página chame o WebRef e, em seguida, use o URL da sua página no código do bookmarklet. Aqui está um exemplo de como sua página deve se parecer: WebRefCfg.js.
O novo código do bookmarklet, neste caso, seria:
javascript:(function(){var d=document,s=d.createElement('script');s.src='//pt.wikipedia.org/w/index.php?title=Usuário:BraunOBruno/WebRefCfg.js&action=raw&ctype=text/javascript%27;%20%20%20%20%20d.body.appendChild(s);%20})();
Seria melhor se todos os wikipedistas pudessem compartilhar as configurações de seus sites, mas não é provável que isso seja possível tão cedo. Uma wiki especial ou outro tipo de site pode ser criado para essa finalidade, mas ela também deve ser capaz de lidar com o vandalismo.
Palavras ou caracteres extras nos valores
editarSe palavras ou caracteres extras aparecerem nos valores dos parâmetros ao usar o script em algum site, você poderá removê-los manualmente todas as vezes. Ou você pode fazer com que o script os remova automaticamente, alterando manualmente o código do site (o código fornecido na página Site Setup). Aqui está um exemplo: Nos artigos da BBC, o autor é indicado em uma linha abaixo do título e o nome é precedido pela palavra By . Para remover este By, modifique o valor do parâmetro autor no código do site da BBC, que normalmente é span.byline-name adicionando ^^By no final: span.byline-name^^By (na verdade, apenas y em vez disso de By também funcionará - tudo antes da primeira ocorrência da palavra após o primeiro ^^ será removido automaticamente). Se houver caracteres que você deseja remover do final também (aqui como exemplo - um ponto de exclamação), adicione outro ^^ e os caracteres: span.byline-name^^By^^! . Se você quiser remover caracteres somente do final, use ^^^^ (ou seja, deixe vazio o espaço para os caracteres a serem omitidos do início). Não há necessidade de incluir espaços no início ou no final das palavras após ^^.
A ressalva é que essas palavras, depois de ^^, podem ser expressões regulares. O que isso significa é usar os caracteres \ . ? * + | ^ $ ( ) [ ] { } você precisa anexá-los com \ . Caso contrário, eles terão significados especiais. Um ponto final para exemplos significa "qualquer caractere". Um exemplo: queremos remover tudo após o primeiro ponto: span.byline-name^^^^\. - aqui usamos \ para escapar do significado do caractere especial do período.
Como criar o bookmarklet – instruções super fáceis!
editar Na verdade, isso é muito fácil de configurar. Eu presto suporte de informática para amigos e familiares, portanto, vamos primeiro nos livrar de todo o jargão: para todos os efeitos, um bookmarklet nada mais é do que um favorito com instruções especiais - nesse caso, um JavaScript colocado no lugar onde você normalmente tem o URL.
Isso é o que você precisa fazer:
- No seu segundo navegador favorito, aquele que você não usa muito para editar a Wikipédia, acesse https://pt.wikipedia.org/wiki/Usário:BraunOBruno/WebRef
- No seu navegador favorito, abra qualquer página da web que você ainda não adicionou aos favoritos. Crie um favorito– coloquei o meu na barra de favoritos para facilitar o acesso.
- Clique com o botão direito no novo favorito e no FireFox vá para Propriedades, no Chrome ou Opera para Editar. Você verá que a primeira linha é intitulada Nome e contém o nome da página da web que você acabou de adicionar aos favoritos. Substitua o nome da página web pelo que fizer sentido para você, chamei meu favorito de Wiki WebRef .
- A segunda linha é chamada de Endereço ou URL, dependendo do seu navegador. Exclua o URL que está nele para que você tenha uma linha em branco. Vá para o outro navegador e copie todo o texto na caixa verde . Em seguida, volte ao seu navegador principal e cole-o na linha Local ou URL do favorito. Vai parecer que não vai caber, mas cabe.
- Clique em Salvar e pronto!
Para usar o WebRef, clique no favorito do WebRef quando estiver na página que deseja citar. O favorito especial WebRef não o leva para outra página, ele executa o JavaScript no favorito e abre uma caixa de texto com a predefinição Citar Web.
Se o WebRef não incluir o nome do autor, clique no botão "Autores" e digite o(s) nome(s) exatamente como aparece(m) na página da Web. "Maria Silva" será convertido automaticamente para "último = Silva | primeiro = Maria".
Certifique-se de verificar as datas, pois o WebRef nem sempre identifica a data de publicação correta, mesmo quando ela é mostrada na página da web.
Obrigado, V111P, por nos oferecer uma maneira tão fácil de usar para criar referências! Se você ainda tiver problemas para configurar isso - e depois de ler as dicas de solução de problemas abaixo -, ficarei feliz em ajudar. Se você instalou o WebRef depois de ler meu guia, gostaria de saber sua opinião.
Solução de problemas
editar Se você tiver problemas para fazer o WebRef funcionar, primeiro acesse um site que é conhecido por ser fácil de usar com o WebRef, o New York Times https://www.nytimes.com. Clique em um artigo de notícias na página principal e, em seguida, clique em seu favorito WebRef.
Se a caixa de texto não aparecer:
- Certifique-se de não bloquear o JavaScript nas configurações do seu navegador.
- Se você usar extensões de navegador que bloqueiam JavaScript, como NoScript ou ScriptSafe, desative-as temporariamente e recarregue a página.
- Bloqueadores de anúncios como Adblock, Adblock Plus ou uBlock Origin podem estar bloqueando JavaScript, então pode ser necessário desativá-los temporariamente e recarregar a página .
- Pause a extensão do navegador Ghostery se você a usar, porque ela interfere e recarregue a página.
Às vezes você precisa recarregar a página da web duas vezes após desligar as extensões. Boa sorte!