Documentation

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

Variables

Within the templates files, apart from our standard html, we also have access to any variables defined within the .txt file that corresponds to the current page. These can be accessed by using an @ symbol followed by the key.

ie. @title

In addition, any variables defined in /content/_shared.txt are available within all template files.

Stacey-created variables

These are created for each page within the site.

@root_path
Will output a relative path from the current page to the root of the site. ie. in /projects/project-name/@root_path will contain ../../.
@thumb
Outputs the relative url to the thumbnail for this page (if one exists).
@url
Outputs the relative path to this page from the page currently being viewed (ie. ../../projects/project-1).
@permalink
Outputs the absolute url path of the current page (ie. projects/project-1).
@slug
Outputs the slug of the current page (ie. project-1).
@is_current
Returns true if @permalink matches the server’s request uri.
@is_first
Returns true if current page is the first in its collection.
@is_last
Returns true if current page is the last in its collection.
@page_name
Outputs the name of the current page. This is constructed by converting the page’s slug into title-case text (ie. test-project-1 becomes Test Project 1).
@siblings_count
The number of pages sitting at the same level as this page (ie. 12).
@children_count
The number of children below this page (ie. 12).
@index
The number of the current page, relative to the other pages sitting at the same level (ie. 5).
@current_year
Will output the current year.
@domain_name
Will output the domain name of the current site (ie. staceyapp.com).
@base_url
Will output the domain name & folder path stacey is running from (ie. staceyapp.com/stacey).
@site_updated
Will output the date the site was last edited in the RFC 3339 format (ie. 2009-12-12T17:34:23+11:00).
@updated
Will output the date the current page was last edited in the RFC 3339 format (ie. 2009-12-12T17:34:23+11:00).
@stacey_version
Will output the version of stacey you are running (ie. 2.0).

Text-file variables

These variables can be used from within your text files.

@path
Will output the full file system path to the current page. (ie. /content/3.about)
@bypass_cache
If set, this will bypass stacey's caching mechanisms for this page.