Changes should be commited to src/ files only.
The template is built with Sass and Gulp build system with these features:
- Handlebars HTML templates with Panini– Panini is a super simple flat file generator for use with Gulp. It compiles a series of HTML pages using a common layout. These pages can also include HTML partials, external Handlebars helpers, or external data as JSON.
- Sass compilation, prefixing with Autoprefixer, and JavaScript concatenation
- Built-in BrowserSync server - Will automatically reload your page when files are changed. It also live-injects CSS changes when you save a Sass file. This task runs continuously. Defaults to localhost.
- For production builds - CSS compression, JavaScript compression, Image compression and more..
To use this template, your computer needs:
- Node.js is used to run the build processes. https://nodejs.org/en/download/
- Test: run
node -vin the terminal - Npm (Node comes with npm installed so you should have a version of npm.) Used to manage development dependencies.
- Test: run
npm -vin the terminal - Gulp – task runner
npm install -g gulp - Test: run
gulp -vin the terminal
- Install all node packages:
npm install(oryarn install --ignore-engines) - Run
gulp dev - Your site is now viewable at this URL: http://localhost:3000
dist/- compiled distribution filesnode_modules- front-end dependenciessrc/- contains all of your core, working files—static assets, pages, templates, etcsrc/assets/- scss files, JS files, images, and fonts are heresrc/data/- external datasrc/layouts/- HTML layouts templatessrc/pages/- site pagessrc/partials/- handlebars partials files.gulpfile.js- all task definitionspackage.json- handles the front-end dependencies.htmllintrc- handles the HTML lint rules.sass-lint.yml- handles the SCSS lint rulesreports- txt generated file for accessibility issues
- gulp-autoprefixer
- gulp-compile-handlebars
- gulp-concat
- gulp-html-replace
- gulp-htmllint
- gulp-imagemin
- gulp-pretty-html
- gulp-remove-code
- gulp-remove-logging
- gulp-rename
- gulp-sass
- node-bourbon
- gulp-sass-lint
- gulp-sourcemaps
- gulp-uglify
- gulp-newer
- gulp-accessibility
- gulp-jshint
- gulp-gulp-gh-pages
- gulp-babel
- panini
- run-sequence
- ansi-colors
- fancy-log