Jekyll + GitHub Pages

Lunch n' Learn Presentation for my team at Rackspace

Transcript

1. JEKYLL + GITHUB PAGES LUNCH N’ LEARN 2016.09.14 ERIC CARRAWAY
2. LUNCH N’ LEARN - 2016.09.14 TOPICS ▸ Jekyll installation and setup ▸ free hosting via GitHub Pages ▸ configuring CNAME and DNS for a custom domain name ▸ convention-based directory structure ▸ working with markdown and YAML front matter ▸ theming and SASS ▸ pushing changes to a live website from the command line
3. LUNCH N’ LEARN - 2016.09.14 WHAT’S JEKYLL? ▸ Jekyll is a static-site-generator ▸ Jekyll uses Ruby * ▸ Jekyll converts Markdown to HTML
4. LUNCH N’ LEARN - 2016.09.14 WHY JEKYLL? ▸ Because WordPress ▸ Many blog/marketing/portfolio sites… ▸ … do not require a back end or database ▸ … can be “static” ▸ Simplicity and ease-of-use
5. LUNCH N’ LEARN - 2016.09.14 WHAT’S GITHUB PAGES? ▸ It’s built in to every GitHub repo ▸ via a gh-pages branch ▸ It’s built in to every GitHub account ▸ via a repo named <username>.github.io
6. LUNCH N’ LEARN - 2016.09.14 WHY GITHUB PAGES? ▸ Because WordPress ▸ IT’S FREE ▸ Simplicity and ease-of-use ▸ Version-control and deployment are built-in ▸ git push origin master beats FTP
7. INSTALLATION AND SETUP http://jekyllrb.com/
8. HOW DOES FREE HOSTING WORK? https://pages.github.com/
9. HOW DO YOU CONFIGURE A CUSTOM DOMAIN NAME? CNAME at the root of your repo DNS settings with your registrar
10. https://pages.github.com/ READ THE DOCS
11. at your domain registrar…
13. Setup for GitHub Pages Create a branch called gh-pages
15. SHOW AND TELL http://ericcarraway.com/ http://5pointspercussion.org/
17. LUNCH N’ LEARN - 2016.09.14 SHOW AND TELL ▸ GitHub repo ▸ File structure ▸ History ▸ Issues as a lightweight project management tool ▸ Pull requests ▸ DEMO: git push origin master
18. CONVENTION-BASED DIRECTORY STRUCTURE Perhaps because the Ruby community leans towards convention over configuration
19. WORKING WITH MARKDOWN “The ideal first programming language” - Andrew
21. WORKING WITH YAML FOR DATA AND CONFIGURATION _config.yml 5points/_data/staff.yml
22. https://www.youtube.com/watch?v=e91Wi0olMAw
23. THEMING AND SASS .scss files ericcarraway.github.io/pages/about/index.scss
25. HTTP://SANDWICHCLUB.IO Work-in-progress Contributions welcome! https://github.com/ericcarraway/sandwich-club