nodepub/theme-engine

使用Twig构建的主题引擎,用于创建可定制和可继承的网站主题

dev-master 2014-02-11 22:33 UTC

This package is not auto-updated.

Last update: 2024-09-24 01:51:15 UTC


README

使用Twig构建的简单网站主题引擎。

每个主题都有一个命名空间,并且主题可以从其他主题继承模板。

包含Silex Service Provider。

定义主题

主题是一组twig模板、css、js和图像的集合。每个主题都有一个包含主题元数据的config.yml文件,并定义主题的可定制设置。

config.yml

  • css
  • js
  • images layout.twig

Twig函数

theme_styles:渲染当前主题CSS的style标签。默认情况下,主题配置的CSS将被压缩成一个单一文件。这可以被关闭,以便为每个配置的JavaScript文件渲染单独的script标签。

theme_javascripts:渲染当前主题JavaScript文件的script标签。默认情况下,主题配置的JavaScript文件将被压缩成一个单一文件。这可以被关闭,以便为每个配置的JavaScript文件渲染单独的script标签。

theme_icons:如果当前主题中定义了favicon和apple touch图标,则渲染favicon和apple touch图标meta标签

所有twig模板都可以访问一个网站对象。

site.title site.name site.tagline site.description

资源压缩

CSS和JavaScript文件默认会被压缩,因此每个主题将只有一个CSS文件和一个JavaScript文件。可以通过设置$app['np.theme.minify_assets']为false来关闭压缩。

主题定制

大多数主题都有可定制的设置,用于更改主题的外观和样式。这些设置定义在主题的config.yml文件中

设置类型

  • 字体
  • 颜色
  • 背景颜色
  • 背景图像

主题切换