OctoberCMS-3-Theme

主题介绍主题定义了由October构建的网站或Web应用程序的外观和感觉。主题完全基于文件，可以使用任何版本控制软件进行管理。主题存储在项目主题目录的相应子目录中。主要包括以下几个部分：NameDescriptionPages网站的页面Partials可重用的HTML标签块Layouts定义页面的结构Content文件可以是文本，HTML代码和Markdown代码块，主要用于Page和布局。Assetfiles资源文件包括图片、样式表和JS脚本文件。主题目录结构每个主题都有一个单独的目录，只有活跃的主题才会显示在网站上。基本结构示例：themes/website/<===themedirectorypages/<===Pages（页面目录）home.htmlayouts/<===Layouts（布局目录）default.htmpartials/<===Partials(组件目录)sidebar.htmcontent/<===Content(内容目录)intro.htmassets/<===Assets(资源目录)css/my-styles.cssjs/images/激活主题的方式有a背景操作和修改配置文件有两种方式，修改config/cms.php文件中activeTheme的设置值。或者，采取后台设置，操作步骤为：设置-内容管理-前端主题-选择一个主题激活。子目录October支持单级子目录，包括Pages、Partials、Layouts、Content和Assets。这简化了大型网站的目录结构。themes/website/pages/home.htmblog/<===子目录archive.htmcategory.htmpartials/sidebar.htmblog/<===子目录category-list.htmcontent/footer-contacts.txthome/<===Subdirectoryintro.htm...引用子目录中的Partial文件或Content文件，格式为：{%name+path%}，例如：{%partial"blog/category-list"%}上面说了，介绍一个Partial组件，组件的位置和文件是：Partials/blog/category-list.htm。请注意，模板路径始终是绝对路径。在同一个Partial目录下，如果引用了同目录下的另一个Partial，还必须写完整的子目录名。模板结构Page、Partial、Layout对应的模板结构包括三部分：Configuration、PHPCode、Twigmarkup。每个部分由“==”分隔。url="/blog"layout="default"==functiononStart(){$this['posts']=...;}==

Blogarchive

{%forpostinposts%}

{{post.title}}

{{post.content}}{%endfor%}CONfigurationSection[配置部分]配置部分用于设置模板参数。具体的参数与不同的模板有关，根据类型的不同而有所不同。配置部分使用简化的“ini”格式，字符串参数值必须用双引号括起来。url="/blog"layout="default"[component]parameter="value"PHP代码（PHP代码部分）在每次渲染模板之前，先执行PHP代码部分。PHP代码是可选部分，可以省略。PHP代码可以使用代码开始和结束标签“”，这个标签只用于语法高亮。而且标记和==不在同一行。url="/blog"layout="default"====

Blogarchive

{%forpostinposts%}

{{post.title}}

{{post.content}}{%endfor%}PHP部分只能定义函数，允许使用引入命名空间。但除此之外，不允许使用其他PHP代码。url="/blog"layout="default"====access变量可以使用$this，通过data方法可以设置或读取变量，使用object方法只能读取变量的值。//通过array$this['foo']='bar'写入；//通过arrayecho读取$this['foo'];//通过objectecho只读$this->foo;Twig标记部分（TwigMarkupSection）Twig是一种灵活、快速和安全的PHP模板语言。Twig标记部分定义了模板要呈现的内容。在本节中，您可以使用October提供的函数、标志或过滤器。其内容取决于模板类型（页面、布局、部分）。主题日志记录主题日志记录是一个非常有用的特性，默认情况下是禁用的。由于布局和页面的内容存储在文件中，可能会出现内容丢失的情况，主题日志可以记录这些修改引起的变化。要启用主题日志记录，您可以转到设置-日志-日志设置-启用主题更改。设置完成后，保存设置，刷新页面即可在log-theme日志中看到，点击查看。