git.cworth.org Git - notmuch/blob - vim/README

   1 == notmuch vim ruby ==
   2
   3 This is a vim plug-in that provides a fully usable mail client interface,
   4 utilizing the notmuch framework, through it's ruby bindings.
   5
   6 == install ==
   7
   8 Simply run 'make install'. However, check that you have the dependencies below.
   9
  10 === vim +ruby ===
  11
  12 Make sure your vim version has ruby support: check for +ruby in 'vim --version'
  13 features.
  14
  15 === ruby bindings ===
  16
  17 Check if you are able to run the following command cleanly:
  18
  19  % ruby -e "require 'notmuch'"
  20
  21 If you don't see any errors, it means it's working and you can go to the next
  22 section.
  23
  24 If it's not, you would need to compile them. Go to the 'bindings/ruby'
  25 directory in the notmuch source tree.
  26
  27 === mail gem ===
  28
  29 Since libnotmuch library concentrates on things other than handling mail, we
  30 need a library to do that, and for Ruby the best library for that is called
  31 'mail'. The easiest way to install it is with ruby's gem. In most distro's the
  32 package is called 'rubygems'.
  33
  34 Once you have gem, run:
  35
  36  % gem install mail
  37
  38 In some systems gems are installed on a per-user basis by default, so make sure
  39 you are running as the same user as the one that installed them.
  40
  41 This gem is not mandatory, but it's extremely recommended.
  42
  43 == Running ==
  44
  45 Simple:
  46
  47  % gvim -c ':NotMuch'
  48
  49 Enjoy ;)
  50
  51 == More stuff ==
  52
  53 As an example to configure a key mapping to add the tag 'to-do' and archive,
  54 this is what I use:
  55
  56 let g:notmuch_rb_custom_search_maps = {
  57         \ 't':          'search_tag("+to-do -inbox")',
  58         \ }
  59
  60 let g:notmuch_rb_custom_show_maps = {
  61         \ 't':          'show_tag("+to-do -inbox")',
  62         \ }