Veda

Collaborate documentation and WIKI

Veda is Git based documentation system, it aims to simplify writing documentation and text using the same methodologies as writing code. Everyone can fork and contribute documentation.

Veda is still in prerelease. But you can get a sneak peek by running:

gem install veda --pre

In case you use RBENV type rbenv rehash to make the veda command available. Then go in to a directory with markdown and type:

veda

to start the veda server. You can then browse to http://localhost:4567 to read the documentation.

You can also add it easy to pow with:

veda pow

Veda makes it easy to download and view documentation written on github.

veda install emilebosch/guides

It will clone the repo from github, install it in ~/.veda/library/emilebosch/guides.

To view a list of locally installed documentation type:

veda list

You can mount Veda also in your rails app like any other rack app. This allows you to expose your documentation fast and easy. Just put this baby in your routes.rb

mount Veda::Server.new(Rails.root.join("./docs"), Rails.root) => "/docs"

You can extend veda by placing a Vedafile in a directory. This will be loaded runtime.

You can then freedompatch Veda into awesomeness.

For instance, u can provide your own views, u can just patch the Veda::Server.

class Veda::Server
  set :root, File.dirname(__FILE__)
end

Yes, please help out and make Veda awesome! I need your mad skills to take this further.

Now, because Veda, relies on git, there is a git repo in a git repo. (GITCEPTION! OMG!) Anyway, since, i haven't found an elegant way to do this yet (Please PR one!) You need to run rake unzip to unzip the test repo.

So in short, to test:

bundle rake unzip
bundle rake

To run locally:

bundle exec veda