OctoberCMS官方文档 2-基本概念
October CMS    2018-10-22 18:54:42    55    0    0
emengweb   October CMS

基本概念

在October系统中所构建的每一个页面都是由Layout(布局)、Page(页面)、Partials(部件)和Content blocks(内容块)组成。最简单的情况就是只有一个Page也是可以的。

Layouts

Layout定义了一个页面的结构。布局文件layouts/default.htm定义了页面的结构,以及在每个页面上重复的部分,诸如HTML、Head和Body标签,样式表和JS文件引用。

在Demo主题中的菜单和页脚也是在布局中定义的。

Pages

页面保存了每一个页面的内容。

页面文件pages/home.htm 定义页面URL(/当前页面)和页面内容。 页面在布局中渲染,这个函数“page”应该在布局代码中被调用:

{% page %}

为页面使用布局是可选的,您可以在页面文件中定义所有的内容,而不使用布局。

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 %}
    
    
{% endput %}

Assets

存储的是诸如JavaScript, StyleSheet, images, fonts, 等 资源文件,当然也可以引入第三方包。

上一篇: October CMS官方文档 1-安装 (Setup)

下一篇: OctoberCMS官方文档 8-组件 (Components)

55 人读过
文档导航