Site Information


Software/Libraries


Setup

‘Hello World’ GitHub Pages

Setup GitHub Pages respository.

Boilerplate Jekyll site

Replace ‘Hello World’ with a boilerplate Jekyll site.

  • Quick-start guide
    • Must remove index.html_ and README.md before executing jekyll new . inside local.jrockowitz.github.io.
  • Working With Github Pages
    • Add _site to .gitignore because Github maintains (and overwrites) this directory.

Commit and push changes to GitHub

cd local.jrockowitz.github.io
git add --all
git commit -am"Boilerplate Jekyll site"
git push
open http://jrockowitz.github.io/
# Refresh browser until GitHub regenerates your website.

Initial to Jekyll site

cd local.jrockowitz.github.io
edit _config.yml

Use NodeJs Package Manager (npm) to install Grunt and Bower.

# Setup and execute npm install
cd local.jrockowitz.github.io
edit package.json
npm install

# Add node_modules to .gitignore
cd local.jrockowitz.github.io
echo 'node_modules' >> ~/.gitignore

Use Bower to download jQuery and Bootstrap SASS.

cd local.jrockowitz.github.io
edit bower.json
bower install
  
- or -

cd local.jrockowitz.github.io
bower install jquery
bower install bootstrap-sass-official

Setup basic Grunt task runner

cd local.jrockowitz.github.io
edit GruntFile.json
grunt

Remove Jekyll’s Boilerplate SASS and HTML.

  • Clear _sass/base.scss and _sass/layout.scss.

  • Replace %vertical-rhythm mixin with margin-bottom: .5em; in _syntax-highlighting.scss

Integrate jQuery, Bootstrap, and main.js into Jekylly Boilerplate website.

Add this README.md file to site.

open http://jrockowitz.github.io/readme

Build a style-guide/code snippet page

  • Bootstrap: CSS
    Global CSS settings, fundamental HTML elements styled and enhanced with extensible classes, and an advanced grid system.

Setup Bootstrap Navbar

Setup Bootstrap Grid

Setup Navigation using Jekyll’s Data File and Collections

Set Contact Form using Formspree

Migrate Content into Jekyll

  • Write custom migration from Drupal 7 to Jekylly using Drush

Generate Thumbnails

Create Image Enlarge Modal

Responsive Grid for Image Thumbnails

Adjust Styles using Variables and CSS overrides

SEO


References

GitHub Pages

Jekyll

Liquid for Designers

Bootstrap

HTML/Front-end tools

Placeholders Images

Coding Guidelines/Standards


TODO

  • Editorial cleanup