You can import content from a PieCrust 1.x website with:
chef import piecrust1 /path/to/old/piecrust/website
Most of the content will be converted, but some things will still require some manual fixes – see below.
Upgrading a website
As with all other
chef importcommands, this will import all the content from the old site into the current site. However, you may pass the
--upgradeparameter instead of a path to a site directory to upgrade the old site “in-place”:cd /path/to/old/piecrust/website chef import piecrust1 --upgrade
Instead of copying and converting content into a different folder, it will edit your files directly. Obviously, you need to make sure you have a backup, or that your website is stored in a revision control system.
If you were using custom date formats, either in the site configuration or through Twig filters, you’ll have to convert them from PHP date formats to Python date formats.
Note that if you need an RFC 2822 date format, you can use the
Jinja as the template engine. And if you need an RFC 3339 date format (e.g.
for XML output like RSS and Atom feeds) you can use the
If you were using Twig plugins to add tags, filters, and functions, you’ll have to find their equivalent in Jinja.
Clean up the asset folder
PieCrust 1.x had all assets at the website root, mixed with the special
_content folder. This meant that if you had some files that weren’t supposed
to be baked with the site, you had to exclude them using the
baker/skip_patterns site configuration setting.
PieCrust 2 cleans that up a lot by having all the content at
the root, but all the assets in an
asset folder. So if you have files that you
don’t want to bake, just put them somewhere else than the
However, because PieCrust has no way of knowing what’s what, it will, during
import, copy everything into the
asset folder, and convert the
baker/skip_patterns setting to
Once the import process is complete, you’re encouraged to move anything that
shouldn’t be part of the bake out of the
assets folder, and to remove the
ignore patterns. It’s not required, but it will make your website a