Twig Templates

Typemill is a lightweight CMS designed for simplicity and flexibility, making it an excellent choice for content creators and developers alike. One of the core features of Typemill is its use of Twig templates, a powerful and flexible templating engine that allows developers to build dynamic and customizable themes with ease.

What is Twig?

Twig is a modern templating engine for PHP, known for its clean syntax and robust features. It allows you to create templates that are easy to read, maintain, and extend. With Twig, you can:

• Embed dynamic content into your themes.
• Create reusable templates with blocks and extends.
• Use filters and functions for powerful formatting and logic.

Here's a simple example of a Twig template:

<h1>{{ page.title }}</h1>
<p>Published on: {{ page.date|date('F j, Y') }}</p>

Why Use Twig in Typemill?

Twig templates are integral to Typemill theme development because they provide a seamless way to control the presentation of your content. Here’s what makes Twig templates ideal for Typemill:

1. Separation of Content and Presentation
   Twig ensures that your content and layout logic remain separate, enabling clean and maintainable code.
2. Reusability
   Using features like blocks and macros, you can create modular and reusable components for your theme.
3. Customization
   With Twig, you can easily override or extend default templates, making it simple to customize the look and feel of your Typemill site.

Key Concepts in Twig Templates

1. Variables

Variables allow you to dynamically display content in your templates.

2. Filters

Filters modify the output of variables. Common examples include formatting dates, converting text to uppercase, or counting the number of items.

3. Blocks and Extends

Twig supports inheritance through blocks and the extends tag, enabling you to create a base template and extend it in child templates.

Using Twig with Typemill

Typemill uses Twig for all its themes. When developing a theme, you can find and edit templates in the templates folder of your theme directory. The key templates include:

• page.twig for rendering individual pages.
• navigation.twig for site navigation.
• layout.twig for the overall structure.

To get started, you can copy an existing theme, experiment with its templates, and use Twig's syntax to adapt it to your needs.