How to configure carew?

You can configure carew thanks to config.yml file. This file should be in the root directory. Here is a sample:

site:
    title:        Carew
    description:  The tiny website generator
    author_name:  Grégoire Pineau
    author_email: lyrixx@lyrixx.info
    author_url:   http://gregoirepineau.fr

engine:
    themes:
        - %dir%/vendor/lyrixx/my-theme-bootstrap
        - %dir%/vendor/carew/theme-bootstrap
    core_extensions:
        toc: true # Generate a table of content
        feed: true # Generate atom feed
    extensions:
        - Carew\Plugin\Sami\SamiExtension
    post_permalink_format: "%year%/%slug%.html"

Site section#

Most values under the site section are default values for your layout. Each values are available in your template with the following syntax:

{{ carew.site.decription }}
{# render: The tiny website generator #}

Engine section#

Themes and plugins#

The engine section is used to configure carew's internal. Learn more about theming and about extension in dedicated chapters.

Blog post url format#

You can also configure the url generated by carew for your blog posts:

engine:
    post_permalink_format: "blog/%year%/%slug%.html"

With this configuration, a file named 2010-10-12-foobar.md will have the following URL: blog/2010/foobar.html.

Available placeholders: