Vim/Um wiki para o Vim
Introdução
[editar | editar código-fonte]É inegável a facilidade que um wiki nos traz, os documentos são indexados e linkados de forma simples. Já pesquisei uma porção de wikis e, para uso pessoal recomendo o potwiki.
o link do potwiki é: http://www.vim.org/scripts/script.php?script_id=1018 ou aqui
O potwiki é um wiki completo para o vim, funciona localmente embora possa ser aberto remotamente via ssh.
Para criar um link no potwiki basta usar WikiNames, são nomes iniciados com letra maiúscula e que contenham outra letra em maiúsculo no meio.
Ao baixar o arquivo salve em ~/.vim/plugin
Mais ou menos na linha 53 do potwiki ~/.vim/plugin/potwiki.vim você define onde ele guardará os arquivos, no meu caso /home/docs/textos/wiki. a linha ficou assim:
call s:default('home',"~/.wiki/HomePage")
Outra forma de indicar a página inicial seria colocar no seu .vimrc
let potwiki_home = "$HOME/.wiki/HomePage"
Como usar
[editar | editar código-fonte]O potwiki trabalha com WikiWords, ou seja, palavras iniciadas com letras em maiúsculo e que tenham outra letra em maiúsculo no meio (sem espaços) para iniciá-lo abra o vim e pressione \ww
<Leader> é igual a \ - veja :help leader \ww - abra a sua HomePage \wi - abre o Wiki index \wf - segue uma WikiWords (can be used in any buffer!) \we - edite um arquivo Wiki \\ - Fecha o arquivo <CR> - segue WikiWords embaixo do cursor <CR> é igual a Enter <Tab> - move para a próxima WikiWords <BS> - move para os WikiWords anteriores (mesma página) \wr - recarrega WikiWords
Salvamento automático para o wiki
[editar | editar código-fonte]Procure por uma seção autowrite no manual do potwiki
:help potwiki
O valor que está em zero deverá ficar em 1
call s:default('autowrite',0)
Dicas
[editar | editar código-fonte]Como eu mantenho o meu wiki oculto ".wiki" criei um link para a pasta de textos
ln -s ~/.wiki /home/sergio/docs/textos/wiki
Vez por outra entro na pasta ~/docs/textos/wiki e crio um pacote tar.gz e mando para web como forma de manter um backup.
Problemas com codificação de caracteres
[editar | editar código-fonte]Atualmente uso o Ubuntu em casa e ele já usa utf-8. Ao restaurar meu backup do wiki no Kurumin os caracteres ficaram meio estranhos, daí fiz:
1 - baixei o pacote [recode] # apt-get install recode para recodificar caracteres de utf-8 para isso faça: recode -d u8..l1 arquivo