This project adds Sibilant support to the vim editor. It handles syntax, indenting, compiling, and more.
Install from a Zipball
This is the quickest way to get things running.
Download the latest zipball from github. The latest version on github is under Download Packages (don't use the Download buttons.)
Extract the archive into
unzip -od ~/.vim vim-sibilant-HASH.zip
These steps are also used to update the plugin.
Install with Pathogen
Since this plugin has rolling versions based on git commits, using pathogen and
git is the preferred way to install. The plugin ends up contained in its own
directory and updates are just a
git pull away.
Install tpope's pathogen into
~/.vim/autoload/and add this line to your
To get the all the features of this plugin, make sure you also have a
filetype plugin indent online in there.
Create and change into
$ mkdir ~/.vim/bundle $ cd ~/.vim/bundle
Make a clone of the
$ git clone https://github.com/joefiorini/vim-sibilant.git
$ cd ~/.vim/bundle/vim-sibilant
Pull in the latest changes:
$ git pull
SibilantMake: Compile the Current File
SibilantMake command compiles the current file and parses any errors. The full signature of the command is:
:[silent] SibilantMake[!] [SIBILANT-OPTIONS]...
SibilantMake shows all compiler output and jumps to the first line
reported as an error by
Compiler output can be hidden with
Line-jumping can be turned off by adding a bang:
SibilantMake can be manually loaded for a file with:
Recompile on write
To recompile a file when it's written, add an
autocmd like this to your
au BufWritePost *.sibilant silent SibilantMake!
All of the customizations above can be used, too. This one compiles silently
and with the
-b option, but shows any errors:
au BufWritePost *.sibilant silent SibilantMake! -b | cwindow | redraw!
redraw! command is needed to fix a redrawing quirk in terminal vim, but
can removed for gVim.
Default compiler options
SibilantMake command passes any options in the
variable along to the compiler. You can use this to set default options:
let sibilant_make_options = '--bare'
Path to compiler
To change the compiler used by
sibilant_compiler to the full path of an executable or the filename of one
let sibilant_compiler = '/usr/bin/sibilant'
This option is set to
sibilant by default.
SibilantCompile: Compile Snippets of Sibilant
SibilantCompile command shows how the current file or a snippet of
:[RANGE] SibilantCompile [watch|unwatch] [vert[ical]] [WINDOW-SIZE]
SibilantCompile without a range compiles the whole file.
SibilantCompile with a range, like in visual mode, compiles the selected
snippet of Sibilant.
This scratch buffer can be quickly closed by hitting the
vert splits the SibilantCompile buffer vertically instead of horizontally:
sibilant_compile_vert variable to split the buffer vertically by
let sibilant_compile_vert = 1
The initial size of the SibilantCompile buffer can be given as a number:
Watch (live preview) mode
Watch mode is like the live Sibilant tutorial on the Sibilant homepage.
watch to start watching a buffer (
vert is also recommended):
:SibilantCompile watch vert
After making some changes in insert mode, hit escape and the Sibilant will
be recompiled. Changes made outside of insert mode don't trigger this recompile,
SibilantCompile will compile these changes without any bad effects.
To get synchronized scrolling of a Sibilant and SibilantCompile buffer, set
scrollbind on each:
unwatch to stop watching a buffer:
SibilantRun: Run some Sibilant
SibilantRun command compiles the current file or selected snippet and runs