基本概念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, 等 資源文件,固然也能夠引入第三方包。