Skip to content

Latest commit

 

History

History
135 lines (99 loc) · 7.15 KB

README.md

File metadata and controls

135 lines (99 loc) · 7.15 KB
Raw

Project Zeppelin / GDG DevFest 2014 site template

About

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.

Live demo http://gdg-x.github.io/zeppelin/

Features

  • Easy to setup
  • Simple and responsive design
  • Integrated speakers and sessions management
  • SVG icons
  • SEO friendly

Quick-start guide

  1. Fork this repo
  2. Clone locally
  3. Update _config.yml
  4. Select what content blocks do you need
  5. Push changes to gh-pages branch
  6. Enjoy your awesome DevFest site at http://[your github name].github.io/zeppelin/

Or watch project presentation from GDG[x] Townhall meeting. Slides available here

Local development

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.

Sass(Compass) support

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.

Resource optimizations (optional)

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.

Documentation

Quick-start guide is not enough? Checkout full documentation.

TODO List

  • Optimization scripts for mac and linux

Known issues

  • Scrolling on open navbar

Used libraries

Who is using template?

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.
GDG DevFest Ukraine 2014 GDG DevFest Istanbul 2014 GDG Bangalore Site
GDG DevFest Omsk 2014 2014 南阳 GDG Devfest 大会 DevFest Nordeste 2014
GDG DevFest The Netherlands DevFest Centro-Oeste 2014 Android DevFest Space Coast
DevFest SP 2014 DevFest in Baroda GDG Hi Pic (France)
GDG DevFest Córdoba 2014 GDG DevFest Düsseldorf 2014 GDG Makerere DevFest 2014
GDG Dublin DevFest 2014 GDG Busitema DevFest 2014 DevFest Vienna 2014
Android Wear DevFest GDG SLAU DevFest 2014 Lima DevFest
GDG Korea DevFair 2014 GDG DevFest Kota Kinabalu 2014 GDG DevFest Belgium
DevFest Praha 2014 GDG DevFest Kosice GDG DevFest Cagayan de Oro
DevFest Birgunj GDG DevFest Poland GDG DevFest Silicon Valley
DevFest Chennai 2014 GDG DevFest Bari GDG DevFest Ahmedabad
GDG DevFest Sri Lanka GDG DevFest Tunis GDG DevFest Kozhikode
GDG DevFest Argentina GDG DevFest Bhubaneswar GDG DevFest Miage Gi
GDG DevFest NORTE GDG Devfest Nyeri 2014 GDG DevFest Paris
GDG Akure

Contributors

Licence

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 :)