Skip to content

Latest commit

 

History

History
82 lines (65 loc) · 3.09 KB

README.md

File metadata and controls

82 lines (65 loc) · 3.09 KB

Stub Middleman Kit

This is an Middleman static websites framework with Gulp as automatic workflow.

A Starter Kit for front-end development, it contains:

  • Middleman Build static websites with an easy-to-use framework
  • Gulp for asset bundling (JS/CSS/Fonts/Sass/images) with Browser-sync
  • Browser-sync Keep multiple browsers & devices in sync when building websites
  • Babel 6 for EcmaScript 2015 / ES6 support
  • PostCSS PostCSS is a tool for transforming styles with JS plugins
  • CSSnano Minify CSS with cssnano
  • UglifyJS A JavaScript parser, minifier, compressor or beautifier toolkit
  • Imagemin Minify PNG, JPEG, GIF and SVG images
  • pngquant Lossy PNG compressor
  • Normalize A modern, HTML5-ready alternative to CSS resets
  • Slim as a template engine for app views
  • gulp integration through middleman's external asset pipeline

Architecture

name-project/
├── dist/
│    └── ...
│
└── source/
     ├── images/
     │
     ├── javascripts/
     │      └── all.js
     │
     ├── layouts/
     │      └── layout.slim
     │
     ├── stylesheets/
     │      ├── base/
     │      ├── components/
     │      ├── helpers/
     │      ├── layout/
     │      ├── pages/
     │      ├── themes/
     │      ├── vendor/
     │      └── all.scss
     │
     └── index.html.slim

Installation Stub Middleman Kit

Using templates with Middleman is incredibly easy, you just need to reference the repository for the template in the --template flag when you call middleman init. It looks like this:

middleman init name-project --template=stub4ever/stub-middleman-kit

Once you have the middleman project you will need to install the npm dependencies. You will need Node.js and npm on your system.

cd name-project
npm install

Now you can simply run $bundle exec middleman. This will start the BrowserSync proxy and it will open for you. You can then edit your stylesheets, images, javascript and slim. Your browser will automatically reload on all devices.

Deploy A Static Build

After building the site you have everything you need within the build-directory. There are nearly limitless ways to deploy a static build. A very handy tool to deploy a build is running:

middleman build

Contributing

If you have problems, please create a GitHub Issue. Have a fix or want to add a feature? Pull Requests are welcome!