The repository conventions

By convention, there are four well-known folders which contain resources with specific properties:

  1. /content/document contains textual resources that aren't directly served as they are, but assembled together to create a page. For instance, the main contents of a page, a blog post, etc. They can be processed (e.g. by expanding macros) before being used. Each resource in this section is not represented by a file, but by a folder that contains files.
  2. /content/media containd media resources (graphics, photos, movies, sounds) referenced by documents. They are served as they are. They can be processed before being used. Each resource in this section is represented by a single file.
  3. /content/library contains any kind of resource that needs to be served directly. Typically it contains CSS sheets, JavaScript scripts, and it's considered a best practice to copy in a subfolder entire products (such as JavaScript frameworks). It is ok for this folder to contain media pertinent to external frameworks, while media specific to the website should rather go into /content/library. Each resource in this section is not represented by a file, but by a folder that contains files.
  4. /structure contains a hierarchy of resources (here called nodes) each one representing an atomic entity of the site (typically a web page). Nodes are better described below, in any case each node is at least described by a layout and a set of properties.