Difference between revisions of "Theme.liquid"
From Spiffy Stores Knowledge Base
m |
|||
(7 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
== Overview == | == Overview == | ||
− | The | + | The '''theme.liquid''' file is basically an HTML/XHTML file that contains liquid tags and provides the overall ''theme'' of the site. In this file, you will want everything that is normally included in a standard ''index.html'' page. |
For example, you will need | For example, you will need | ||
− | * A | + | * A Doctype specifying whether it's transitional or strict |
− | * A | + | * A Head tag |
− | * A | + | * A Body tag |
This file contains all the static elements of your site. | This file contains all the static elements of your site. | ||
− | You must include the following two lines somewhere within the file. | + | You '''must''' include the following two lines somewhere within the file. |
* head section: | * head section: | ||
Line 18: | Line 18: | ||
<pre> {{ content_for_layout }}</pre> | <pre> {{ content_for_layout }}</pre> | ||
− | The dynamic content | + | The dynamic content is provided by the other liquid templates and the result of rendering these templates is included at the position where you included the ''content_for_layout'' tag. |
− | + | Normally, you will want to specify javascript and stylesheet includes in the head tag of this file. | |
− | + | Here is an example of a javascript include tag with a liquid filter | |
− | {{ 'shop.js' | asset_url | script_tag }} | + | <pre>{{ 'shop.js' | asset_url | script_tag }}</pre> |
− | + | This is an example of a stylesheet include tag with a liquid filter | |
− | {{ 'shop.css' | asset_url | stylesheet_tag }} | + | <pre>{{ 'shop.css' | asset_url | stylesheet_tag }}</pre> |
=== Variables === | === Variables === | ||
− | + | In this file you have access to the following liquid variables: | |
− | * template | + | * [[Liquid Template Variables - template|template]] |
− | * handle | + | * [[Liquid Template Variables - page_title|page_title]] |
− | * shop | + | * [[Liquid Template Variables - handle|handle]] |
− | * cart | + | * [[Liquid Template Variables - shop|shop]] |
− | * collections | + | * [[Liquid Template Variables - cart|cart]] |
− | * linklists | + | * [[Liquid Template Variables - products|products]] |
− | * pages | + | * [[Liquid Template Variables - collections|collections]] |
− | * blogs | + | * [[Liquid Template Variables - linklists|linklists]] |
+ | * [[Liquid Template Variables - pages|pages]] | ||
+ | * [[Liquid Template Variables - blogs|blogs]] | ||
+ | * [[Liquid Template Variables - request|request]] | ||
+ | * [[Liquid Template Variables - cookies|cookies]] | ||
+ | |||
+ | == Further Reference == | ||
+ | |||
+ | * [[Liquid Basics]] | ||
+ | * [[Liquid Tag Reference]] | ||
+ | * [[Liquid Filter Reference]] | ||
+ | * [[Liquid Variable Reference]] | ||
+ | * [[Liquid Paginate Tag|Pagination ]] |
Latest revision as of 13:17, 25 June 2018
Overview
The theme.liquid file is basically an HTML/XHTML file that contains liquid tags and provides the overall theme of the site. In this file, you will want everything that is normally included in a standard index.html page.
For example, you will need
- A Doctype specifying whether it's transitional or strict
- A Head tag
- A Body tag
This file contains all the static elements of your site.
You must include the following two lines somewhere within the file.
- head section:
{{ content_for_header }}
- main content area:
{{ content_for_layout }}
The dynamic content is provided by the other liquid templates and the result of rendering these templates is included at the position where you included the content_for_layout tag.
Normally, you will want to specify javascript and stylesheet includes in the head tag of this file.
Here is an example of a javascript include tag with a liquid filter
{{ 'shop.js' | asset_url | script_tag }}
This is an example of a stylesheet include tag with a liquid filter
{{ 'shop.css' | asset_url | stylesheet_tag }}
Variables
In this file you have access to the following liquid variables: