Go to file
Barry Clark 4df1021d59 Resize the image on the 404 page 2014-06-13 09:23:03 -04:00
_includes Moved SVG icon markup to an include 2014-06-13 08:59:59 -04:00
_layouts Moved SVG icon markup to an include 2014-06-13 08:59:59 -04:00
_posts Extra / in Hello World image reference 2014-06-02 21:42:24 -04:00
images Resize the image on the 404 page 2014-06-13 09:23:03 -04:00
scss Give the comments some breathing room 2014-06-11 09:07:22 -04:00
.gitignore Include site name in header 2014-02-07 08:36:03 -05:00
404.md Resize the image on the 404 page 2014-06-13 09:23:03 -04:00
CNAME Removing everything from the CNAME file 2014-05-25 18:54:28 -04:00
Gruntfile.js First commit of base theme. 2014-02-06 19:18:00 -05:00
LICENSE Removed license from readme 2014-03-02 10:53:37 -05:00
README.md Adding screenshot of the theme into the readme 2014-06-13 08:52:46 -04:00
_config.yml ups, no trailing slash in baseurl 2014-06-02 22:04:36 -04:00
about.md Removed license from readme 2014-03-02 10:53:37 -05:00
feed.xml Corrected post linked in feed.xml 2014-06-03 19:37:23 -04:00
index.html Don't need the / 2014-06-02 21:29:46 -04:00
sitemap.xml Added sitemap.xml 2014-05-17 18:22:27 -04:00
style.css Give the comments some breathing room 2014-06-11 09:07:22 -04:00

README.md

Jekyll Now

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 dependancies like markdown processors, Pygments, etc
  • 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 (Theme Demo) giving you more time to spend on making your blog awesome!

Jekyll Now Theme Screenshot

Quick Start

Step 1) Fork Jekyll Now to your User Repository

Fork this repo, then rename the repository to yourgithubusername.github.io.

Your Jekyll blog will often be viewable immediately at http://yourgithubusername.github.io (if it's not, you can force it to build by completing step 2)

Step 1

Step 2) Customize and view your site

Enter your site name, description, avatar and many other options by editing the _config.yml file. You can easily turn on Google Analytics tracking, Disqus commenting and social icons here too.

Making a change to _config.yml (or any file in your repository) will force GitHub Pages to rebuild your site with jekyll. Your rebuilt site will be viewable a few seconds later at http://yourgithubusername.github.io

There are 2 different ways that you can make changes to your blog's files:

  1. Edit files within your new username.github.io repository in the browser at GitHub.com (shown below)
  2. Clone down your repository and make updates locally, then push them to your GitHub repository

_config.yml

Step 3) Publish your first blog post

Edit /_posts/2014-3-3-Hello-World.md to publish your first blog post. This Markdown Cheatsheet might come in handy.

First Post

You can add additional posts in the browser on GitHub.com too! Just hit the + icon in /_posts/ to create new content. Just make sure to include the front-matter block at the top of each new blog post and make sure the post's filename is in this format: year-month-day-title.md

Moar!

I've created a more detailed walkthrough of Getting Started With Jekyll, 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.0s new features, including Sass/Coffeescript support and Collections

Jekyll Now Features

✓ 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
✓ Emoji in blog posts! 💖 💖 💖

✘ No installing dependancies
✘ No need to set up local development
✘ No configuring plugins
✘ No need to spend time on theming
✘ More time to code other things ... wait ✓!

Questions?

Open an Issue and let's chat!

Prefer another theme?

A few others have repositories set up to be forked using the same workflow that I detailed in Quick Start. Here's a list of my favorites:

Get my new themes

If you'd like me to let you know when I release a new theme, just drop me your email for updates. I'm currently working on a hacker portfolio site theme.

Credits

  • Jekyll - Thanks to it's creators, contributors and maintainers.
  • SVG icons - Thanks, Neil Orange Peel, the they're beautiful.
  • Joel Glovier - Great Jekyll articles. I used Joel's feed.xml and sitemap.xml in this repository.
  • Design & Code reviews - Thanks to David Furnes, Jon Uy,