Rspec Api Documentation Browser
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib
spec
.gitignore
.rspec
.travis.yml Use the most recent versions of ruby for travis May 9, 2017
.yardopts
Gemfile
Gemfile.lock
LICENSE
README.md README: Use SVG badge [ci skip] Sep 8, 2017
Rakefile Add a Rakefile Apr 24, 2012
config.ru
raddocs.gemspec

README.md

Travis status Inline Docs

Raddocs

Raddocs is a browser for JSON outputted by the rspec_api_documentation gem.

Install

Gemfile

gem 'raddocs'

config/routes.rb

  mount Raddocs::App => "/docs"

Make sure RspecApiDocumentation is generating JSON:

spec/spec_helper.rb

RspecApiDocumentation.configure do |config|
  config.format = :json
end

Configuration

config/initializers/raddocs.rb

  • api_name - Name of the API on the example index page
  • docs_dir - where the JSON output from rspec_api_documentation is located
  • docs_mime_type - if you use the middleware, what mime type are you serving your docs as, must be a regex. eg: /text\/vnd.org.oestrich.raddocs\+plain/
  • include_bootstrap - Boolean to disable including bootstrap if you are using your own css
  • external_css - Array of css files to include, with a full URL to them
  • url_prefix - Optional prefix to insert before URLs generated by Raddocs
Raddocs.configure do |config|
  config.docs_dir = "doc/api"
end

Custom CSS

You can include extra css by the config option external_css or add a directory to the docs dir named styles. Every css file in the styles dir will be included as a link element on all pages.