Bootstrap 3 with Sass support
- Why another Bootstrap theme? -- This theme is built with Sass support.
- Why Bootstrap 3 and not Bootstrap 4? -- Because v3 is last stable and v4 is still alpha version.
Features
- automatically compiling Sass files
- dependencies managed by Yarn and Bower
- Font Awesome and Font Lato included
- prepared theme config file
- no other plugin dependency
About
Bootstrap 3 Sass theme is made with bootstrap-sass library, which is official Sass port of Bootstrap 3 framework by Twitter.
Sass compiling
Sass compiling is fully automatic. Just make change at your Sass files, save and reload your website.
For local development be sure, that you have cms.enableAssetDeepHashing
config set to true
!
At production you can set cms.enableAssetMinify
to true
for assets minification.
Configure Bootstrap
You can find main file at /assets/sass/site.scss
. This is the place where you should import all Sass files.
Bootstrap Sass components are imported at /assets/sass/_settings.scss
- just uncommend component you need. Always use only component you really need to make your CSS smaller and your sites faster.
Bootstrap JS components are linked at the bottom of layout /layouts/default.htm
. Please comment/delete lines you don't need.
At /assets/sass/_settings.scss
you can find all Bootstrap configuration variables which can be changed. It's also great place for your own variables. It will override default Bootstrap variables, so it's means you always compile customized version of Bootstrap!
Theme variables
Theme config file is placed at /fields.yaml
. Just add your own variables and use it in the theme:
{{ this.theme.site_title }}
Variables can be changed at Backend > CMS > Themes > Customize.
Add new font
- place your font to
/assets/fonts
directory - create new Sass file at
/assets/sass/fonts
- import this font Sass file to
/assets/sass/site.scss
like this:
@import "fonts/font-awesome";
Updating
You can update theme dependencies by yourself, but it's not neccesary.
- update npm by
yarn update
ornpm update
- update assets by
bower update
-
Petr Vytlačil
Found the theme useful on 13 Oct, 2017
Do you have problem with? An exception has been thrown during the rendering of a template ("file_exists(): open_basedir restriction in effect. File(../../assets/vendor/bootstrap-sass/assets/stylesheets/bootstrap/variables.scss) is not within the allowed path(s)
Files has prefix _variables.scss its ok when buid by GULP etc. but OctoberCMS cant it?
THX
-
Vojta Svoboda author
Replied on 13 Oct, 2017
Wow, this is weird, I never seen exception like that. I tried fresh installation now, with build 424 and works well. Maybe your PHP settings is too strict? Let me know at vojtasvoboda.cz(at)gmail(.)com
-
1.0.1 |
Move assets to repository Dec 28, 2016 |
---|---|
1.0.0 |
First version of Bootstrap 3 Sass theme Nov 15, 2016 |