Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

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

This branch is even with alminium:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
app/views/settings
assets
config/locales
lib/redmine/wiki_formatting/markdown
test
Gemfile
LICENSE.txt
README.markdown
init.rb

README.markdown

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)
  2. Restart Redmine.

  3. Installed plugins are listed on 'Admin -> Information' screen.
  4. 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

Something went wrong with that request. Please try again.