drdplusinfo/statie

Static Site Generator

v6.0.10 2024-08-27 18:22 UTC

Requires

• php: ^7.1|^8.0
• ext-dom: *
• erusev/parsedown: ^1.7
• erusev/parsedown-extra: ^0.8.1
• granam/assets-version: ^2.0
• granam/string: ^4.0
• guzzlehttp/guzzle: ^6.3
• j7mbo/twitter-api-php: ^1.0
• latte/latte: ^2.5
• nette/finder: ^2.4
• nette/utils: ^2.5|^3.0
• phpgt/dom: ^2.1
• symfony/config: ^3.4|^4.1
• symfony/console: ^3.4|^4.1
• symfony/dependency-injection: ^3.4|^4.1
• symfony/dotenv: ^4.2
• symfony/event-dispatcher: ^3.4|^4.1
• symfony/expression-language: ^5.1
• symfony/finder: ^3.4|^4.1
• symfony/http-kernel: ^3.4|^4.1
• symfony/yaml: ^3.4|^4.1
• symplify/package-builder: ^5.4
• tracy/tracy: ^2.5
• twig/twig: ^2.5

Requires (Dev)

• phpunit/phpunit: ^7.5|^8.0

MIT

README

Statie - Modern and Simple Static Site Generator in PHP

Statie takes HTML, Markdown and Twig or Latte files and generates static HTML page.

Install

composer require symplify/statie

How to Generate and See the Website?

1. Prepare content for Statie

vendor/bin/statie init

Do you prefer Latte?

vendor/bin/statie init --templating latte

This will generate config, templates, layouts and gulp code, so you can enjoy live preview.

Last step is install node dependencies:

npm install

1. Generate static site from /source (argument) to /output (default value) in HTML:

vendor/bin/statie generate source

1. Run website locally

gulp

1. And see web in browser localhost:8000.

Do you use Jekyll or Sculpin?

We'll help you migrate:

vendor/bin/statie migrate-jekyll
vendor/bin/statie migrate-sculpin

They will do 95 % of migration for you. If you still struggle with migration, look at:

• 9 Steps to Migrate From Jekyll to Statie
• 11 Steps to Migrate From Sculpin to Statie

Configuration

statie.yml Config

This is basically Symfony Kernel config.yml that you know from Symfony application. You can:

• add parameters
• import configs
• register services

# statie.yml
imports:
    - { resource: 'data/favorite_links.yml' }

parameters:
    site_url: 'http://github.com'
    socials:
        facebook: 'http://facebook.com/github'

services:
    App\SomeService: ~

Parameters are available in every template:

{# source/_layouts/default.twig #}

<p>Welcome to: {{ site_url }}</p>

<p>Checkout my FB page: {{ socials.facebook }}</p>

Do You Write Posts?

Create a new empty .md file with date, webalized title and ID:

vendor/bin/statie create-post "My new post"

Statie privides default template:

id: __ID__
title: "__TITLE__"
---

Do you want your own template? Configure path to it:

# statie.yaml
parameters:
    post_template_path: 'templates/my_own_post.twig'

That's it!

How to Generate API?

Statie web Friendsofphp.org provide info about PHP meetups and groups. They're already stored in parameters. Do you want to publish them as JSON API?

parameters:
    api_parameters:
        - 'groups'
        - 'meetups'

This will generate 2 pages:

/api/groups.json
/api/meetups.json

With parameters as JSON, that anyone can use now.

How to Redirect old page?

# statie.yml
parameters:
    redirects:
        old_page: 'new_page'
        old_local_page: 'https://external-link.com'

Are you Speaker? Use your JoindIn Talks

# statie.yml
parameters:
    joind_in_username: 'tomasvotruba'

vendor/bin/statie dump-joind-in

This will generated source/_data/generated/joind_in_talks.yaml file with your talks:

parameters:
    joind_in_talks:
        # ...

Then you can use them like any other parameter in your Statie templates:

{% for joind_in_talk in joind_in_talks %}
    ...
{% endfor %}

Useful Twig and Latte Filters

All from Latte basic set and more:

Twig

{% set users = sort_by_field(users, 'name') %}
{% set users = sort_by_field(users, 'name', 'desc') %}

<!-- picks all posts defined in "related_items: [1]" in post -->
{% set relatedPosts = related_items(post)}

{{ content|reading_time }} mins
{{ post.getRawContent|reading_time }} mins

{{ perexDeprecated|markdown }}
{% set daysToFuture = diff_from_today_in_days(meetup.startDateTime) %}

{{ post|link }}

Latte

{var $users = ($users|sort_by_field:'name')}
{var $users = ($users|sort_by_field:'name', 'desc')}

<!-- picks all posts defined in "related_items: [1]" in post -->
{var $relatedPosts = (post|related_items)}

{$content|reading_time} mins
{$post->getRawContent()|reading_time} mins

{$perexDeprecated|markdown}
{var $daysToFuture = diff_from_today_in_days($meetup->startDateTime())}

{$post|link}

Documentation

Thanks to @crazko you can enjoy neat documentation and see projects that use Statie at statie.org.

• How to Tweet your Posts with Travis
• How to Thank your Contributors

Contributing

Open an issue or send a pull-request to main repository.