Translations of this page are also available in the following languages: Русский

Using Vim to edit gEDA wiki pages

To easy edit gEDA wiki pages in Vim you may use DokuVimKi.

You can install DokuVimKi as follows:

  1. Download the latest version of DokuVimKi and copy all its files into appropriate directories in ~/.vim:
      git clone git://github.com/chimeric/dokuvimki.git
      cd dokuvimki
      for i in doc plugin syntax; do cp "$i"/* ~/.vim/"$i"/; done 
  2. To use :h dokuvimki to open DokuVimKi help you can generate Vim help tags for it using :helptags ~/.vim/doc/ in Vim.
  3. You can optionally use another dokuwiki syntax file. I use one from http://github.com/nblock/vim-dokuwiki.git.
  4. To install DokuVimKi you need to have xmlrpclib installed on your system. It has probably been already installed as part of python installation. You can check this using:
      locate xmlrpclib 

    See https://www.dokuwiki.org/devel:xmlrpc for more information on this.

  5. You also need to install dokuwikixmlrpc. Download and install the latest version:
      git clone git://github.com/chimeric/dokuwikixmlrpc
      cd dokuwikixmlrpc
      sudo python setup.py install

    See the Python documentation for more information about installing python modules.

  6. Then to set up DokuVimKi for gEDA you need to add some strings into your ~/.vimrc file:
    let g:DokuVimKi_USER = "your_wiki_login_name"
    let g:DokuVimKi_PASS = "YOUR_WIKI_PASSWORD"
    let g:DokuVimKi_URL = "http://wiki.geda-project.org/lib/exe/xmlrpc.php"
    " Optional settings. See ':DWhelp' for details.
    ""let g:DokuVimKi_INDEX_WINWIDTH = 30
    ""let g:DokuVimKi_DEFAULT_SUM = "[xmlrpc dokuvimki edit]"
  7. To invoke Vim with DokuVimKi features available you have to use:
     vim +DokuVimKi 

    To quickly invoke this command you could add the following aliases into your ~/.bashrc file:

    # Vim aliases for gEDA
    alias vimgeda="vim +DokuVimKi"
    alias gvimgeda="gvim +DokuVimKi"

That's all. Type gvimgeda, wait a bit and enjoy the online Dokuwiki editing in Vim!