Here is the standard project structure you'll see in DocPad projects:
documents/ for backwards compatibility)
files/ for backwards compatibility)
This directory contains anything that DocPad generates. Any new files added to the `src` directory will be found here after being rendered and written by DocPad. However any files that are deleted from the
src directory will not be deleted from the
out directory by DocPad, you have to delete them manually. So if you remove a file and it's still there remember to delete it manually. ;-)
This directory contains your website's source files. It contains your layouts, files to be rendered and be in the output and files that are not to be rendered but will still be in the output. The `src` can have the following folders:
render directory (also
documents for backwards compatibility)
static directory (also
files for backwards compatibility)
documents directories, and the
files directories, are merged; files appearing in either are rendered or copied to the output. However, you should use the former names rather than the latter to conform with the latest naming conventions.
Layouts work in a very similar way to files in
render, in that they are rendered and they support meta data. Unlike the files in
render, however, they are not output to the
out directory, as they only exist to wrap files in
render and other layouts within themselves. Layouts work in a nested fashion, with the desired layout being defined by the
layout meta data property within the child layout/document.
Layouts should include child content, which is done using the
content Template Data variable. For instance, the code to use the content variable with the [Eco](https://github.com/sstephenson/eco/) templating engine via the [Eco DocPad plugin](https://github.com/docpad/docpad-plugin-eco) would be `<%- @content %>`.