(instructions copied and modified from https://github.com/Kronuz/SublimeLinter)
With the Package Control plugin: The easiest way to install SublimePeek is through Package Control. Instructions to install Package Control can be found here: http://wbond.net/sublime_packages/package_control/installation
Once you install Package Control, restart ST2 and bring up the Command Palette (
Command+Shift+P on OS X,
Control+Shift+P on Linux/Windows). Select "Package Control: Install Package", wait while Package Control fetches the latest package list, then select SublimePeek when the list appears. The advantage of using this method is that Package Control will automatically keep SublimePeek up to date with the latest version.
Without Git: Download the latest source from GitHub and copy the SublimePeek folder to your Sublime Text "Packages" directory.
With Git: Clone the repository in your Sublime Text "Packages" directory:
git clone git://github.com/jlegewie/SublimePeek.git
The "Packages" directory is located at:
- OS X:
~/Library/Application Support/Sublime Text 2/Packages/
%APPDATA%/Sublime Text 2/Packages/
Python and Ruby
The python help files are generated on the fly using
pydoc for Python and
ri for Ruby so that both languages should work right away.
R and Stata
For R, you have to install the help files yourself. They are available as an additional package from Package Control (
SublimePeek-R-help) or on a separate GitHub repos at https://github.com/jlegewie/SublimePeek-R-help.
Alternatively, SublimePeek contains a help compiler, which allows you to create the help files yourself. Just look in the SublimePeek packages folder under
help-compiler for the file
R-help.r. The advantage of compiling the R help files yourself is that the SublimePeek-R-help repos only contains the help files for the base packages and ggplot2. Using the R help compiler creates the help files for all installed R packages.
The Stata help files are currently not available as a separate package but can easily be compiled using the Stata do-file
Stata-help.r in the
help-compiler folder. If people are interested in these files, I can add them as an additional ST2 package.
Just select a function, and press
super+shift+h. If the language is supported by SublimePeek, you should now see a Quick Look window with the documentation for the function. Actually, you don't have to select the function. SublimePeek automatically uses the word at the current cursor position or the word before the opening
json.lo|ad, however, does not work because the dot interrupts the word. If no help file is found, SublimePeek displays an overview of all available help files from which the user can quickly pick.
Overview of Help Files
For all languages except Python and Ruby, SublimePeek can show an overview of all available help topics based on the familiar ST2 quick select panel (the same as the command panel, or the one for jumping from project to project). SublimePeek shows the overview, if no matching help file is found for the current selection. To bring up the overview directly, just make sure that your current selection is not meaningful and you can quickly browse all help topics.
Support for Unix and Windows
Currently, the plugin only runs on Mac OS but it can be extended to work on other unix systems using gloobus-preview as well as Windows using maComfort. I personally don't have a unix or windows system but it should be pretty easy to add support. Drop me a line and we can make it work!
Support for other Languages
Adding support for other languages is easy. You either need help files that are called like the respective function (i.e. one help file for each function) or help files that are linked to the function name with a simple json database. For R, I generated these help files with a short script that iterates through all objects in all installed packages and extracts the help file for each function (see the R-help.r file in the help-compiler folder). These files should be in a format that is supported by Quick Look (Mac), gloobus-preview (Linux), and maComfort (Windows) such as html or simple text files. I am happy to provide more information when someone wants to add support for other languages.