Configuration

dest

Path to build the site into when run with henshin build. This can be a relative or absolute path. By default this is set to build/.

dest: different-folder

root

Sets the root path to serve the site at. This will build the site into a subdirectory and adjust all urls.

root: /blog

ignore

Any files or directories listed will be ignored. They will not be read by henshin.

ignore:
- some-file.txt
- a-picture.jpg
- secrets/

publish

Settings for publishing the site to a server. At the moment henshin can only use sftp.

publish: 
  host: sftp.example.com
  base: /path/to/public
  user: your_username

Henshin will prompt for your password when henshin publish is run.

permalink

Sets the style of permalink for posts. The tokens available are :year, :month, :day, :title. Default is /:title/index.html

permalink: /:year/:month/:day/:title.html

compress

Set whether to minify scripts and styles.

compress:
  scripts: false
  styles:  false

File Extensions

To pass settings to particular rendering engines set the option with the file extension used. For instance to allow autolinks in markdown files use (see docs for Redcarpet),

md:
  autolink: true