0.0
No commit activity in last 3 years
No release in over 3 years
rake-tomdoc
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

>= 0
~> 3.1.1
~> 0.7.1
 Project Readme

rake-tomdoc

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

Setup

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

gem 'rake-tomdoc', group: :development

Gem::Specification.new do |s|
  ...
  s.add_development_dependency 'rake-tomdoc'
end

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'

Usage

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.

Copyright

Copyright (c) 2018 Joshua Priddle. See LICENSE for details.