Changelog History
Page 1
-
v3.1.0 Changes
December 02, 2020๐ Sculpin 3.1.0 adds support for PHP 8.0, and drops support for PHP 7.2.
-
v3.0.3 Changes
December 04, 2019๐ This Sculpin release fixes some deprecated syntax notices under PHP 7.4, by upgrading michelf/php-markdown to v1.9.
โก๏ธ Thanks, Michel, for getting that update live!
-
v3.0.2 Changes
May 27, 2019๐ This Sculpin release fixes issues (#432, #434) with certain file names and file types.
When processing content types, such as entries in
source/_posts/*
, Sculpin will now skip certain files.- "hidden" files (beginning with a
.
) will be skipped silently.- This helps suppress files like
.DS_Store
.
- This helps suppress files like
- files which aren't recognized by any registered Formatter will be skipped with a "Skipped ..." message.
- This helps combat strange behaviour for files with no extension.
- "hidden" files (beginning with a
-
v3.0.1 Changes
April 17, 2019๐ This release improves the
content:create
command and fixes an issue with sorting that is caused by PHP'suasort
behaving in an undefined way when sorting items with equal values.- 0๏ธโฃ Boilerplate is now generated by default when using content:create. Use
--dry-run
/-d
to suppress the creation of these files. Note that the content type YAML definition still needs to be added by hand to yoursculpin_kernel.yml
file. - 0๏ธโฃ Taxonomy-related boiler plate files now default to using the
default
layout instead of no layout at all. This should result in prettier output. - ProxySourceCollection now uses the StableSort algorithm from Martijn van der Lee to ensure stable sorting results, which will eliminate some of the issues reported in bug #308 that were causing generate to constantly repeat in watch mode.
- Thanks to Rami Jumaah and Christian Riesen, Pages can now refer to their own relative pathname and filename using
page.relative_pathname
andpage.filename
. This can be useful for implementing an "Edit This Page" link directly to a GitLab or GitHub VCS URL.
- 0๏ธโฃ Boilerplate is now generated by default when using content:create. Use
-
v3.0.0 Changes
April 10, 2019โ 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
-
v3.0.0-rc5 Changes
April 08, 2019๐ A hotfix release to fix an issue in RC4. This undoes #420 which seems to have broken the site configuration factory.
-
v3.0.0-rc4 Changes
April 04, 2019๐ This is Release Candidate 4 for Sculpin 3.0.0.
๐ New requirements for this version of Sculpin include PHP 7.2 or higher.
๐ As this is a Release Candidate, please help by filing GitHub issues if you notice any problems!
๐ New for Release Candidate 4:
๐ A number of developers have chipped in to provide some great code cleanups and fixes. Thanks to @dbu @GawainLynch @ChristianRiesen @bellisk @opdavies, things are looking much nicer in Sculpin land.
- Some references to %kernel.root_dir% have been changed to a hopefully more-accurate %kernel.project_dir% argument (#420)
- PermalinkCollectionStrategy has been pulled out of the container so that SF4.2+ can properly dump the service container if desired (#419)
- ๐ป Exception handling has been improved and now displays colourful & more informative exceptions in watch mode (#421)
- Missing data provider fatal error is now a more-informative exception (#418)
- References to Twig classes have been switched to use namespaces (#423, efaa7c3)
- ๐ A number of core classes are now
final
and some methods have been moved toprotected
andprivate
; this will help reduce the complexity/surface of the code (#416, #417)- If this causes an issue, please file an issue or a PR. There might be use cases that weren't known about.
๐ New for Release Candidate 3:
- ๐ Fixed an issue with custom bundles not being able to register event handlers. There may be other custom bundle/extension issues lurking in the corners. Keep an eye out!
๐ New for Release Candidate 2:
:folder
permalink property- ๐ Bugfix for theme resource method
๐ New for Release Candidate 1:
- ๐ New
--source-dir
parameter to thegenerate
command ๐ New
init
command for initializing a bare-bones Sculpin configurationDescription: Initialize a default site configuration.
Usage: init [options]
Options: -t, --title=TITLE Specify a title for your Sculpin site. [default: "My Sculpin Site"]
-s, --subtitle=SUBTITLE Specify a sub-title for your Sculpin site. [default: "A Static Site Powered By Sculpin"]
--project-dir=PROJECT-DIR The project directory. [default: "."]
Help: The init command initializes a default site configuration.
๐ New for Alpha 4:
- โก๏ธ @lex111 has made great progress with updating sculpin's source code to use more PHP 7.x syntax and functionality.
- Attention: Sculpin extension developers - it would be helpful to check that your extension works with this alpha release's changes.
๐ New for Alpha 3:
- ๐ @lex111 found and fixed an issue with the
event_dispatcher
service not being public. - A little bit of syntax cleanup (
array()
to[]
)
๐ New for Alpha 2:
โก๏ธ A number of dependencies have been updated to the latest versions. This may introduce unexpected behaviour or deprecation notices in workflows that are not currently part of the test suite.
โก๏ธ Handling of the new
--output-dir
parameter has been modified. Bundles and extensions that rely onsculpin.output_dir
should be updated to use thesculpin.writer
service for writing to the proper output location.๐ง The temporary workaround for the
dflydev/dot-access-configuration
dependency in Alpha 1 has been removed.Alpha 1:
โก๏ธ A potential BC break to watch out for is a change in the URL format of interstitial "pagination" files. Bookmarks for "Page 2" and such may need to be updated.
- A gist can be found here with a concept for providing HTML-based redirects for legacy pagination files: https://gist.github.com/beryllium/a1b0be7b603486f5e39f869db8ff3484
๐ป This alpha version also includes the new "sculpin content:create" command, which allows you to generate a custom data type and associated templates straight from the command line:
Usage: content:create [options] [--] <type> Arguments: type Name for this type (e.g., "posts") Options: -b, --boilerplate Generate boilerplate/placeholder/template files. -t, --taxonomy=TAXONOMY Organize content by taxonomy categories ("tags", "categories", "types", etc) (multiple values allowed) Help: The content:create command helps you create a custom content type and, optionally, the associated boilerplate/templates.
Enjoy!
-
v3.0.0-rc3 Changes
March 07, 2019๐ This is Release Candidate 3 for Sculpin 3.0.0.
๐ New requirements for this version of Sculpin include PHP 7.2 or higher.
๐ As this is a Release Candidate, please help by filing GitHub issues if you notice any problems!
๐ New for Release Candidate 3:
- ๐ Fixed an issue with custom bundles not being able to register event handlers. There may be other custom bundle/extension issues lurking in the corners. Keep an eye out!
๐ New for Release Candidate 2:
:folder
permalink property- ๐ Bugfix for theme resource method
๐ New for Release Candidate 1:
- ๐ New
--source-dir
parameter to thegenerate
command ๐ New
init
command for initializing a bare-bones Sculpin configurationDescription: Initialize a default site configuration.
Usage: init [options]
Options: -t, --title=TITLE Specify a title for your Sculpin site. [default: "My Sculpin Site"]
-s, --subtitle=SUBTITLE Specify a sub-title for your Sculpin site. [default: "A Static Site Powered By Sculpin"]
--project-dir=PROJECT-DIR The project directory. [default: "."]
Help: The init command initializes a default site configuration.
๐ New for Alpha 4:
- โก๏ธ @lex111 has made great progress with updating sculpin's source code to use more PHP 7.x syntax and functionality.
- Attention: Sculpin extension developers - it would be helpful to check that your extension works with this alpha release's changes.
๐ New for Alpha 3:
- ๐ @lex111 found and fixed an issue with the
event_dispatcher
service not being public. - A little bit of syntax cleanup (
array()
to[]
)
๐ New for Alpha 2:
โก๏ธ A number of dependencies have been updated to the latest versions. This may introduce unexpected behaviour or deprecation notices in workflows that are not currently part of the test suite.
โก๏ธ Handling of the new
--output-dir
parameter has been modified. Bundles and extensions that rely onsculpin.output_dir
should be updated to use thesculpin.writer
service for writing to the proper output location.๐ง The temporary workaround for the
dflydev/dot-access-configuration
dependency in Alpha 1 has been removed.Alpha 1:
โก๏ธ A potential BC break to watch out for is a change in the URL format of interstitial "pagination" files. Bookmarks for "Page 2" and such may need to be updated.
- A gist can be found here with a concept for providing HTML-based redirects for legacy pagination files: https://gist.github.com/beryllium/a1b0be7b603486f5e39f869db8ff3484
๐ป This alpha version also includes the new "sculpin content:create" command, which allows you to generate a custom data type and associated templates straight from the command line:
Usage: content:create [options] [--] <type> Arguments: type Name for this type (e.g., "posts") Options: -b, --boilerplate Generate boilerplate/placeholder/template files. -t, --taxonomy=TAXONOMY Organize content by taxonomy categories ("tags", "categories", "types", etc) (multiple values allowed) Help: The content:create command helps you create a custom content type and, optionally, the associated boilerplate/templates.
Enjoy!
-
v3.0.0-rc2 Changes
March 02, 2019๐ This is Release Candidate 2 for Sculpin 3.0.0.
๐ New requirements for this version of Sculpin include PHP 7.2 or higher.
๐ As this is a Release Candidate, please help by filing GitHub issues if you notice any problems!
๐ New for Release Candidate 2:
:folder
permalink property- ๐ Bugfix for theme resource method
๐ New for Release Candidate 1:
- ๐ New
--source-dir
parameter to thegenerate
command ๐ New
init
command for initializing a bare-bones Sculpin configurationDescription: Initialize a default site configuration.
Usage: init [options]
Options: -t, --title=TITLE Specify a title for your Sculpin site. [default: "My Sculpin Site"]
-s, --subtitle=SUBTITLE Specify a sub-title for your Sculpin site. [default: "A Static Site Powered By Sculpin"]
--project-dir=PROJECT-DIR The project directory. [default: "."]
Help: The init command initializes a default site configuration.
๐ New for Alpha 4:
- โก๏ธ @lex111 has made great progress with updating sculpin's source code to use more PHP 7.x syntax and functionality.
- Attention: Sculpin extension developers - it would be helpful to check that your extension works with this alpha release's changes.
๐ New for Alpha 3:
- ๐ @lex111 found and fixed an issue with the
event_dispatcher
service not being public. - A little bit of syntax cleanup (
array()
to[]
)
๐ New for Alpha 2:
โก๏ธ A number of dependencies have been updated to the latest versions. This may introduce unexpected behaviour or deprecation notices in workflows that are not currently part of the test suite.
โก๏ธ Handling of the new
--output-dir
parameter has been modified. Bundles and extensions that rely onsculpin.output_dir
should be updated to use thesculpin.writer
service for writing to the proper output location.๐ง The temporary workaround for the
dflydev/dot-access-configuration
dependency in Alpha 1 has been removed.Alpha 1:
โก๏ธ A potential BC break to watch out for is a change in the URL format of interstitial "pagination" files. Bookmarks for "Page 2" and such may need to be updated.
- A gist can be found here with a concept for providing HTML-based redirects for legacy pagination files: https://gist.github.com/beryllium/a1b0be7b603486f5e39f869db8ff3484
๐ป This alpha version also includes the new "sculpin content:create" command, which allows you to generate a custom data type and associated templates straight from the command line:
Usage: content:create [options] [--] <type> Arguments: type Name for this type (e.g., "posts") Options: -b, --boilerplate Generate boilerplate/placeholder/template files. -t, --taxonomy=TAXONOMY Organize content by taxonomy categories ("tags", "categories", "types", etc) (multiple values allowed) Help: The content:create command helps you create a custom content type and, optionally, the associated boilerplate/templates.
Enjoy!
-
v3.0.0-rc1 Changes
November 16, 2018๐ This is Release Candidate 1 for Sculpin 3.0.0.
๐ New requirements for this version of Sculpin include PHP 7.2 or higher.
๐ As this is a Release Candidate, please help by filing GitHub issues if you notice any problems!
๐ New for Release Candidate 1:
- ๐ New
--source-dir
parameter to thegenerate
command ๐ New
init
command for initializing a bare-bones Sculpin configurationDescription: Initialize a default site configuration.
Usage: init [options]
Options: -t, --title=TITLE Specify a title for your Sculpin site. [default: "My Sculpin Site"]
-s, --subtitle=SUBTITLE Specify a sub-title for your Sculpin site. [default: "A Static Site Powered By Sculpin"]
--project-dir=PROJECT-DIR The project directory. [default: "."]
Help: The init command initializes a default site configuration.
๐ New for Alpha 4:
- โก๏ธ @lex111 has made great progress with updating sculpin's source code to use more PHP 7.x syntax and functionality.
- Attention: Sculpin extension developers - it would be helpful to check that your extension works with this alpha release's changes.
๐ New for Alpha 3:
- ๐ @lex111 found and fixed an issue with the
event_dispatcher
service not being public. - A little bit of syntax cleanup (
array()
to[]
)
๐ New for Alpha 2:
โก๏ธ A number of dependencies have been updated to the latest versions. This may introduce unexpected behaviour or deprecation notices in workflows that are not currently part of the test suite.
โก๏ธ Handling of the new
--output-dir
parameter has been modified. Bundles and extensions that rely onsculpin.output_dir
should be updated to use thesculpin.writer
service for writing to the proper output location.๐ง The temporary workaround for the
dflydev/dot-access-configuration
dependency in Alpha 1 has been removed.Alpha 1:
โก๏ธ A potential BC break to watch out for is a change in the URL format of interstitial "pagination" files. Bookmarks for "Page 2" and such may need to be updated.
- A gist can be found here with a concept for providing HTML-based redirects for legacy pagination files: https://gist.github.com/beryllium/a1b0be7b603486f5e39f869db8ff3484
๐ป This alpha version also includes the new "sculpin content:create" command, which allows you to generate a custom data type and associated templates straight from the command line:
Usage: content:create [options] [--] <type> Arguments: type Name for this type (e.g., "posts") Options: -b, --boilerplate Generate boilerplate/placeholder/template files. -t, --taxonomy=TAXONOMY Organize content by taxonomy categories ("tags", "categories", "types", etc) (multiple values allowed) Help: The content:create command helps you create a custom content type and, optionally, the associated boilerplate/templates.
Enjoy!
- ๐ New