Borrows heavily from MIT Licenced https://github.com/osteele/liquid Where osteele/liquid is
designed to render Liquid templating (and is used by GoJekyll) - this usage of their code makes
the AST more the primary focus, removing rendering (this is the AST transpilers job). In some
places the modifications are substantial and in other places a copy/paste. @todo document what
is borrowed.
Parse Jekyll front matter and Liquid templating into a Liquified struct.
The Liquified Struct contains FrontMatter and an AST describing the page content / templating.
A Transpiler can then walk the AST converting the templating to another language (e.g. PHP).
A {% for %} block will compile to a PHP loop. @todo add support for all For constructs in liquid.
Example:
{% for a in page.thing %}some value{% endfor %}
will transpile to:
<?php for ($i, $a in $page["thing"]){ ?>some value<?php } ?>
{% include %} tags are converted to a render() function call with the template and an array of
arguments.
Example:
{% include components/something.html title=page.title
background='some string value'
something=page.something
another="string" %}
will transpile to:
<?php $values = ["title"=>$page["title"],"background"=>"some string value","something"=>$page["something"],"another"=>"string",]; ?><?php render("components/something.html", $values);?>
{% assign things = site.posts | where:"some","thing" %}
<?php $things = $site["posts"] /* filter where "some""thing" */;?>
{% j page.title %}
<?php echo j($page["title"]);?>
{% capture background %}some value{% endcapture %}
<?php $background = "some value";?>
{% comment %}some value{% endcomment %}
/* some value */
Filters are printed commented out.