silverstripe-themes / express
SilverStripe Express 默认主题
Requires
- composer/installers: *
- silverstripe-themes/module_bootstrap: dev-ssexpress
- silverstripe/cms: >=3.0
- silverstripe/express: dev-master
- silverstripe/framework: >=3.0
This package is not auto-updated.
Last update: 2024-09-14 13:58:17 UTC
README
本主题基于Twitter的Bootstrap,并设计用于与SilverStripe Express配合使用,可在以下位置找到
https://github.com/silverstripe-labs/silverstripe-express
它本身不是一个完整的主题,而是提供工具和UI功能,以便您能够快速在SilverStripe平台上构建网站。
您可以选择使用SCSS文件(推荐),或使用CSS。您需要获取模块bootstrap并将其放置在主题目录的根目录下。
https://github.com/silverstripe-ux/sass-twitter-bootstrap.git
SCSS/SASS
Sass(Syntactically Awesome Stylesheets)是一种预处理器样式表语言,编译为CSS。Sass为CSS3添加了嵌套规则、变量、混合、选择器继承、函数等有用功能。SCSS是Sass的基于CSS语法的语法。
Sass使用Ruby gem进行编译。如果您之前没有使用过Sass,您可能需要安装相关gem(在终端中:sudo gem install sass && gem install compass)。SCSS是使用CSS语法的Sass形式
有关如何使用SCSS和完整API文档的更多信息,请参阅
Bootstrap
Twitter Bootstrap是一个免费的工具集,用于创建网站和Web应用程序。它包含基于HTML和CSS的设计模板,用于排版、表单、按钮、图表、导航和其他界面组件,以及可选的JavaScript扩展。Bootstrap最初是用Less编写的,但已移植到SCSS。Express使用Bootstrap的SCSS端口。有关Twitter Bootstrap API的更多信息,请在此处查看
http://twitter.github.com/bootstrap/
如果您之前没有使用过Bootstrap,该网站是一个好的起点。它是使用SilverStripe Express主题构建网站时的宝贵资源。
Compass
Compass是一个开源的CSS创作框架。为了保持简单,我们仅对Compass框架进行了轻微的使用(以便在IE9中使用渐变)。但是,如果您想使用Compass提供的更多功能,只需在相关SCSS文件顶部导入您感兴趣的库。
有关Compass的更多信息,请在此处查看
Flexslider
Flexslider是一个基于jQuery的完全响应式轮播,具有易于使用且功能丰富的API。有关如何使用此滑块的详细信息,请访问网站
http://www.woothemes.com/flexslider/
相关的包含文件如下(从您的网站根目录)
- themes/express/scss/bootstrap_config/custom/_carousel.scss
- themes/express/js/lib/jquery.flexslider.js
- themes/express/js/express.js(初始化滑块)
- themes/express/templates/Includes/Carousel.ss
我们选择在SilverStripe Express中使用这个代替Bootstrap轮播,因为我们发现默认的Bootstrap轮播没有提供我们需要的工具,以便轻松为客户端定制轮播。
根据您的需求,您可能做出不同的选择。所有用于处理Bootstrap轮播的工具仍然可用。要切换回
- 在 themes/express/scss/bootstrap_config/_bootstrap.scss 中,将 '@import "custom/carousel"' 替换为 '@import "../../../module_bootstrap/lib/carousel"'。或者,将module_bootstrap中的SCSS文件复制到custom文件夹以覆盖flexslider CSS。
- 在您的网站上包含Bootstrap JavaScript(例如'themes/module_bootstrap/js/bootstrap-carousel.js'),并删除flexslider JavaScript。
- 编辑 themes/express/templates/Includes/Carousel.ss 以匹配正确的 Twitter Bootstrap 标记
- 将 express.js 中的 flexslider 初始化替换为相关的 Bootstrap 初始化(见:http://twitter.github.com/bootstrap/javascript.html#carousel)
错误和问题
使用 GitHub issues 跟踪主 silverstripe-express 模块的错误和问题
https://github.com/silverstripe-labs/silverstripe-express/issues
贡献
请参阅 http://doc.silverstripe.org/framework/en/trunk/misc/contributing/code