Added support for kramdown, redcarpet and custom formatters.

[antek-drzewiecki]

This pull requests add support for Kramdown, Redcarpet and custom markdown formatters.
To mark up your code, you need to configure grape-swagger with a markdown adapter.
Implementation relates to issue #138.

Feedback is appreciated.

[antek-drzewiecki]

I noticed redcarpet does not work with jruby because it's written in C. Maybe extract the redcarpet adapter in a separate gem? Or are there other work-arounds?

[dblock]

Amend with a link to this PR.

[dblock]

You should be able to exclude the tests that cannot run on JRuby programmatically, start with .gemspec as explained in http://stackoverflow.com/questions/8940271/build-a-ruby-gem-and-conditionally-specify-dependencies and put conditions around specs.

[antek-drzewiecki]

Thanks for the review, I forgot that the gemspec file is ruby too. ;) I also removed the gemfile.lock from the project since many best practices state that the lock file should not be included in ruby gems.

[dblock]

This is perfect, merging.

[dblock]

I think it would be good to add an UPGRADING document, ala Grape's and note that this is an API change.

[antek-drzewiecki]

Good idea dblock, i'll start working on it tomorrow.

[kai-breitbarth-zz]

undefined method `StandardError' for #GrapeSwagger::Markdown:0x007f40ba91e6f8 (NoMethodError)

[antek-drzewiecki]

Thank you @kai-breitbarth, spec didn't cover that very well.

[dblock]

Merged the fix.

[dblock]

@antek-drzewiecki FYI, I added RELEASING.md, it might need a mention on the bottom about announcing a new release to read UPGRADING.

[dblock]

Bump @antek-drzewiecki on UPGRADING - I was hoping to release this.

[antek-drzewiecki]

@dblockotorg. I am currently on holyday. I found a public pc I could use to
issue the upgrading document. But I found myself that github.com does not
respond or is down currently. So i'll look for a public pc tonight, maybe
github does respond so I can add a ssh key, so I can push the document.

On Wed, Aug 27, 2014 at 6:48 PM, Daniel Doubrovkine (dB.) @dblockdotorg <
notifications@github.com> wrote:

Bump @antek-drzewiecki https://github.com/Antek-drzewiecki on UPGRADING

• I was hoping to release this.

—
Reply to this email directly or view it on GitHub
https://github.com/tim-vandecasteele/grape-swagger/pull/142#issuecomment-53603587
.

[dblock]

I'd take content as a comment here if that doesn't work - happy to integrate that.

[antek-drzewiecki]

I managed to set up a pull request #147 :) I hope you find it to your liking.