Slightly toning down h2s again
[jekyll-now.git] / README.md
blobc0a447454452e046ea03fb4c2ef74c3cd4e9dc3c
1 # Jekyll Now
3 **Jekyll** is static site generator that's perfect for GitHub hosted blogs ([Jekyll Repository](https://github.com/jekyll/jekyll))
5 **Jekyll Now** makes it easier to create your Jekyll blog, by eliminating a lot of the up front setup.
7 - You don't need to touch the command line
8 - You don't need to install/configure ruby, rvm/rbenv, ruby gems :relaxed:
9 - You don't need to install runtime dependancies like markdown processors, Pygments, etc
10 - It's easy to try out, you can just delete your forked repository if you don't like it
12 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!
14 ## Quick Start
16 ### Step 1) Fork Jekyll Now to your User Repository
18 Fork this repo, then rename the repository to YourGitHubUsername.github.io. 
20 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)
22 ![Step 1](/images/step1.gif "Step 1")
24 ### Step 2) Customize your site
26 Enter your site name, description, avatar and many other options by editing the _config.yml file. 
28 You can easily turn on Google Analytics tracking, Disqus commenting and social icons here too!
30 ![_config.yml](/images/config.png "_config.yml")
31   
32 ### Step 3) Publish your first blog post
34 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.
36 ![First Post](/images/first-post.png "First Post")
38 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
41 ## Moar!
43 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:
45 It covers:
47 - A more detailed walkthrough of setting up your Jekyll blog
48 - Common issues that you might encounter while using Jekyll
49 - Importing from Wordpress, using your own domain name, and blogging in your favorite editor
50 - Theming in Jekyll, with Liquid templating examples
51 - A quick look at Jekyll 2.0’s new features, including Sass/Coffeescript support and Collections
53 ## Jekyll Now Features
55 ✓ Command-line free _fork-first workflow_, using GitHub.com to create, customize and post to your blog  
56 ✓ Fully responsive and mobile optimized base theme (**[Theme Demo](http://jekyllnow.com)**)  
57 ✓ Sass/Coffeescript support using Jekyll 2.0  
58 ✓ Free hosting on your GitHub Pages user site  
59 ✓ Markdown blogging  
60 ✓ Syntax highlighting  
61 ✓ Disqus commenting  
62 ✓ Google Analytics integration  
63 ✓ SVG social icons for your footer  
64 ✓ Speed - only 3 http requests, including your avatar  
65 ✓ Emoji in blog posts! :sparkling_heart: :sparkling_heart: :sparkling_heart:  
67 ✘ No installing dependancies  
68 ✘ No need to set up local development  
69 ✘ No configuring plugins  
70 ✘ No need to spend time on theming  
71 ✘ More time to code other things ... wait ✓!  
73 ## Questions? Suggestions?
75 [Open an Issue](https://github.com/barryclark/jekyll-now/issues/new) and let's chat!
77 ## Get new themes
79 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.
81 ## Credits
83 - [Jekyll](https://github.com/jekyll/jekyll) - Thanks to it's creators, contributors and maintainers.
84 - [SVG icons](https://github.com/neilorangepeel/Free-Social-Icons) - Thanks, Neil Orange Peel, the they're beautiful. 
85 - [Joel Glovier](http://joelglovier.com/writing/) - Great Jekyll articles. I used Joel's feed.xml and sitemap.xml in this repository.
86 - Design & Code reviews - Thanks to [David Furnes](https://github.com/dfurnes), [Jon Uy](https://github.com/jonuy),