Skip to content

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

Notifications You must be signed in to change notification settings

cedar101/redmine_redcarpet_formatter

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
 
 
 
 
 
 
 
 
 
 
 
 

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 tags
    ...
    v1.1.1    // for Redmine 1.x
    v2.0.0    // 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. Run rake at Redmine installed directory.
    [for Redmine 1.x]
    # RAILS_ENV=production rake db:migrate_plugins
    [for Redmine 2.x]
    # RAILS_ENV=production rake redmine:plugins:migrate
  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

Stars

Watchers

Forks

Packages

No packages published