Directory Structure

The directory to be processed must contain a directory named content and a directory named templates. SSG builds your website in a directory named public which will be found alongside these two directories. Orphaned files from previous SSG runs are not deleted from public; if you wish to clean up these orphans, just delete public and SSG will create it afresh on the next run.

Apart from files with the suffix .page and directories containing a file named .ignore, the contents of content are copied wholesale to public, including most file metadata — the content directory is effectively a template for the entire website, with .page files used as placeholders. Thus content should be structured exactly as you wish your final website to be structured, anticipating that .page files will be replaced with processed files.

You can structure the templates directory however you like. The templates are referenced as relative paths from this directory.

content, templates, .ignore and the .page suffix constitute pretty much all the magic filenames that SSG uses. The only addition is that index.page has a default weight of None (see Page Files).