Skip to content

Latest commit

 

History

History
82 lines (55 loc) · 2.95 KB

README.md

File metadata and controls

82 lines (55 loc) · 2.95 KB

Stenope

The static website generation tool for Symfony.

CLI

Why another static site generator?

We're Symfony developers that couldn't find a static website generator that bended to our needs.

We needed a way of generating static websites that:

  • Doesn't impose a format, a structure or a location for the data.
  • Runs in a Symfony environment.
  • Allow us to develop virtually any feature we might need.

Stenope does that.

Installation

In your existing Symfony app:

composer require stenope/stenope

If you plan to create a new app from scratch, you can give a try to the Stenope Skeleton.

Usage

bin/console -e prod cache:clear
bin/console -e prod stenope:build ./static

Your Symfony app is now a static website in: ./static! ✨

Next: learn more about Stenope's content management system.

Philosophy and goals

Stenope was designed with these goals in mind:

  • Stenope meets your needs, not the other way around.
  • Stenope runs in any Symfony project out of the box, connects with standard Symfony components and feels natural to Symfony developers.
  • Stenope is highly extensible: features can be replaced, added or removed.

How it works

  • 🔍 Stenope scans your Symfony app (like a search engine crawler would) and dumps every page into a static HTML file.
  • 🛠 Stenope provides tools for loading and parsing various data sources (like local Markdown files or distant headless CMS).
  • 🖌 Stenope enriches the parsed data by applying a series of processors (like Syntax Highlighting, slug generation, etc.).
  • 🧲 Stenope finally hydrates your custom PHP objects with the enriched data and provides interfaces for listing and retrieving them (like an ORM would).
  • ⚙️ Stenope gives you a lot of control over the whole process by providing entrypoints, interfaces and default implementations that are entirely replaceable.

What Stenope is not

Stenope is not a ready-to-use bloging system: but you could quickly write your own blog system with it!

In-depth documentation

Features

Cookbooks