基本概念css
在October系统中所构建的每个页面都是由Layout(布局)、Page(页面)、Partials(部件)和Content blocks(内容块)组成。最简单的状况就是只有一个Page也是能够的。html
Layouts函数
Layout定义了一个页面的结构。布局文件layouts/default.htm定义了页面的结构,以及在每一个页面上重复的部分,诸如HTML、Head和Body标签,样式表和JS文件引用。布局
在Demo主题中的菜单和页脚也是在布局中定义的。code
Pageshtm
页面保存了每个页面的内容。ip
页面文件pages/home.htm 定义页面URL(/当前页面)和页面内容。 页面在布局中渲染,这个函数“page”应该在布局代码中被调用:资源
{% page %}
为页面使用布局是可选的,您能够在页面文件中定义全部的内容,而不使用布局。 it
Partials渲染
包含了能够重复使用的HTML标记块。这些标记块定义在一个一个的单独的问题件中,能够被使用在任何地方。
Partials的渲染方式为:
{% partial "partial-name" %}
Partial文件能够放到Partials目录里面的任何文件夹下,好比:咱们将页脚的内容放到了partials/site/footer.htm这个partial里面了。 则引用的方法就是:
{% partial "site/footer" %}
Partials能够被pages、layouts或者其余的partials引用。没有限制。
Content Blocks
内容块是独立于pages、layouts的文本、可编辑的html代码块。
好比content/welcome.htm文件。 渲染格式以下:
{% content "content-name.htm" %}
Placeholders
placeholders容许Pages注入内容到Layout中。
通常状况下,是把js和样式表注入到layout的head标签中。placeholder在layout中定义,页面中执行注入操做。
Layout file:
<head> ... {% placeholder head %} </head>
Page file:
{% put head %} <link href="css/theme.css" rel="stylesheet"> <script src="js/script.js"></script> {% endput %}
Assets
存储的是诸如JavaScript, StyleSheet, images, fonts, 等 资源文件,固然也能够引入第三方包。