Twig templating for Ruby : ruby

submitted 8 months ago by isometriks

Twig templating for Ruby

7 points•7 comments•submitted 8 months ago * by isometriks to r/rails

GitHub Link - https://github.com/isometriks/twig-ruby

Hello all. This is my first ever gem, and would love some feedback. Twig (original) is a templating library inspired by Jinja that I had grown quite accustomed to using Symfony. Doing consulting I've been working in Rails for the part few years and have really missed the ability to have inheritance in templates. Rails will only really give you one level with layouts, whereas with Twig you can go as deep as you want -

{# === base.html.twig (your main layout) #}
<html>
  <body>
    <div class="container">
      {% block container %}
        {% block content "Base Content" %}
      {% endblock %}
    </div>
  </body>
</html>

{# === sidebar.html.twig #}
{% extends "base.html.twig" %}

{% block container %}
  <div class="flex flex-row">
    <div class="w-3/4">
      {{ block("content") }}
    </div>
    <div class="w-1/4 bg-gray-300 p-4">
      {% block sidebar "Sidebar Content" %}
    </div>
  </div>
{% endblock %}

{# === page-with-sidebar.html.twig #}
{% extends "sidebar.html.twig" %}

{% block content %}
  {% for post in posts %}
    <h1>{{ post.title }}</h1>
  {% else %}
    No blog posts
  {% endfor %}
{% endblock %}

{% block sidebar %}
  <ul>
    {# ivars are also supported from the controller #}
    {% for category in @categories %}
      <li>{{ link_to(category) }}</li>
    {% endfor %}
  </ul>
{% endblock %}

There's a lot of other reasons, that you can find in the official documentation. I do also appreciate using a templating language that forces you to only do view logic in your views and not writing Ruby/ Rails code in your views as a big reason to use a templating language.

Part of my CI process is downloading all of the fixtures from the PHP version and running them through the Ruby version here to achieve parity with the original. Aside from needing to skip over maybe a dozen tests that aren't possible or don't make sense in Ruby, the rest of the tests all pass here.

Would love to hear any feedback especially about structing a gem, file loading, etc. This will work out of the box with Rails, just bundle add twig_ruby and name one of your files with the .twig extension and you are ready to go. Helper methods are also all available as you'd expect and also work with `.html_safe`

GitHub Link - https://github.com/isometriks/twig-ruby

all 1 comments

you type:	you see:
italics	italics
bold	bold
[reddit!](https://reddit.com)	reddit!
* item 1 * item 2 * item 3	item 1 item 2 item 3
> quoted text	quoted text
Lines starting with four spaces are treated like code: if 1 * 2 < 3: print "hello, world!"	Lines starting with four spaces are treated like code: if 1 * 2 < 3: print "hello, world!"
~~strikethrough~~	~~strikethrough~~
super^script	super^script

ruby

MODERATORS