Documentation // ../

  1. Overview
  2. RSS/Atom/JSON
  3. Variable Types
    1. :partials
    2. $collections
    3. @variables
  4. Editing Templates
    1. Assets
    2. Templating Language
  5. Creating Pages
    1. Editing Content
  6. Download
  7. News & Updates
  8. Support
Stacey 2.3
Not backwards compatible

Stacey 3 is not backwards compatible with Stacey 2.3. This website serves as an archive because the old 2.3 documentation was not migrated to the github wiki (that is currently hosting the Stacey 3 documentation).

Now unmaintained, all technical support is now choppy and community led as github issues.

Template Editing

Stacey’s templates allow a mix of standard markup types & simple dynamic variables to help create your final pages.

They end up looking something like this:

...
<h1 class="col three">
  @name
  <strong>@profession</strong>
</h1>
<em class="col three">@email</em>
<hr>
:navigation
<div id="content" class="col eight">
  :category_lists
</div>
<hr>
<p class="col five">&copy; Copyright @name @current_year</p>
...

All of the templates sit within the /templates folder. Partial templates sit within /templates/partials, they are used for looping through collections of objects such as the images within a folder or sets of navigation. Screenshot of /templates folder

Read more about how partials work.

Template assignment

Templates are assigned to pages based off the name of the .txt file within the page’s folder. If no matches are found, stacey will return an error.

ie. if the /content/2.contact-me/ folder’s .txt file is named contact-page.txt, it will look for a matching template within the /templates/ folder, finding one named contact-page.html.

Template types

Templates do not need to be .html files. Stacey will recognise and serve correct content-type headers for templates with the following extensions:
.html, .json, .xml, .atom, .rss, .rdf & .txt

Public folder

If clean urls are enabled, any files (and folders) within the public folder will be served from the root of your website.

ie. /public/docs/css/screen.css will be accessible from http://yourdomain.com/docs/css/screen.css.

The public folder is generally where you store your css, javascript & any assets used within the templates.