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.