See the first blog post here for more info.
First up, get the code:
% git clone firstname.lastname@example.org:sivy/veloci-wiki.git
If you prefer, fork the project first, then create a local clone.
If you don't already have a repository on Github that you want to use for your NV wiki, create a new respository (Github has excellent help if you need it) and create the wiki for the repo by going to "Wiki" and clicking "Create Wiki"
After you have your wiki, click the "Git Access" button on the wiki home page and copy the git URL, which will look something like:
Clone the wiki repo somewhere on your local drive and write down or copy the path:
% git clone email@example.com:<you>/<some-repo>.wiki.git % cd <some-repo>.wiki; pwd | pbcopy
In the cloned veloci-wiki repo, run:
% perl setup.pl <path to your wiki checkout>
You should see something like:
% perl setup.pl /Users/you/tmp/veloci-wiki.wiki Setting up veloci-wiki... Watching: /Users/you/tmp/veloci-wiki.wiki Creating launchd plist for watcher at: /Users/you/Library/LaunchAgents/local.you.veloci-wiki-update.plist Restarting launchd...
You can ignore any warnings like:
% launchctl: Error unloading: <some file>
Notational Velocity Setup
You are using it, or downloaded it, right?
Launch NV if it's not running. Open the Preferences and click on "Notes". Next to "Read notes from folder", pick "Other..." from the drop down and select the directory into which you cloned your wiki.
Then, click on "Storage" and change your settings to use "Plain Text Files" (in nvalt, a fork of Notational Velocity, I use the "Zettelkasten (Markup text Files)" setting, but it works either way):
Finally, to make sure that NV creates markdown (
.md) files by default, select (or create an entry for) ".md" in the list of file extensions and then click the checkmark icon below the list. This sets
.md as the default extension for files (Github only recognizes
.md files as wiki pages).
Now, after making a change in Notational Velocity, you should see your page appear on your Github wiki under "Pages". If you have Growl installed, the update script will find it and report: