Download the PHP package ergebnis/twig-front-matter without Composer
On this page you can find all versions of the php package ergebnis/twig-front-matter. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download ergebnis/twig-front-matter
More information about ergebnis/twig-front-matter
Files in ergebnis/twig-front-matter
Package twig-front-matter
Short Description Provides a GitHub repository template for a PHP library, using GitHub Actions.
License MIT
Homepage https://github.com/ergebnis/twig-front-matter
Informations about the package twig-front-matter
twig-front-matter
This project provides a composer
package with a Twig loader for files with YAML front-matter.
Installation
Run
Usage
Loading Twig templates with the FrontMatterLoader
This project ships with a FrontMatterLoader
that you can use to load Twig templates with YAML front-matter.
The FrontMatterLoader
- parses a Twig template and separates the front-matter from the body-matter using `ergebnis/front-matter
- converts the front-matter data to Twig assignments using an implementation of
Converter\FrontMatterConverter
- returns a new Twig Source that merges the Twig assignments from the front-matter data with the body-matter from the Twig template
YAML front-matter
Assume that you have a Twig template with the following YAML front-matter:
Converting YAML front-matter to Twig assignments with the Converter/ToMultipleAssignmentsFrontMatterConverter
This project ships with a Converter/ToMultipleAssignmentsFrontMatterConverter.php
that you can use to convert the YAML front-matter to multiple Twig assignments.
The example below will convert the parsed YAML front-matter data to multiple Twig assignments that will assign data to Twig variables with force:
The example below will convert the parsed YAML front-matter data to multiple Twig assignments that will assign data to Twig variables without force (taking into account that you may pass variables to the template and prefer not to override these variables with front-matter):
Converting YAML front-matter to a Twig assignment with the Converter/ToSingleAssignmentFrontMatterConverter
This project ships with a Converter/ToSingleAssignmentFrontMatterConverter.php
that you can use to convert the YAML front-matter to a single Twig assignment.
The example below will convert the parsed YAML front-matter data to a single Twig assignment that will assign data to a Twig variable with force:
The example below will convert the parsed YAML front-matter data to a single Twig assignment that will assign data to a Twig variables without force (taking into account that you may pass a variable to the template and prefer not to override this variable with front-matter):
Configuring services in a Symfony project
Adjust your config/services.php
as follows to register a FrontMatterLoader
with a Converter\ToMultipleAssignmentsFrontMatterConverter
:
Changelog
The maintainers of this project record notable changes to this project in a changelog.
Contributing
The maintainers of this project suggest following the contribution guide.
Code of Conduct
The maintainers of this project ask contributors to follow the code of conduct.
General Support Policy
The maintainers of this project provide limited support.
You can support the maintenance of this project by sponsoring @localheinz or requesting an invoice for services related to this project.
PHP Version Support Policy
This project supports PHP versions with active and security support.
The maintainers of this project add support for a PHP version following its initial release and drop support for a PHP version when it has reached the end of security support.
Security Policy
This project has a security policy.
License
This project uses the MIT license.
Social
Follow @localheinz and @ergebnis on Twitter.
All versions of twig-front-matter with dependencies
ergebnis/front-matter Version ^3.1.0
twig/twig Version ^3.4.3