documents/, for backwards compatibility)
files/, for backwards compatibility)
sourcedirectory will be found here after being rendered and written by DocPad. However any files that are deleted from the
sourcedirectory will not be deleted from the
outdirectory by DocPad, you have to delete them manually. So if you remove a file and it's still there remember to delete it manually. ;-)
sourcecan have the following folders:
documents, for backwards compatibility, for backwards compatibility))
documentsdirectories, and the
filesdirectories, 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.
render, in that they are rendered and they support meta data. Unlike the files in
render, however, they are not output to the
outdirectory, as they only exist to wrap files in
renderand other layouts within themselves. Layouts work in a nested fashion, with the desired layout being defined by the
layoutmeta data property within the child layout/document.
source/render/hello.ext1.ext2.ext3is rendered from
ext2, then from
ext1, resulting in the file
out/script.jsor writing a blog post that renders from Markdown to HTML with the document
script.jsis that such a convention would eliminate the ability to combine extension renderings, also because ambiguity between extensions that can be rendered in multiple ways. For instance the
renderis that they support meta data. Meta data goes at the top of a document and defines information about that particular document. For instance, its title, date and layout are good examples. Meta data is not restricted to particular values, meaning you can define whatever meta data you want against a document. There are some special meta data properties, however, that perform certain functions (e.g.,
layoutis used to specify the layout that should be used to wrap the document). You can find the complete listing of special meta data properties on the Meta Data page.
render, are output to the