Forematter is the frontmatter-aware friend for your static site.
Add this line to your application's Gemfile:
gem 'forematter'And then execute:
$ bundleOr install it yourself, if that's what you're into:
$ gem install forematterIf you're not running a Ruby version manager, you might need to use sudo gem install forematter instead. But try it without the sudo first.
Forematter makes it easy to add tags I forgot:
$ find . -name "*twitter*.md" | xargs fore add tags twitterAnd find all of my dumb:
$ find . -name "*twitter*.md" | xargs fore list tags | grep -i twTwitpocalypse
... whoops. Let's fix that:
$ fore merge tags Twitter twitter *.md
$ find . -name "*twitter*.md" | xargs fore list tags | grep -i twTwitpocalypse
Much better!
Forematter lets me automatically categorize all my blog posts, based on the tags I use:
# Grab the 10 most common tags from my blog
for c in $(fore count tags *.md | tail -10 | sort -r | awk '{print($2)}'); do
# Set the category on each article with one of these tags
fore search -l tags "$c" *.md | xargs fore set category "$c"
end
# Format categories as title case
fore cleanup category --titlecase *.md
# Automatically classify all articles which don't already have a category
fore classify category *.mdIt does a lot more, too:
fore fields content/*.md
fore rename categories tags content/*.md
fore add tags foo bar content/*.md
fore remove tags bacon content/*.md
fore merge tags foo Foo content/*.md
fore count tags content/*.md
fore search tags content/*.md
fore list tags content/*.md
fore set title 'title!' content/foo.md
fore unset title content/bar.md
fore list title content/*.md
fore touch updated_at content/baz.md
fore cleanup title --titlecase content/*.md
fore cleanup name --capitalize content/*.md
fore cleanup tags --downcase content/*.md
fore cleanup slug --url content/*.md
fore cleanup title --trim content/*.md
fore cleanup tags --sort content/*.md
fore classify category content/*.md
fore classify category --override content/*.md
fore --helpForematter tries to be a good *nix citizen. It plays nice with find and grep and awk. Mix and match with all your favorite command line tools!
Forematter isn't tied to any particular static site generator. If your files have YAML frontmatter, Forematter is the tool for you.
If you're looking for a great static site generator, go check out this list — 210 of 'em and counting!
If Forematter doesn't work with your favorite, let us know.
Forematter works by editing your site's content files. There is a nonzero chance that you'll do something you regret, and Forematter can't help you ⌘Z.
If you're not keeping things under version control, this would be a good time to start!
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent