Static Sites With Sculpin (TrueNorth PHP November 2013)

Static Sites With Sculpin True North PHP Uncon November 9th,
2013

@beausimensen simensen on Freenode #sculpin

beau.io/tnphp2013

beau.io/tnphp2013 sculpin generate --watch --server

• Jekyll (Octopress) — jekyllrb.com • Phrozn — phrozn.info •
PieCrust — bolt80.com/piecrust • Sculpin — sculpin.io • ... too many to count beau.io/tnphp2013

What Are Static Sites? beau.io/tnphp2013

What Are Static Sites? • Plain ol’ HTML ﬁles •
XML, JSON, CSS, etc • Assets • Not interpretted beau.io/tnphp2013

Why Static Sites? beau.io/tnphp2013

Why Static Sites? • Few restrictions on server environment •
Easy to deploy (scp, rsync, GitHub) • No database dependencies • Less things to break • Should absorb trafﬁc bursts more easily beau.io/tnphp2013

Why Built Yet Another Static Site Generator? beau.io/tnphp2013

Why Built Yet Another Static Site Generator? • Not Invented
Here is a hard habit to kick • Contributed to Jekyll and Octopress • Tried working with Phrozn • Somehow managed to miss PieCrust • Lurking in #symfony and #symfony-dev • Found Composer beau.io/tnphp2013

Why Is Sculpin Special? beau.io/tnphp2013

Why Is Sculpin Special? • Symfony’s Kernel • React’s HTTP
Server • Embedded Composer • Twig beau.io/tnphp2013

Twig Doing Inheritance “Right” beau.io/tnphp2013

--- layout: default --- # This is a markdown file
with YAML frontmatter beau.io/tnphp2013

--- layout: default --- # This is a markdown file
with YAML frontmatter {% extends "default" %} {% block content %} # This is a markdown file with YAML frontmatter {% endblock %} beau.io/tnphp2013

--- layout: default special_value: nice --- # This is a
markdown file with YAML frontmatter beau.io/tnphp2013

<html> {% if page.special_value is defined %} Special value exists
and is <strong>{{ page.special_value }}</strong>!. {% endif %} {% block content %}Fallback content{% endblock %} </html> --- layout: default special_value: nice --- # This is a markdown file with YAML frontmatter beau.io/tnphp2013

<html> {% if page.special_value is defined %} Special value exists
and is <strong>{{ page.special_value }}</strong>!. {% endif %} {% block content %}Fallback content{% endblock %} </html> --- layout: default special_value: nice --- # This is a markdown file with YAML frontmatter beau.io/tnphp2013 <html> Special value exists and is <strong>nice</strong>!. <h1>This is a markdown file with YAML frontmatter</h1> </html>

beau.io/tnphp2013 page.[something] References YAML frontmatter

beau.io/tnphp2013 site.[something] References app/conﬁg/sculpin_site.yml Values

beau.io/tnphp2013 {% if page.full_title %} <title>{{ page.full_title|raw }}</title> {% else
%} <title> {{ page.title }} — {{ site.title }} — {{ site.subtitle }} </title> {% endif %}

beau.io/tnphp2013 Lifecycle • Generate (Generators) • Permalink Creation • Convert
• Format • Output

beau.io/tnphp2013 Events • Sculpin\Core\Sculpin::EVENT_BEFORE_RUN • Sculpin\Core\Sculpin::EVENT_AFTER_RUN • Sculpin\Core\Sculpin::EVENT_BEFORE_CONVERT • Sculpin\Core\Sculpin::EVENT_AFTER_CONVERT
• Sculpin\Core\Sculpin::EVENT_BEFORE_FORMAT • Sculpin\Core\Sculpin::EVENT_AFTER_FORMAT

beau.io/tnphp2013 Symfony Bundles

beau.io/tnphp2013 Data Sources and Sources

beau.io/tnphp2013 Data Providers PostsBundle is a great example

beau.io/tnphp2013 Generators

beau.io/tnphp2013 Extensions

beau.io/tnphp2013 Extensions Look at PostsBundle :)

beau.io/tnphp2013 Community #sculpin on Freenode @getsculpin

Thanks! beau.io/tnphp2013 @getsculpin @beausimensen

Static Sites With Sculpin (TrueNorth PHP Novemb...

Static Sites With Sculpin (TrueNorth PHP November 2013)

Beau Simensen

More Decks by Beau Simensen

Other Decks in Programming

Featured

Transcript

Static Sites With Sculpin True North PHP Uncon November 9th,

@beausimensen simensen on Freenode #sculpin

beau.io/tnphp2013

beau.io/tnphp2013 sculpin generate --watch --server

• Jekyll (Octopress) — jekyllrb.com • Phrozn — phrozn.info •

What Are Static Sites? beau.io/tnphp2013

What Are Static Sites? • Plain ol’ HTML ﬁles •

Why Static Sites? beau.io/tnphp2013

Why Static Sites? • Few restrictions on server environment •

Why Built Yet Another Static Site Generator? beau.io/tnphp2013

Why Built Yet Another Static Site Generator? • Not Invented

Why Is Sculpin Special? beau.io/tnphp2013

Why Is Sculpin Special? • Symfony’s Kernel • React’s HTTP

Twig Doing Inheritance “Right” beau.io/tnphp2013

--- layout: default --- # This is a markdown file