Fragments

Each folder within the Content directory (including the Content folder itself), may contain fragments of text or images. These fragments are compiled into a list, and then used to output HTML (using a fragment template). Usually one fragment will only appear on one page, however they can be reused or selectively quoted on other pages.

Info fragments

Some text fragments are named with .info extensions rather than .txt as is normal. These fragments are there to provide information about the page or the website as a whole, and are not listed or used for HTML directly. The two kinds of fragments are :

• site.info – always at the root level, specifies a few keys used by the application and in the templates
• page.info – inside each page (optionally) there can be a page.info file specifying page title, sort order, short title and any other attributes you wish to give each page.

Folders

Folders within the Content directory are usually analogous to folders in the website structure. For example :

Content/gallery/ maps to
http://your.site.com/gallery/index.html on your website.

Thus normally a folder will be created in the website directory and produce just one web page called index.html, which is placed inside that folder. The special page.info fragments noted above are used to set the title of the page, which order it sorts in, and any other special information or fields that you would like to add to each page. For example, you could add a ‘javascript’ field to each page and then put a snippet of javascript into the template if this field had contents.

Page folders

Content folders may also be named with a .page extension, which means they will produce a page but no folder in the output. So if a page was at Content/gallery.page, the output website folder would contain gallery.html at the root level, rather than a gallery folder containing an index. This is useful if you prefer to have lots of named pages inside each folder, rather than a single index per folder.