Support

Changelog

Want to know what’s new with PieCrust? Check out the CHANGELOG.

General Support

If you have a problem with PieCrust, there are a few ways to solve it:

• Check the documentation one more time! You never know, the solution may be in there.
• Is the documentation wrong or missing something? If you know what must be fixed, you can get the source from BitBucket or Github and make a pull request.
• If you’re pretty sure you found a bug, please file a report on BitBucket or Github. If by chance you’ve already fixed it, even better! Make a pull request, you know the drill.
• If you have questions, hit the me on Twitter.

Upgrading PieCrust

Version 2 to 3

Several things have changed between version 2 and 3, and some of them introduce breaking changes.

Generated page templates

Previously, taxonomy listing pages had their template defined as a page with a special name. For instance, tag lists were by default defined by pages/_tag.html.

Now those page templates are proper templates, found in the templates directory (or other if you changed that). The tag list is now templates/_tag.html for instance.

In general, you should only have to move your template for the pages folder to the templates folder.

Generators

There is no more generators in the website configuration – everything is a content source. If you had custom generators in their, you will need to re-declare them as standard sources.

For example, a new taxonomy source would be defined like this:

site:
  sources:
    post_tags:
      type: taxonomy
      taxonomy: tags
      source: posts

In this example, tags is a taxonomy declared the same way as previously inside site/taxonomies, and posts is a normal page source declared also in the same way as previously.