mkmatter

If you install mkmatter Please let me know, I'd love to know the people using this!

'mkmatter' is a gem designed to make it easy to generate front matter for files and also subsequently edit them.

Note: Just like Jekyll there are minimal constraints on what is needed to build, but for mkmatter all I ask is that there is a _config.yml in your site source root, so the executable knows where it is in the filesystem.

This is needed for any part that reads from/writes to the filesystem.

Note: Thanks to @zyedidia, His project micro has been bundled alongside mkmatter. Just by using one command you can install it for your own use.

However, to use micro the way its installed using the gem, you need to have the directory in your $PATH.

Add

PATH="$HOME/bin:$HOME/.local/bin:$PATH"

then do

bundle exec micro-install

If you do install micro, it will use micro by default unless you override it with --editor=EDITOR

Add this line to your application's Gemfile:

gem 'mkmatter'

And then execute:

$ bundle install

To install to the system/user instead of a project, use the following

As root or by using sudo, run:

$ gem install mkmatter

or

$ sudo gem install mkmatter

$ gem install --user-install mkmatter

See Wiki

Tutorial: mkmatter Tutorial on IotaSpencer.me

• I am open to the idea of adding more questions/modules if there are plugins that require more configuration in the front matter. Just let me know!
  • Most layouts are accounted for via --type=CUSTOM_TYPE and then the application asking if there are custom fields you want to add Mkmatter::Questions.006_get_custom_fields

• Bug Reports
• Pull Requests

• Due to the nature of how varied the input to the application can be, mkmatter new --type=TYPE is not tested in the traditional sense, and is only tested via using --dry-run in a non-ci environment, everything else is tested, or known to work via testing of libraries themselves.

  • That is to say, if it asked its questions, and outputted the yaml via --dry-run it will more than likely create the directories/files if run without.
  • Therefore; Bugs encountered during Highline prompting inside the Mkmatter::Questions class, (most likely mkmatter new --type=TYPE), must be reproducable before being looked into.
  • Otherwise Please email me if something goes wrong, or create an issue.

  Cases

  • If YAML errors out because you put a : in a keyname, that's on you.
  • If creating a directory, creates an error, because of a syntax error, that's on you.
  • Idiot proofing is not a case for tests. Don't be an idiot and create problems for yourself. Know the syntax you are using.

• If you know a way I can test some cases, then please contact me.

The gem is available as open source under the terms of the MIT License.