Markun
Markun is Markdown bulk converter with menu link
Purpose
- Markun convert all Markdown-files to html-files with menu link.
(If you do not want to create menu link, set Markunfile's have_menu to 'false'.)
- Target is All of the '*.md'files and subdirectories.
Installation
Add this line to your application's Gemfile:
gem 'markun'
And then execute:
$ bundle
Or install it yourself as:
$ gem install markun
Structure
before convert
.
┗ Target
┠ Markunfile :dsl setting file
┠ some1.md
┠ some2.md
┗ sub
sub1.md
sub2.md
after convert
.
┗ Target
┠ Markunfile :dsl setting file
┠ some1.md
┠ some1.html
┠ some2.md
┠ some2.html
┗ sub
┠ sub1.md
┠ sub1.html
┠ sub2.md
┗ sub2.html
Usage
Before Structure
$ tree
.
┠ parent1.md
┠ parent2.md
┗ sub
┠ sub1.md
┗ sub2.md
Steps
- markun init
- confirm generated Markunfile
# encoding: utf-8
# have menu or not
# have_menu allow only String
# have_menu's default value => "false"
have_menu "false"
- edit Markunfile
# encoding: utf-8
have_menu "true"
- execute markun
$ markun execute
$ tree
┠ Markunfile
┠ parent1.html
┠ parent1.md
┠ parent2.html
┠ parent2.md
┗ sub
┠ sub1.html
┠ sub1.md
┠ sub2.html
┗ sub2.md
Result Caputure Sample
- parent1.html
- sub/sub1.html
Notes
- Markun uses kramdown gem for markdown converter.
Contributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request