We're in the run up to v1.0, the first stable release. As a result, there were quite a few deprecations in this release, and a lot of new features.
The Perldoc app now creates folders instead of files for the POD. This means the link to
My::Modulewill now be
This is being done outside a deprecation policy in the hope that nobody's started using the app extensively enough to be hurt. Having both sets of pages (.html and non-.html) was deemed too much for a non-stable release. If something like this happens after v1.0, we will build both sets of pages (with a switch to turn off the old set).
Using either the Static or Plain apps will give a warning. To fix this warning, change the app's
Statocles::App::Basic. See Statocles::Help::Upgrading for details.
The File store is now just Statocles::Store. Likely this requires no changes in your config, unless you've referenced
Statocles::Store::Filedirectly (just change it to
Statocles::Storeto silence the deprecation warnings).
The Store write_document method used to return the full path to the document written. This was confusing, as one generally does not expect a write method to return anything (unless it's a true/false value for success/failure). As of right now, you can get the document path by calling the
child()method of the Store's path attribute.
There is a new Basic app. This application supports Markdown files and collateral images and files. It is the basic functionality of all Statocles apps.
The default themes now support Disqus. Disqus allows adding comments even to otherwise static websites. Until the Dynamocles project allows for a dynamic partner to Statocles sites, Disqus is an easy way to provide some user engagement.
If you want extra frontmatter document metadata, you can now create your own Statocles::Document sub-classes, and refer to them in your frontmatter using
This enables you to add custom attributes and other such to your documents. It could also allow for non-Markdown documents, and other interesting things in the future.
The site creator command (
statocles create) now creates a fully-ready site with skeleton content. The configuration file it creates now comes with comments to make it easier to edit.
Plugins can now be added to individual applications, because every app now comes with a
buildevent. If you only want to check links on a single application, or if you want to modify the application's pages without writing an entire app subclass, this is a good way to do it.
When writing pre-dated entries, to be posted sometime in the future, there is now a way to test how the site will look in the future when that post is deployed.
statocles daemon, and
statocles deploywill render the site as though it was the given date. See the
statocles helpcommand for more information.
Full changelog below...