Static Markdown pages with YAML frontmatter and inline Erb, embedded in your Rails app.
As simple as, …
app/views/pages/exorcism_tips.html.md:
---
title: 3 tips for the PERFECT exorcism
author: Beelzebub
tags:
- listicles
- devil worship
- activity ideas
---
By <%= data.author %>.
Through trial and error, I've found that the perfect exorcism
starts with a refreshing drink.
Tagged <%= render "tag_list", tags: data.tags %>:
## Devilishly good lemonade recipe
…Usage
In app/views/layouts/pages.html.erb:
<%= render_layout "application" do %>
<h1><%= data.title %></h1>
<article>
<%= yield %>
</article>
<% end %>Frontmatter is supplied as a struct like object.
Given this frontmatter:
---
author: Beelzebub
---Use ! and ? method helpers for added strictness.
data.author # => "Beelzebub"
data.author! # => "Beelzebub"
data.author? # => true
data.title # => nil
data.title! # => raises SatanicPages::Frontmatter::MissingAttributeError
data.title? # => falseInstallation
Add this line to your application's Gemfile:
$ bundle add satanic_pages
$ bundle installAdd the Concern to a regular controller:
class PagesController < ApplicationController
include SatanicPages::Controller
endAnd set up a wildcard route:
get("*page", to: "pages#show", as: :page, constraints: PagesController.constraint)