2014-04-26 21:32:28 +00:00
# Jekyll Now
2014-02-07 13:49:36 +00:00
2014-05-29 00:26:13 +00:00
**Jekyll** is static site generator that's perfect for GitHub hosted blogs ([Jekyll Repository](https://github.com/jekyll/jekyll))
2014-05-19 12:45:13 +00:00
2014-05-29 00:26:13 +00:00
**Jekyll Now** makes it easier to create your Jekyll blog, by eliminating a lot of the up front setup.
2014-05-19 12:45:13 +00:00
2014-05-29 00:26:13 +00:00
- You don't need to touch the command line
- You don't need to install/configure ruby, rvm/rbenv, ruby gems :relaxed:
- You don't need to install runtime dependancies like markdown processors, Pygments, etc
2014-05-29 00:26:55 +00:00
- It's easy to try out, you can just delete your forked repository if you don't like it
2014-04-26 22:12:23 +00:00
2014-05-29 00:41:47 +00:00
In a few minutes you'll be set up with a minimal, responsive blog ([**Theme Demo**](http://jekyllnow.com)) giving you more time to spend on making your blog awesome!
2014-05-27 03:47:39 +00:00
2014-04-30 12:52:28 +00:00
## Quick Start
2014-04-26 21:32:28 +00:00
2014-05-19 12:45:13 +00:00
### Step 1) Fork Jekyll Now to your User Repository
2014-04-26 22:12:23 +00:00
2014-05-29 00:01:06 +00:00
Fork this repo, then rename the repository to YourGitHubUsername.github.io.
2014-05-29 00:04:43 +00:00
Your Jekyll blog will then be live at that URL: < http: / / YourGitHubUsername . github . io > (it's generally live immediately, but can occasionally take up to 10 minutes)
2014-04-26 22:12:23 +00:00
2014-04-26 22:28:24 +00:00
![Step 1 ](/images/step1.gif "Step 1" )
2014-04-26 22:12:23 +00:00
2014-04-26 23:04:20 +00:00
### Step 2) Customize your site
2014-04-26 20:50:07 +00:00
2014-06-01 23:05:41 +00:00
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.
2014-05-21 12:19:40 +00:00
2014-06-01 23:09:54 +00:00
> There are 2 different ways that you can make changes to your blog's files from here onwards. Feel free to pick whichever suits you best:
2014-06-01 23:05:41 +00:00
2014-06-01 23:09:54 +00:00
> 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
2014-04-26 20:50:07 +00:00
2014-05-29 01:08:15 +00:00
![_config.yml ](/images/config.png "_config.yml" )
2014-04-26 23:04:20 +00:00
### Step 3) Publish your first blog post
2014-04-26 20:50:07 +00:00
2014-05-29 12:35:55 +00:00
Edit `/_posts/2014-3-3-Hello-World.md` to publish your first blog post. This [Markdown Cheatsheet ](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet ) might come in handy.
2014-04-26 20:50:07 +00:00
2014-05-29 01:08:15 +00:00
![First Post ](/images/first-post.png "First Post" )
2014-04-26 22:12:23 +00:00
2014-05-29 00:26:13 +00:00
To add additional posts you can hit the + icon in `/_posts/` to create new content. Just make sure to include the [front-matter ](http://jekyllrb.com/docs/frontmatter/ ) 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
2014-04-26 20:50:07 +00:00
2014-04-26 23:04:20 +00:00
## Moar!
2014-05-29 00:41:47 +00:00
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. :metal:
2014-04-30 12:52:28 +00:00
It covers:
2014-05-29 00:41:47 +00:00
- 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
2014-04-26 23:04:20 +00:00
## Jekyll Now Features
2014-03-03 02:39:47 +00:00
2014-05-19 12:13:11 +00:00
✓ Command-line free _fork-first workflow_ , using GitHub.com to create, customize and post to your blog
2014-05-19 12:11:18 +00:00
✓ Fully responsive and mobile optimized base theme (**[Theme Demo](http://jekyllnow.com)**)
✓ Sass/Coffeescript support using Jekyll 2.0
2014-04-26 23:10:21 +00:00
✓ Free hosting on your GitHub Pages user site
✓ Markdown blogging
2014-03-03 02:43:58 +00:00
✓ Syntax highlighting
✓ Disqus commenting
✓ Google Analytics integration
2014-05-19 22:02:27 +00:00
✓ SVG social icons for your footer
✓ Speed - only 3 http requests, including your avatar
2014-05-29 00:41:47 +00:00
✓ Emoji in blog posts! :sparkling_heart: :sparkling_heart: :sparkling_heart:
2014-03-03 02:43:58 +00:00
✘ No installing dependancies
2014-05-19 12:11:18 +00:00
✘ No need to set up local development
2014-03-03 02:43:58 +00:00
✘ No configuring plugins
✘ No need to spend time on theming
2014-05-29 00:41:47 +00:00
✘ More time to code other things ... wait ✓!
2014-03-03 02:39:47 +00:00
2014-04-26 23:15:42 +00:00
## Questions? Suggestions?
2014-02-25 14:09:15 +00:00
2014-04-20 00:42:04 +00:00
[Open an Issue ](https://github.com/barryclark/jekyll-now/issues/new ) and let's chat!
2014-02-25 14:02:27 +00:00
2014-05-19 23:24:49 +00:00
## Get new themes
2014-03-02 16:45:51 +00:00
2014-04-26 20:50:07 +00:00
If you'd like me to let you know when I release a new theme, just [drop me your email for updates ](http://getresponse.com ). I'm currently working on a personal portfolio site Jekyll Now theme.
## Credits
2014-03-02 16:45:51 +00:00
2014-05-21 12:19:40 +00:00
- [Jekyll ](https://github.com/jekyll/jekyll ) - Thanks to it's creators, contributors and maintainers.
- [SVG icons ](https://github.com/neilorangepeel/Free-Social-Icons ) - Thanks, Neil Orange Peel, the they're beautiful.
- [Joel Glovier ](http://joelglovier.com/writing/ ) - Great Jekyll articles. I used Joel's feed.xml and sitemap.xml in this repository.
2014-05-24 15:12:14 +00:00
- Design & Code reviews - Thanks to [David Furnes ](https://github.com/dfurnes ), [Jon Uy ](https://github.com/jonuy ),