Skip to content

Another Markdown Wiki Formatter for Redmine based on Redcarpet markdown processor.

License

Notifications You must be signed in to change notification settings

zerodeux/redmine_redcarpet_formatter

 
 

Repository files navigation

Redmine Redcarpet Markdown formatter

This is a redmine plugin for supporting Markdown as a wiki format. This plugin use Redcarpet which is GitHub's markdown wiki formatter. Redcarpet is extreme fast and compatible GitHub's Wiki. They are advantage from Redmine Markdown Formatter and Redmine Markdown Extra Formatter. This code is originally Redmine Markdown Formatter and Redmine reStructuredtext Formatter. I appreciate these guys.

What is redmine?

Redmine is a flexible project management web application. See the official site for more details.

What is Markdown?

(from http://daringfireball.net/projects/markdown/) Markdown is a text-to-HTML conversion tool for web writers. Markdown allows you to write using an easy-to-read, easy-to-write plain text format, then convert it to structurally valid XHTML (or HTML).

Prerequisites

Installation

Redmine 1.x

  1. Install Redcarpet gem. Redcarpet version should be 2.0.0b5 or later.

    $ sudo gem install --version 2.0.0b5 redcarpet

  2. Clone and checkout plugin

    $ git clone https://github.com/alminium/redmine_redcarpet_formatter.git
    $ git tag
    ...
    v1.1.1    // for Redmine 1.x
    v2.0.1    // for Redmine 2.x

v1.x.x series is for Redmine 1.x. v2.x.x series is for Redmine 2.x. Please Checkout your version. This example is for Redmine 2.x:

$ git checkout v2.0.0
  1. Copy the redmine_redcarpet_formatter directory into
  • vendor/plugins directory (for Redmine 1.x)
  • plugins/ directory (for Redmine 2.x)
  1. Restart Redmine.
  2. Installed plugins are listed on 'Admin -> Information' screen.
  3. Config Wiki engine for 'markdown' on 'Admin -> Settings -> Text formatting' screen.

Caution

source: link is broken with original redcarpet gem. Our fork resolved this problem. Install the fork:

# git clone https://github.com/alminium/redcarpet.git
# cd redcarpet
# rake install

Credits

Suggestions, Bugs, Refactoring?

Fork away and create a Github Issue. Pull requests are welcome. https://github.com/alminium/redmine_redcarpet_formatter

About

Another Markdown Wiki Formatter for Redmine based on Redcarpet markdown processor.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Ruby 54.5%
  • CSS 25.7%
  • JavaScript 19.8%