Sculpin v3.0.0 Release Notes
Release Date: 2019-04-10 // about 5 years ago-
โ Added
- ๐ New
--output-dir
flag allows users to override the default output directory (output_dev
,output_prod
) with their own custom target.- Also works with
SCULPIN_OUTPUT_DIR
environment variable.
- Also works with
- ๐ New
--source-dir
flag allows users to override the default source directory (source
) with their own custom target.- Also works with
SCULPIN_SOURCE_DIR
environment variable.
- Also works with
- ๐ New
content:create
command allows users to quickly and easily create new content types. It will generate appropriate templates, including pagination. - New
init
command allows users to spin up an EXTREMELY bare-bones Sculpin site, automatically creating YAML configuration files and some placeholdersource/
files.- Note that "posts" are disabled in this bare-bones configuration. If you would like to create a traditional Blog site, definitely use an existing skeleton project such as: https://github.com/sculpin/sculpin-blog-skeleton
๐ Changed
- BC BREAK: Many classes have been made final to reduce complexity. If there is a valid use case to extend one of the classes, please do a pull request to remove the final keyword and explain why you need to extend the class.
- ๐ BC BREAK: #367 moved to PHP 7.2 as the new minimum PHP version for Sculpin.
- BC BREAK: #392 changed
the signature of the
getAdditionalSculpinBundles()
method to specify anarray
return type. If you have a customSculpinKernel.php
file you will need to - #385 bumped minimum
Symfony packages version to 4.1
- See the "Fixed" section for a BC Break related to the Symfony YAML component.
๐ Deprecated
- Nothing.
โ Removed
- ๐ #332 dropped php 5 support.
- ๐ #335 removed embedded composer and related commands: install, update, self-update and dump-autoload
๐ Fixed
- BC BREAK: Pagination file names can now use the ".twig" extension, and
when using this mode, "Page 2" will render as "blog/page/2/index.html"
instead of "blog/page/2.html"
- To preserve search engine indexes and/or bookmarks, consider creating redirect mappings to send visitors to the new destinations.
- โฌ๏ธ BC BREAK: Upgrading the Symfony YAML component has resulted in some
changes to YAML Front Matter processing.
- Most notably, values with a colon, such as page titles, now
require quoting. E.g.,
title: My Journey: Back From Whence I Came
must now betitle: "My Journey: Back From Whence I Came"
- These instances should be clearly called out the first time you call the generate command, so it should require minimal effort to locate and fix.
- Most notably, values with a colon, such as page titles, now
require quoting. E.g.,
- ๐ New