Vimwiki

Vimwiki

Vimwiki é uma wiki pessoal para Vim, ótima para tomar notas e organizá-las sem ter que ficar dependendo de interfaces complexas. Tudo roda em linha de comando através do Vim.

Migrar para algo mais simples acabou se tornando um caminho natural para mim depois de ter usado Notion e Obisidan e ter me cansado de ter que ficar lidando com interfaces pesadas, atualizações com coisas que eu não estava interessado em utilizar (como, por exemplo, a forçação de de barra com funcionalidades de IA do Notion de uns tempos para cá) e atalhos/comandos de teclado que não são os que normalmente uso com Vim.

Link de site oficial:

Vimwiki - A personal wiki for Vim

Atalhos do Vimwiki

Segue lista dos atalhos que tenho mais utilizado:

  • <leader> + ww
    • Com o Vim aberto, somos levados para a Wiki principal do Vimwiki
  • <leader> + wi
    • Diary index, um index com todos os diários gerados pelo Vimwiki
  • <leader> + w + <leader> + i
    • Estando dentro da Diary index, gera lista organizada com todos diários encontrados
  • <leader> + w + <leader> + w
    • Cria ou abre (se já tiver sido criado) novo diário com o nome do arquivo no formato YYYY-MM-DD (ano-mês-dia) e sendo a data atual ao momento em que você fez este comando. Também já coloca este novo arquivo na pasta diary/ que fica onde definimos a nossa pasta raiz de wiki
  • <leader> + ws
    • Alterna entre wikis diferentes se temos tivermos mais de uma configurada
  • <leader> + wd
    • Vimwiki pergunta se queremos deletar o arquivo atual que estamos visualizando, um prompt aparece na base do Vim e podemos responder com yes ou no para esta ação
  • <leader> + wr
    • Renomeia o arquivo atual que estamos visualizando. Um prompt aparece na base do Vim e podemos responder com yes ou no para esta ação, e após responder positivamente podemos definir um novo nome para o arquivo, o Vimwiki tenta atualizar todos os arquivos em que este arquivo está com link referido

<leader> é a telcla contrabarra( backslash, \) pressionada com o Vim aberto e estando no Normal mode, caso queira entender mais e/ou mudar a tecla <leader>, veja a referência e o link abaixo:

[...] Vim calls this "prefix" key the "leader". You can set your leader key to whatever you like.

-- Learn Vimscript the Hard Way

Pesquisa, funcionalidade de filtragem

Estando no Vim, com o Vimwiki aberto, podemos fazer pesquisas com o comando abaixo:

  • :VWS <pesquisa>

Comandos durante pesquisa

Durante a pesquisa é possível abrir janela da location list para ver todos os arquivos em que a busca foi encontrada.

Segue lista de comandos após uma busca ter sido feita:

  • :lopen
    • Abre a lista (location list) de resultados encontrados, na lista vemos o caminho do arquivo encontrado junto com a posição em que a pesquisa foi filtrada e com a linha completa em que a palavra ou frase foi encontrada
  • :lne ou :lnext
    • Vai para a próxima ocorrência
  • :lp ou :lprevious
    • Volta para a ocorrência anterior
  • :lclose
    • Fecha a lista de resultados encontrados que foi aberta com o comando :lopen
Outras postagens
Author img

@marcmatias

Marcel Marques, programador e entusiasta do software livre. Sempre em busca de soluções inovadoras e colaborativas, com foco em desenvolvimento eficiente e acessível.