Attractive Template Engine for minimalist people
Inspired by mote, Ate is a minimalist framework-agnostic template engine.
Template engines are things of all days. And this days most of them have several hundred (erb) if not thousand (erubis) of lines of code, even slim isn’t so slim. So, Ate was written with the requirements of be simple and easy to use.
Installing Ate is as simple as running:
$ gem install ate
Include Ate in your Gemfile with gem ‘ate’ or require it with require ‘ate’.
Is very similar than other template engines for Ruby as Liquid, Mote, etc:
template = Ate.parse("Hello World")
template.render #=> "Hello World"
Lines that start with % are evaluated as Ruby code.
% if true
Hi
% else
No, I won't display me
% end
As this is ruby code, you can comment as you has always done.
% # I'm a comment.
And you can still doing any ruby thing: blocks, loops, etc.
% 3.times do |i|
{{i}}
% end
To print a variable just use {{ and }}
Send a variables as a hash in the parse method to the template so it can get them:
template = Ate.parse("Hello, this is {{user}}", user: "dog")
template.render #=> "Hello, this is dog"
Also, you can send other kinds of variables:
template = <<-EOT
% items.each do |item|
{{ item }}
% end
EOT
parsed = Ate.parse(template, items: ["a", "b", "c"])
parsed.render #=> "a\nb\n\c"
You can even take advantage of do whatever operation inside the {{ }}
template = Ate.parse("The new price is: {{ price + 10 }}", price: 30)
template.render #=> "The new price is: 40"
For send a particular context to your template, use the key context and your methods and variables will be called inside of your sent context.
class User
def name
"Julio"
end
end
template = Ate.parse("Hi, I'm {{ name }}", context: User.new)
template.render #=> "Hi, I'm Julio"
In order to use Ate in a file template, use the suffix .ate, e.g. public/index.html.ate and add the path of your view in the parse method. Feel free to use any markup language as HTML.
<!-- public/index.html.ate -->
<body>
<h1>{{ main_title }}</h1>
% posts.each do |post|
<article>...</article>
% end
</body>
template = Ate.parse("public/index.html.ate", main_title: "h1 title!", posts: array_of_posts)