# Preview server
$ bundle install
$ npm install
$ jekyll serve
# Now browse to http://localhost:4000- https://help.github.com/articles/what-is-github-pages
- https://jekyllrb.com/docs/quickstart
- https://jekyllrb.com/docs/github-pages
- https://github.com/planetjekyll/awesome-jekyll
- http://www.stephaniehicks.com/githubPages_tutorial/pages/githubpages-jekyll.html
- https://www.smashingmagazine.com/2014/08/build-blog-jekyll-github-pages
- http://jmcglone.com/guides/github-pages
- http://jekyllthemes.org
- https://github.com/jekyll/jekyll/wiki/Themes
- https://help.github.com/articles/adding-a-jekyll-theme-to-your-github-pages-site
- http://www.jekyll-plugins.com
Jekyll is a static site generator that's perfect for GitHub hosted blogs (Jekyll Repository)
Jekyll Now makes it easier to create your Jekyll blog, by eliminating a lot of the up front setup.
- You don't need to touch the command line
- You don't need to install/configure ruby, rvm/rbenv, ruby gems
☺️ - You don't need to install runtime dependencies like markdown processors, Pygments, etc
- If you're on Windows, this will make setting up Jekyll a lot easier
- It's easy to try out, you can just delete your forked repository if you don't like it
In a few minutes you'll be set up with a minimal, responsive blog like the one below giving you more time to spend on writing epic blog posts!
- Install Jekyll and plug-ins in one fell swoop.
gem install github-pagesThis mirrors the plug-ins used by GitHub Pages on your local machine including Jekyll, Sass, etc. - Clone down your fork
git clone https://github.com/yourusername/yourusername.github.io.git - Serve the site and watch for markup/sass changes
jekyll serve - View your website at http://127.0.0.1:4000/
- Commit any changes and push everything to the master branch of your GitHub user repository. GitHub Pages will then rebuild and serve your website.
I've created a more detailed walkthrough, Build A Blog With Jekyll And GitHub Pages over at the Smashing Magazine website. Check it out if you'd like a more detailed walkthrough and some background on Jekyll. 🤘
It covers:
- A more detailed walkthrough of setting up your Jekyll blog
- Common issues that you might encounter while using Jekyll
- Importing from Wordpress, using your own domain name, and blogging in your favorite editor
- Theming in Jekyll, with Liquid templating examples
- A quick look at Jekyll 2.0’s new features, including Sass/Coffeescript support and Collections
✓ Command-line free fork-first workflow, using GitHub.com to create, customize and post to your blog ✓ Fully responsive and mobile optimized base theme (Theme Demo) ✓ Sass/Coffeescript support using Jekyll 2.0 ✓ Free hosting on your GitHub Pages user site ✓ Markdown blogging ✓ Syntax highlighting ✓ Disqus commenting ✓ Google Analytics integration ✓ SVG social icons for your footer ✓ 3 http requests, including your avatar
✘ No installing dependencies ✘ No need to set up local development ✘ No configuring plugins ✘ No need to spend time on theming ✘ More time to code other things ... wait ✓!
You can use the Quick Start workflow with other themes that are set up to be forked too! Here are some of my favorites:
- Hyde by MDO
- Lanyon by MDO
- mojombo.github.io by Tom Preston-Werner
- Left by Zach Holman
- Minimal Mistakes by Michael Rose
- Skinny Bones by Michael Rose
- Jekyll - Thanks to its creators, contributors and maintainers.
- SVG icons - Thanks, Neil Orange Peel. They're beautiful.
- Solarized Light Pygments - Thanks, Edward.
- Joel Glovier - Great Jekyll articles. I used Joel's feed.xml in this repository.
- David Furnes, Jon Uy, Luke Patton - Thanks for the design/code reviews.
- Bart Kiers, Florian Simon, Henry Stanley, Hun Jae Lee, Javier Cejudo, Peter Etelej, Ben Abbott, Ray Nicholus, Erin Grand, Léo Colombaro, Dean Attali, Clayton Errington, Colton Fitzgerald, Trace Mayer - Thanks for your fantastic contributions to the project!