0.01
There's a lot of open issues
RDoc plugin to generate markdown documentation and search index as sqlite database for entire content.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 2.0
~> 5.0
~> 13.0
~> 2.0

Runtime

 Project Readme

RDoc-Markdown

RDoc plugin to generate markdown documentation and search index backed by sqlite database.

Motivation

I'm trying to depend less on software with GUI, instead using software that could be used through console. Documentation in markdown format allows me to review documentation in console, instead of browser or GUI software like DevDocs.

Installation

Install gem and add to application's Gemfile by executing:

$ bundle add rdoc-markdown

If bundler is not being used to manage dependencies, install the gem by executing:

$ gem install rdoc-markdown

Examples

Find examples in /examples folder. You can regenerate examples by running ./bin/generate.sh, it will produce examples based on file in test/data/* folder.

Usage

RDoc will auto-detect rdoc-markdown plugin if it was installed. You just need to instruct RDoc to produce markdown output instead of standard HTML through format parameter.

Run following command in directory with ruby source code:

rdoc --format=markdown

This will produce a tree of markdown documents and search index in /doc folder. Every class in library will have it's own markdown file.

Development

Biggest issue is testing this locally, but that's not as hard to do these days.

gem build rdoc-markdown.gemspec
gem install <path-to>/rdoc-markdown-0.1.2.gem

or you can do the same, but through gemfile:

gem 'rdoc-markdown`, path: "../rdoc-markdown/`

Testing

Following command should run entire testsuit:

rake test

Testing is not excessive, just verifies that basic functionality is operational.

Release

gem build rdoc-markdown.gemspec
gem push rdoc-markdown-0.1.2.gem

There is ./bin/publish.sh script that does that. But it assumes, that you have gum library installed.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/skatkov/rdoc-markdown. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.

Code of Conduct

Everyone interacting in the Rdoc::Markdown project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.