By accessing the website and accepting the Cookie Policy, you agree to use the cookies provided by the Site in accordance with to analyze traffic, remember your preferences, and optimize your experience.
OctoberCMS官方文档 2-基本概念
October CMS    2018-10-22 18:54:42    57    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)

57 人读过
文档导航