Project Zeppelin allows you to setup awesome GDG DevFest site in 5 minutes.
Project is builded on top of Jekyll - simple, blog-aware, static site generator. Jekyll also happens to be the engine behind GitHub Pages, which means you can use Jekyll to host your website from GitHub’s servers for free. Learn more about Jekyll.
Template is brought by GDG Lviv team.
_config.yml
gh-pages
branchhttp://[your github name].github.io/zeppelin/
Or watch project presentation from GDG[x] Townhall meeting. Slides available here
Check if you have all requirments for local environment, install Jekyll server gem. Install GitHub pages
gem install github-pages
Run this command from project root folder:
jekyll serve -w
Site will be available at http://127.0.0.1:4000/zeppelin/ or http://localhost:4000/zeppelin/ (on Windows)
NOTE: in this mode all changes to html and data files will be automatically regenerated, but after changing _config.yml
you have to restart server.
Install the latest version of Compass. Ruby uses Gems to manage its various packages of code like Sass. In your open terminal window type:
gem install compass --pre
Then for combining media queries you can use Sass::MediaQueryCombiner plugin. Install with command
gem install sass-media_query_combiner
And for prefixing css3 properties use Autoprefixer
gem install autoprefixer-rails
Note: Also you need to install Node.js
To watch changes of .sass
files and compile it to the .css
on a fly change property safe: true
to safe: false
in _config.yml
.
Note: It works only on local machine, because GitHub runs Jekyll in --save
mode
Learn more about Sass development from documentation.
You can optimize images and minify css and javascript automaticaly (for now only on Windows).
But for Mac OS users available amazing tool - imageoptim. Thanks @raphaelsavina for link.
Optimize all images by running this script from /automation/images/
folder:
all_image_optimization.bat -d -jtran -pout -pquant -optip -gsicle -svgo
To minify CSS and JS run minify_all.bat
from /automation/minifying/
folder:
minify_all.bat
Learn more about available optimization options from documentation.
Quick-start guide is not enough? Checkout full documentation.
Going to use template? Go on! The only thing we ask - let us know at lviv@gdg.org.ua so we can include you to this list, or make a pull request.
Project is published under the MIT licence. Feel free to clone and modify repo as you want, but don't forget to add reference to authors :)