PHPackages michaldudek/genry - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Templating & Views](/categories/templating) 4. / 5. michaldudek/genry ActiveLibrary[Templating & Views](/categories/templating) michaldudek/genry ================= Static page generator that uses Twig. 0.3.1(11y ago)31231MITPHPPHP >=5.4 Since May 29Pushed 10y ago1 watchersCompare [ Source](https://github.com/michaldudek/genry)[ Packagist](https://packagist.org/packages/michaldudek/genry)[ RSS](/packages/michaldudek-genry/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (6)Versions (7)Used By (1) Genry ==================================== [](#genry) [![Build Status](https://camo.githubusercontent.com/25c200876847b30949e33fd198f61cee72e72f0ba524778b3a7960223962dbe2/68747470733a2f2f7472617669732d63692e6f72672f6d696368616c647564656b2f67656e72792e737667)](https://travis-ci.org/michaldudek/genry) Genry is a static page generator that uses [Twig](http://twig.sensiolabs.org/) templating system. Use cases include: - HTML pages loaded from file system - hosting environments where no scripting language is available (e.g. no PHP, Ruby, Python, Perl, node.js, etc.) - GitHub project and user pages It's perfect for people who don't have experience with building dynamic websites in server side languages, but want to ease their website building process by eliminating copy/paste code (like navigation HTML) or want to make use of powerful templating language. Visit . TL;DR ------------------------------------- [](#tldr) - Get [Composer](https://getcomposer.org). - Run `$ composer create-project michaldudek/genry-project suchwebsite -s dev` to start a Genry project in `suchwebsite` dir. - Use [Twig templates](http://twig.sensiolabs.org/) to create your website. - Put all your templates inside `_templates` directory. - Run `$ php bin/genry generate` to generate static HTML files. - In templates: - When including/extending templates refer to them relative to the `_templates` dir, e.g. `{{ include "subdir/content.html.twig" }}` for including `_templates/subdir/content.html.twig`. - Use `{{ stylesheet('assets/css/global.css') }}` and `{{ javascript('assets/js/global.js') }}` to add CSS and JS files and `{{ stylesheets() }}` and `{{ javascripts() }}` to output them to make sure their URL is always correct and relative to the generated page - Import Markdown files using `{{ markdown('path/to/file/in/_templates/article.md') }}` - Templates that filenames end with `.inc.html.twig` are not rendered directly into HTML files (they are only to be included by other templates) More information ---------------------------------------------------- [](#more-information) #### Write content in Markdown [](#write-content-in-markdown) Genry allows you to import Markdown files directly into HTML files, so you can focus on writing your content, instead of markup. #### Templating [](#templating) For comprehensive list of possibilites you should check [Twig for Template Designers](http://twig.sensiolabs.org/doc/templates.html), but to highlight a few of them: - **template inheritance** - create one layout and use it on every page without repeating yourself - **includes** - include other templates to easily reuse HTML elements you have already created elsewhere - update in one place and it will change everywhere - **control structure** - use features like `if / elseif / else`, `for` loops or powerful `block` system to build your HTML dynamically - **macros** - generate HTML dynamically using macros with arguments based on which you can alter the output - **variables** - store some settings or strings you use often in variables to reuse them easily - **filters** - modify your output by applying filters to them (e.g. format a number, capitalize first word letters in whole sentence, url encode a string) #### Extensibility [](#extensibility) Genry is built in with [Splot Framework](https://github.com/splot/Framework) (to be released, currently in active development) and can be easily extended through Splot's module system and dependency injection, as well as Twig's extensions feature. Requirements ---------------------------------------------------- [](#requirements) Genry requires **PHP 5.4+ command line** environment to run which means that it runs just fine on Mac OS X and Linux (*I have no idea about Windows, sorry...*). It also requires PHP's package manager - **[Composer](https://getcomposer.org/)**. To install Composer follow [their instructions](https://getcomposer.org/doc/00-intro.md#installation-nix), but in short it's this: ``` $ curl -sS https://getcomposer.org/installer | php $ mv composer.phar /usr/local/bin/composer ``` Composer will help your projects to use the latest version of Genry and will give you access to all of its modules and extensions. Installation ---------------------------------------------------- [](#installation) Genry lives directly inside your project, so you don't have to install it on your computer. Simply, when you are about to start a new website project open your Terminal and run this command (where `suchwebsite` is name/path to your project so you should probably change it to something else): ``` $ composer create-project michaldudek/genry-project suchwebsite -s dev $ cd suchwebsite ``` This will create a basic boilerplate template for your project and some files and dirs that are required for Genry to run: - `.genry` and `.cache` contain code required by Genry - `_templates` is where your website templates will live (so that they are separate from the main website) - `assets` is a suggested place to put your CSS and JS files, images, videos and any other "assets", but you can put them wherever you want really - `bin` is a directory with executable files and there should be a `bin/genry` file - `.gitignore` comes prepopulated with some files to ignore by Git, so they don't trash your repository - `.bowerrc` is a suggested configuration for [Bower](http://bower.io) if you want to use it - `bower.json` comes with few suggested packages that you might want to get from [Bower](http://bower.io) to get you started - `composer.json` and `composer.lock` are files created by Composer that hold information which version of Genry and other PHP libraries you are using This may seem like quite a lot of files to just start a website, but they are there for a reason and should never get in your way. Configuration ------------------------------------------------------ [](#configuration) You can create a `.genry.yml` in the root of your project if you want to configure Genry. This is the default configuration: ``` cache_dir: .cache templates_dir: _templates web_dir: . modules: # here you can list additional Genry modules you want available, using their full PHP namespace ``` #### Updating and re-installing [](#updating-and-re-installing) If you ever wanted to update Genry to newer version or install it for a Genry project that you deleted from your computer, but pulled it back from somewhere, just use these commands: - `$ composer update` - to update Genry to its latest version - `$ composer install` - to install Genry in a previously "Genry-enabled" project Usage -------------------------------------- [](#usage) By default all templates are stored inside the `_templates` dir so that they don't pollute the root dir and are clearly separated from the generated HTML files. Any `*.html.twig` files inside that dir (and its subdirs) will be compiled and turned to static HTML files inside the root folder of the project. The directory structure from inside `_templates` will be kept, e.g. - `./_templates/index.html.twig` will compile to `./index.html` - `./_templates/subdir/index.html.twig` will compile to `./subdir/index.html` - `./_templates/subdir/contents.html.twig` will compile to `./subdir/contents.html` One exception to this rule are files that end with `*.inc.html.twig` - these will not be compiled. Their only purpose is to be included inside other templates. When you include or extend other templates in Twig, always specify their locations relative to the `_templates` directory. So, if you have a directory structure like this: ``` _templates/ slides/ project1.inc.html.twig project2.inc.html.twig layout/ header.inc.html.twig footer.inc.html.twig index.html.twig layout.inc.html.twig assets/ ... composer.lock composer.json genry ``` Your `index.html.twig` template should refer to all other templates like this: ``` {% extends "layout.inc.html.twig" %} {% block body %} {% include "layout/header.html.twig" %} {% include "project1.inc.html.twig" %} {% include "project2.inc.html.twig" %} {% include "layout/footer.html.twig" %} {% endblock %} ``` **Always** refer to templates relative to the `_templates/` dir, even from templates next to each other in the same sub directory. ### Compiling [](#compiling) When you have created your templates compile them by executing this command in the command line in your project folder: ``` $ php genry generate ``` ### Assets Management [](#assets-management) Because the generated HTML files will be saved in different locations relative to the root dir while probably extending a single layout template and because your website might not always live in the root dir of your domain (think GitHub project pages which are located at `http://username.github.io/projectname/`) using relative or absolute paths to your JavaScript and CSS files might cause a lot of problems. For example, if your `_templates/layout.inc.html.twig` file includes assets like this: ``` ``` It will only work if your website resides in root folder of your domain. If you were to put it in a subdir, e.g. at `yourdomain.com/suchwebsite/` links to the assets would be broken. However, if you change them to be relative: ``` ``` This will only work for files that are located in the root dir of your website. If you made a template `_templates/subdir/article.html.twig`: ``` {% extends "layout.inc.html.twig" %} {% block content %} Lorem ipsum dolor sit amet. {% endblock %} ``` It will compile to a file `subdir/article.html` and the relativeassets links will also be broken for this one page. Genry takes care of these two problems if you let him. Wherever you want to add a CSS or JS file use this notation: ``` {{ stylesheet('/path/to/css/relative/to/project/dir.css') }} {{ javascript('/path/to/js/relative/to/project/dir.js') }} ``` And to output all CSS files (typically in ``): ``` {{ stylesheets() }} ``` And JS files (typically right before ``): ``` {{ javascripts() }} ``` The result will be that Genry will generate URL's to those assets always relative to the generated static HTML file. This way your generated files can safely be put at whatever location on your server as well as opened locally straight from the file system. Features -------------------------------------------- [](#features) Genry comes with few pre-packaged features that don't require any additional modules. ### Markdown [](#markdown) If you want to write your content in Markdown (like this documentation) you can easily import and compile Markdown files inside your templates by simply writing: ``` {{ markdown('path/to/file/in/templates/article.md') }} ``` You can also use a Markdown filter: ``` {{ "[such website](http://www.dogeweather.com), **much markdown**, such HTML."|markdown }} ``` ### Data Objects [](#data-objects) TBD Roadmap ------------------------------------------ [](#roadmap) Genry is very much **work in progress** and the core of it has been created in one (albeit long) evening. There are many ideas and features that could be developed for it, but I want to keep it simple. Here is a list of features that are on the roadmap for the nearest future (ie. when need be): - More documentation including some recipes, examples and "built with Genry" section as well as information on how to create your own modules. - Watching the project for changes and auto regenerating the pages. - Minification of CSS and JS files (reusing what is already in Splot Assets Module). Contribute ------------------------------------------------ [](#contribute) Pull requests, reported issues and any help is welcome. Just keep in mind that this is a strongly personal project and I might have already started working on something that you wanted to do, so before doing any coding work please submit an issue with your idea for discussion. If you want to develop something for Genry then I will be very happy to help, as there isn't much documentation on this topic yet. Just open an issue and I'll reply to it. ### Health Score 26 — LowBetter than 43% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity13 Limited adoption so far Community9 Small or concentrated contributor base Maturity52 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~31 days Total 5 Last Release 4237d ago PHP version history (2 changes)0.1.0PHP >=5.3.3 0.3.0PHP >=5.4 ### Community Maintainers ![](https://www.gravatar.com/avatar/1ba8fe13a31c13c6411bec9a0b5d902708796ceed70e83a45c733b8ad26dd3ce?d=identicon)[michaldudek](/maintainers/michaldudek) --- Top Contributors [![michaldudek](https://avatars.githubusercontent.com/u/802141?v=4)](https://github.com/michaldudek "michaldudek (40 commits)") --- Tags twiggeneratorhtmlstatic ### Embed Badge ![Health badge](/badges/michaldudek-genry/health.svg) ``` [![Health](https://phpackages.com/badges/michaldudek-genry/health.svg)](https://phpackages.com/packages/michaldudek-genry) ``` ### Alternatives [tightenco/jigsaw Simple static sites with Laravel's Blade. 2.2k438.5k29](/packages/tightenco-jigsaw)[latte/latte ☕ Latte: the intuitive and fast template engine for those who want the most secure PHP sites. Introduces context-sensitive escaping. 1.3k15.7M679](/packages/latte-latte)[twig/string-extra A Twig extension for Symfony String 21946.0M132](/packages/twig-string-extra)[spress/spress Static site generator with blogs support 37436.2k](/packages/spress-spress)[twig/markdown-extra A Twig extension for Markdown 12114.3M83](/packages/twig-markdown-extra)[twig/html-extra A Twig extension for HTML 777.6M41](/packages/twig-html-extra) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)