{"_id":"560b5d405148ba0d009bd0c9","project":"55a6e72e8cc73e0d00096635","user":"55a6caa022cfa321008e01d6","category":{"_id":"560b5cbec341310d00de2a01","pages":["560b5d0b3616ac17004f1c99","560b5d405148ba0d009bd0c9","560b5d62af40a70d003df332","560b5d953bcbd80d0077d0fd","560b5fa83616ac17004f1c9d","569c8c15d326c80d0068f7b7","56d37d35d3f4650b007495ea","56d4ed5f8001e30b0089700c"],"__v":8,"project":"55a6e72e8cc73e0d00096635","version":"55a6e72f8cc73e0d00096638","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-09-30T03:53:34.449Z","from_sync":false,"order":14,"slug":"templates-required-directory","title":"Templates Reference"},"__v":4,"version":{"_id":"55a6e72f8cc73e0d00096638","project":"55a6e72e8cc73e0d00096635","hasReference":false,"__v":29,"hasDoc":true,"createdAt":"2015-07-15T23:05:19.125Z","releaseDate":"2015-07-15T23:05:19.125Z","categories":["55a6e7308cc73e0d00096639","55b7ed07aea7c8190058badb","5604567c0c78b00d0039b191","5605e6f23a93940d002b3e4a","5605f2bba4574a0d00811365","5605f309a4574a0d00811366","5608e3b98aedf50d0004cf8f","5608e4318aedf50d0004cf90","5608e6b5a7cc2f0d00d9754d","5608e6d331beb60d001b6560","5608f879a7cc2f0d00d97580","560b097887b71d0d000d3bd9","560b13cbafa0990d00979545","560b5cbec341310d00de2a01","560b5cd0c341310d00de2a02","566a35b81e08750d00a0c49b","566a3e8503b4b20d00d02a4a","567889d307bf6a0d0083edc8","569c8b7c15bb390d00db6f9d","56b254dc65ddf50d0076ba8f","57a8ebc4cdeea20e001d2a63","57e48a4000c8680e00fae6e7","5808216773557d0f00a1e428","58105ad54a8aa50f00aa4cba","58105bf298aea40f00afa3ba","58105f548a4aed0f00d67536","581061b898aea40f00afa3be","584b3de7e5f3a42300df6ef7","596839a75965d400155bb750"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"parentDoc":null,"updates":["59b6e5b1962671003ac81d07"],"next":{"pages":[],"description":""},"createdAt":"2015-09-30T03:55:44.743Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"[block:html]\n{\n  \"html\": \"<A NAME=\\\"Layout-Subdir\\\"></a>The <span class=\\\"inline-code\\\">.../templates/layout/</span> subdirectory is where you assemble Handlebars resources to define your storefront site’s overall structure (header, footer, etc.). You can implement multiple layouts here for different use cases, making it easy to switch between different look-and-feel variations of the same theme.<br><br>\\n\\nAs prototypes, we have provided a minimal <span class=\\\"inline-code\\\">base.html</span> page in this subdirectory. To develop your theme, you can copy and/or modify this prototype.<br><p></p>\\n\\n<pre>&lt;theme-name&gt;       \\n└── templates\\n  ├── layout\\n  │   ├── base.html</pre>\\n\\n\\n\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"Be sure to set permission `755` (`drwxr-xr-x`) on any new subdirectories that you add. Also, be sure to set permission `644` (`rw-r--r--`) on any new files that you add. (Without these permissions, running your theme locally will fail with multiple error messages. Bundling your theme will also fail, blocking its upload to a store.)\\n\\nYou can use <a href=\\\"/docs/using-yaml-front-matter\\\">front matter</a> to specify resources <i>only</i> on pages in the <span class=\\\"inline-code\\\"><a href=\\\"/docs/pages-subdirectory\\\">.../templates/pages/</a></span> subdirectory, not on pages here in the <span class=\\\"inline-code\\\">.../templates/layout/</span> subdirectory. (If a front-matter directive contains an invalid option, Stencil CLI will silently ignore that option.)\",\n  \"title\": \"Required Permissions / Front-Matter Restrictions\"\n}\n[/block]","excerpt":"(Handlebars Assembly)","slug":"layout-subdirectory","type":"basic","title":"Layout Subdirectory"}

Layout Subdirectory

(Handlebars Assembly)

[block:html] { "html": "<A NAME=\"Layout-Subdir\"></a>The <span class=\"inline-code\">.../templates/layout/</span> subdirectory is where you assemble Handlebars resources to define your storefront site’s overall structure (header, footer, etc.). You can implement multiple layouts here for different use cases, making it easy to switch between different look-and-feel variations of the same theme.<br><br>\n\nAs prototypes, we have provided a minimal <span class=\"inline-code\">base.html</span> page in this subdirectory. To develop your theme, you can copy and/or modify this prototype.<br><p></p>\n\n<pre>&lt;theme-name&gt; \n└── templates\n ├── layout\n │ ├── base.html</pre>\n\n\n" } [/block] [block:callout] { "type": "warning", "body": "Be sure to set permission `755` (`drwxr-xr-x`) on any new subdirectories that you add. Also, be sure to set permission `644` (`rw-r--r--`) on any new files that you add. (Without these permissions, running your theme locally will fail with multiple error messages. Bundling your theme will also fail, blocking its upload to a store.)\n\nYou can use <a href=\"/docs/using-yaml-front-matter\">front matter</a> to specify resources <i>only</i> on pages in the <span class=\"inline-code\"><a href=\"/docs/pages-subdirectory\">.../templates/pages/</a></span> subdirectory, not on pages here in the <span class=\"inline-code\">.../templates/layout/</span> subdirectory. (If a front-matter directive contains an invalid option, Stencil CLI will silently ignore that option.)", "title": "Required Permissions / Front-Matter Restrictions" } [/block]