主题
介绍
主题定义了October构建的网站或Web应用程序的外观。主题完全基于文件定义，可以使用任何版本控制软件管理。
主题存储在项目的themes目录的对应子目录中。主要包含以下部分：
名称 Description
Pages 网站的页面
Partials 可以重用的HTML标记块
Layouts 定义页面的结构
Content files 可以是文本，HTML代码和Markdown 代码块，主要用于与Page和Layout进行分开编辑维护。
Asset files 资源文件包含图片、样式表和JS脚本文件。
主题的目录结构
每个主题都有一个独立的目录，只有激活的主题才会显示在网站上。基本结构的例子：
themes/
website/ <=== 主题的目录
pages/ <=== Pages（页面目录）
home.htm
layouts/ <=== Layouts（布局目录）
default.htm
partials/ <=== Partials（部件目录）
sidebar.htm
content/ <=== Content（内容目录）
intro.htm
assets/ <=== Assets （资源目录）
css/
my-styles.css
js/
images/
激活主题的方式有后台操作和修改配置文件两种方式，修改config/cms.php文件中的activeTheme的设置值。或者，采取后台设置，操作步骤为：设置——内容管理——前端主题——选择一个主题激活即可。
子目录
October支持单层子目录，有Pages、Partials、Layouts、Content和Assets目录。这样简化了大型网站的目录结构。
themes/
website/
pages/
home.htm
blog/ <=== Subdirectory
archive.htm
category.htm
partials/
sidebar.htm
blog/ <=== Subdirectory
category-list.htm
content/
footer-contacts.txt
home/ <=== Subdirectory
intro.htm
...
要从子目录引用Partial文件或者Content文件，格式为：{% 名称 + 路径 %}，比如：
{% partial "blog/category-list" %}
上述表示，引入一个Partial部件，部件的位置及文件为：Partials/blog/category-list.htm。注意，模板路径总是绝对的，在同一个Partial目录中，引用同目录中的另外一个Partial，也必须写完整的子目录名称。
模板结构
对于Page、Partial和Layout他们所对应的模板结构，都是包含了三个部分：Configuration，PHP Code，Twig markup。各个部分之间通过 " == " 进行分割开来。
url = "/blog"
layout = "default"
==
function onStart()
{
$this['posts'] = ...;
}
==
<h3>Blog archive</h3>
{% for post in posts %}
<h4>{{ post.title }}</h4>
{{ post.content }}
{% endfor %}
COnfiguration Section 【配置部分】
配置部分用于设置模板参数，具体参数与不同的模板相关，因类型而不同。配置部分使用简化的" ini "格式，字符串参数值必须包含在双引号中。
url = "/blog" layout = "default" [component] parameter = "value"
PHP Code （PHP代码部分）
在模板每次渲染之前，PHP代码部分都是先执行。PHP代码是可选的部分，可以省略。PHP代码可以使用代码开始和结束标记"<? ?>"，这个标记仅仅是用于语法高亮。而且标记和==不在同一行。
url = "/blog"
layout = "default"
==
<?
function onStart()
{
$this['posts'] = ...;
}
?>
==
<h3>Blog archive</h3>
{% for post in posts %}
<h4>{{ post.title }}</h4>
{{ post.content }}
{% endfor %}
在PHP部分，只能定义函数，允许使用use引入名称空间。但是除了这些不允许其他PHP代码。
url = "/blog"
layout = "default"
==
<?
use Acme\Blog\Classes\Post;
function onStart()
{
$this['posts'] = Post::get();
}
?>
==
访问变量可以使用$this，通过数据方式可以设置或者读取变量，使用对象方式则只能读取变量的值。
// Write via array $this['foo'] = 'bar'; // Read via array echo $this['foo']; // Read-only via object echo $this->foo;
Twig Markup Section（Twig标记部分）
Twig是一个灵活,快速,安全的PHP模板语言。 Twig标记部分定义要由模板呈现的内容。在这个部分可以使用October提供的函数、标记或者过滤器。其内容取决于模板类型（page、layout、partial）。
主题日志记录
主题日志记录是一个非常有用的功能，默认情况下是禁用的。由于布局和页面的内容存储在文件中，可能会发生丢失内容的情况，主题日志记录可以将这些修改产生的变化都记录下来。
启用主题日志记录，可以进入设置——日志——日志设置——启用主题更改。设置完成后，保存设置，刷新页面则可以看见在日志——主题日志，点击可以查看。