Adds rake tomdoc to generate documentation for publishing to GitHub Pages.


Add this gem as a development dependency to your projects Gemfile or gemspec:

gem 'rake-tomdoc', group: :development do |s|
  s.add_development_dependency 'rake-tomdoc'

Create a gh-pages branch in your project. Make sure you have committed any changes and your repository contains no untracked files!

$ git checkout --orphan gh-pages
$ git rm -rf .
$ git commit --allow-empty -m "Created gh-pages branch"
$ git checkout -

Require the gem in your Rakefile:

require 'rake-tomdoc'


When you are ready to publish new documentation:

$ rake tomdoc [--trace]
$ git commit -am "Updating documentation"
$ git push origin gh-pages
$ git checkout -

Note on Patches/Pull Requests

  • Fork the project.
  • Make your feature addition or bug fix.
  • Commit, do not bump version.
  • Send me a pull request. Bonus points for topic branches.


MIT License - see LICENSE in this repo.

Tags: Documentation, Git, GitHub Pages, Ruby, RubyGems, Tomdoc