Usage

There are several ways Pretzel can be used, with corresponding commands

Create

Usage: pretzel create Options:

• --template=liquid or --t=liquid. Defines the template engine to use. Only liquid and razor are supported. Default: liquid.
• --directory=c:\MySite or --d=c:\MySite. Defines the path to site directory to process.
• --withproject. If presents includes a layout VS Solution, to give intellisence when editing razor layout files.
• --wiki. If presents creates a wiki instead of a blog (razor template only).

Create is for creating a site based on one of the available boilerplates. The default is the blog using liquid engine.

Bake

Usage: pretzel bake
Options:

• --template=liquid or --t=liquid. Defines the template engine to use. Only liquid and razor are supported. Default: liquid.
• --directory=c:\MySite or --d=c:\MySite. Defines the path to site directory to process.
• --drafts. Add the posts in the drafts folder.
• --cleantarget. Deletes the target repository (_site by default).

Bake is for a once-off generation of the site.

Taste

Usage: pretzel taste
Options:

• --template=liquid or --t=liquid. Defines the template engine to use. Only liquid and razor are supported. Default: liquid.
• --directory=c:\MySite or --d=c:\MySite. Defines the path to site directory to process.
• --port 5000 or --p 5000. Sets port to custom value; Default: 8080.
• --nobrowser. Do not launch a browser.
• --cleantarget. Deletes the target repository (_site by default).

Taste is for testing a site locally using a browser - make a change, and Pretzel should detect the file changes and regenerate the site.

Import

User: pretzel import Options:

• --import=wordpress or --i=wordpress. Defines the format of the file to import. Supported values are wordpress and blogger.
• --file=import.xml or --f=import.xml. Defines the file to import.
• --directory=c:\MySite or --d=c:\MySite. Defines the path to site directory to add the files.

Import is for importing an existing blog to pretzel files.