A place to meet Statie
I'm happy to announce that Statie, a newcomer to the field of static site generators written in PHP, received a place where it could promote itself better. It's own website. Though a really simple one; but it's healthy to start with small things, they say.
My own blog is being built with Statie. But why did I choose something with almost no history and with just a few users, when plenty of other possibilities are out there?
A bit of story
Well, if you come from Slovakia or Czechia you probably know Nette framework and its awesome Latte templating engine. If you haven't heard about it before I recommend you to take a break and give it a shot to make yourself familiar. It may be useful in the future.
To continue, I consider Latte the most elegant among others and that's the reason I chose Statie. Yep, it's that straightforward. Really, just look at it.
I wanted to spread the word and add a mention to the catalog of static generators when I realized there is no homepage. By the way, it just blew my mind to see how many of the generators are in there only waiting to be used. Maybe another day...
A bit of stack
The website runs on Statie, obviously. I just took markdown documentation files, written by the creator Tomas, which were lying on GitHub, covered them with a handful of templates, threw some configuration and voilà.
I thought I could play a bit and use some things I haven't had a pleasure to try on other projects. Many articles about new (okay, let's say different) CSS principles called utility-first wander around the internet. Especially one by Adam Wathan, a really thorough one, convinced me to try such a technique. Why not use the framework he created straight ahead? It was easy and resulting styles.css is so lean I want to applaud (not sure whether me or him).
Even though Statie's learning material isn't very verbose (yet!) a feature one would certainly expect from a documentation site is the possibility to search. I knew I want to use Algolia, widely used in the open-source scene. The setup was a piece of cake and it's working like a charm. Apropos, definitely try their browser plugin adding new functionality to the GitHub search; have could I live without that.
A bit of end
And that's it. I hope the site will grow together with Statie and that some of you will pitch in as well.
Do you use Statie? Contribute now and add your site to the list of projects!
- Statie documentation
- Nette Framework
- Latte - amazing template engine for PHP
- Top Open-Source Static Site Generators
- CSS Utility Classes and "Separation of Concerns"
- Tailwind CSS - A Utility-First CSS Framework
- The easiest way to add search to your documentation
- A browser extension enhancing GitHub's search bar with autocomplete