w3m (Português)

From ArchWiki

Status de tradução: Esse artigo é uma tradução de w3m. Data da última tradução: 2023-08-19. Você pode ajudar a sincronizar a tradução, se houver alterações na versão em inglês.

w3m é um navegador web com uma interface textual e também um pager como o more e o less. Com o w3m é possível navegar páginas web usando um emulador de terminal.

Instalação

Instale o pacote w3m.

Uso

Veja w3m(1).

Configuração

O w3m pode ser configurado usando o menu de configurações interno ou modificando diretamente os seus ficheiros de configuração.

Algumas das opções mais avançadas não são acessíveis usando o menu interno, por isso é recomendado editar os próprios ficheiros de configuração.

Geralmente os arquivos de configuração residem em ~/.w3m.

Dicas e truques

Teclas como as do Vim

Substitua o ficheiro ~/.w3m/keymap com esta configuração custimizada.

Dicas de URL

O w3m suporta navegação à base de links como o qutebrowser, basta navegar até ao seu ficheiro de configuração e alterar a seguinte linha de display_link_number 0 para display_link_number 1.

Adicione keymap f COMMAND "RESHAPE ; LINK_BEGIN ; GOTO_LINK" e keymap F COMMAND "RESHAPE ; LINK_BEGIN ; TAB_LINK" a ~/.w3m/keymap.

Nota: Enquanto que outros navegadores suportam o uso de teclas alfanuméricas para selecionar links, o w3m está limitado a teclas exclusivamente numéricas

Usando o protocolo de imagem do kitty

Os utilizadores do emulador de terminal kitty podem optar por usar o seu próprio protocolo de gráficos[link inativo 2023-09-16 ⓘ].

Para isso basta alterar as seguintes linhas em ~/.w3m/config:

inline_img_protocol 0
imgdisplay w3mimgdisplay

para:

inline_img_protocol 4
imgdisplay kitty

Pesquisa

Pode mudar o valor de wrap_search para 1, para permitir que as pesquisas saltem para o topo do ficheiro depois de terem atingido o fundo de todas as correspondências numa página.

Pode também mudar o valor de ignorecase_search para 1 para permitir a pesquisa sem distinção entre maiúsculas e minúsculas.

Nota: Ao contrário de outros navegadores e editores de texto, o w3m não possui a opção smarcase.

Motores de pesquisa personalizados

É possível mapear teclas para lançar um script CGI que captura o input do teclado e passá-lo para um motor de pesquisa personalizado, para o fazer primeiro crie um keybind dentro de ~/.w3m/keymap para lançar o seu script:

keymap s COMMAND "SET_OPTION dictcommand=file:///cgi-bin/omnibar_google.cgi ; DICT_WORD"

E coloque omnibar_google.cgi dentro da sua diretoria ~/.w3m/cgi-bin, e dando-lhe permissão de execução.

Embora o script acima retorne resultados do Google, pode usar esses tipos de scripts para pesquisar no StackOverflow, GitHub, DuckDuckGo, Reddit e vários outros sites.

Encontrará scripts similares em GitHub.

Modo leitor ==

Algumas páginas web não funcionam bem com o w3m, seja porque usam muito javascript ou CSS para mostrar a maior parte do seu conteúdo. Muitas vezes é necessário percorrer várias páginas só para chegar ao início de um artigo.

Isto pode ser atenuado passando primeiro as páginas por um programa de modo de leitura, como o rdrview-gitAUR.

Para o fazer, adicione o seguinte a ~/.w3m/keymap:

keymap R COMMAND "READD_SHELL 'rdrview $W3M_URL -H 2> /dev/null 1> /tmp/readdable.html' ; CARREGAR /tmp/readdable.html"

Redireccionamento

O ficheiro ~/.w3m/siteconf é usado para definir algumas preferências dependendo da página web, tais como: referenciador e agente do utilizador.

Também pode ser usado para redirecionar para páginas mais leves (tanto em termos de layout como de largura de banda), alternativas mais respeitadoras em termos de privacidade.

Para além disso, também pode ser utilizado para executar determinados scripts CGI.

~/.w3m/siteconf
url m!^https?://([a-z]+\.)?twitter\.com/!
substitute_url "https://nitter.net/"

url m!^https?://([a-z]+\.)?reddit\.com/!
replace_url "https://safereddit.com/"

#url m!^https?://([a-z]+\.)?google\.com/!
#substituir_url "https://duckduckgo.com/lite/"

url m!^https?://([a-z]+\.)?imgur\.com/!
substituir_url "https://rimgo.pussthecat.org/"

url m!^https?://([a-z]+\.)?wikipedia\.com/!
replace_url "https://wl.vern.cc/"

url "https://www.youtube.com/" exato
replace_url "file:/cgi-bin/video.cgi?"
#substituir_url "https://yewtu.be/"

url "https://stackoverflow.com/" exato
replace_url "https://ao.bloatcat.tk/"

url "https://www.reuters.com/" exato
substitui "https://neuters.de/"

url "https://fandom.com/" exato
substituição_url "https://breezewiki.pussthecat.org/"

url "https://medium.com/" exato
substituição_url "https://scribe.rip/"

url "https://web.archive.org/" exato
url de substituição "https://wayback-classic.net/"

Restaurar janelas fechadas

Infelizmente, o w3m não pode reabrir separadores fechados; isto pode ser adicionado.

Dentro de ~/.w3m/keymap adicione:

keymap d COMMAND "EXTERN 'echo %s >> ~/.w3m/RestoreTab.txt' ; CLOSE_TAB"
keymap u COMMAND TAB_GOTO file:/cgi-bin/restore_tab.cgi

Depois coloque o seguinte ficheiro dentro de ~/.w3m/cgi-bin e torne-o executável.

restore_tab.cgi

Abrindo links magnéticos

magnet.cgi pode ser usado para fazer o w3m abrir automaticamente links magnéticos usando Transmission.

Impressão digital

Usando tor

Pode usar torify(1) para encaminhar o tráfego w3m através de tor.

$ torify w3m -v

Agente do utilizador e cabeçalhos

Normalmente w3m utiliza o seu próprio agente de utilizador, o que significa que os utilizadores da w3m se destacam da grande maioria dos outros.

A impressão digital pode ser reduzida usando um agente de utilizador, idioma e cabeçalho http_accept mais genéricos.

~/.w3m/config
user_agent Mozilla/5.0 (Windows NT 10.0; rev:91.0) Gecko/20100101 Firefox91.0
no_referer 1
cross_origin_referer 0
accept_language en-US,en;q=0.5
accept_encoding gzip, deflate
accept_media text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8

Desativar cookies

Para desativar os cookies, mude use_cookie para 0 em ~/.w3m/config.

Desativar a cache

Para desativar os cookies, mude no_cache para 1 em ~/.w3m/config.

Resolução de problemas

Imagens a piscar/a causar lag

Infelizmente, por vezes o w3m fica lento quando se tenta passar por uma imagem, ao ponto de o browser ficar sem resposta durante vários segundos.

Uma solução para isso é desabilitar as imagens, mas isto faz alguns sites pararem de funcionar normalmente (por exemplo, o hacker news depende de GIFs para indentação de comentários).

Uma solução mais elegante passa por criar uma tecla para ativar ou desativar as imagens, para isso adicione a seguinte linha a ~/.w3m/keymap:

keymap i COMMAND "SET_OPTION display_image=toggle ; RESHAPE"

Ver também