Coder Social home page Coder Social logo

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
  • 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!

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 often 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 - if not, give it ten minutes as GitHub suggests and it'll appear soon

There are 3 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. Use a third party GitHub content editor, like Prose by Development Seed. It's optimized for use with Jekyll making markdown editing, writing drafts, and uploading images really easy.
  3. 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

Local Development

  1. Install Jekyll and plug-ins in one fell swoop. gem install github-pages This mirrors the plug-ins used by GitHub Pages on your local machine including Jekyll, Sass, Gemoji, etc.
  2. Clone down your fork git clone [email protected]:yourusername/yourusername.github.io.git
  3. Serve the site and watch for markup/sass changes jekyll serve
  4. View your website at http://0.0.0.0:4000
  5. Commit any changes and push everything to the master branch of your GitHub user repository. GitHub Pages will then rebuild and serve your website.

Moar!

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

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!

Other forkable themes

You can use the Quick Start workflow with other themes that are set up to be forked too! Here are some of my favorites:

Credits

Sam's Projects

apollo-11 icon apollo-11

Original Apollo 11 Guidance Computer (AGC) source code for the command and lunar modules.

becoming icon becoming

Add additional functionality to objects.

blog_engine icon blog_engine

This is a blog engine application. A simple web application in ruby which is totally from scratch and doesn't use any gem or external library! It uses only core Ruby libraries!

blogger icon blogger

Jumpstart Lab Rails sample project Blogger.

blogger_advanced icon blogger_advanced

This is based on Jumpstart Lab Advanced Sample Projects in Rails! This one is about Decorator Pattern using Draper gem.

classifier icon classifier

Very simple classifier based on Strict Bound algorithm in Machine Learning in Supervised Learning!

curriculum icon curriculum

All of Jumpstart Lab's tutorials and curriculum that we teach.

draper icon draper

Decorators/View-Models for Rails Applications

game_of_life icon game_of_life

this is the famous conway's game of life, only the logic though

hackathon icon hackathon

Groupon and 21st Century Youth Project Hackerthon

hpc_floyds_parallel icon hpc_floyds_parallel

One way of Parallelization of Floyd-Warshall algorithm for finding all-pairs shortest paths in a graph!

jop icon jop

a gem to add J language array commands to Ruby

kamon icon kamon

Reactive Applications Monitoring

librepsheet icon librepsheet

The Repsheet core logic extracted to a separate library

mark_and_sweep_gc icon mark_and_sweep_gc

Simplified implementation of famous Mark and Sweep Garbage Collection algorithm.

merchant icon merchant

Jumpstart Lab Rails example Merchant application! Did a lot of Refactoring, Automated testing, etc.

microarray_analysis icon microarray_analysis

Microarray Analysis for determining the genes that have more impact on a certain disease! High Performance Computing Project!

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    πŸ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. πŸ“ŠπŸ“ˆπŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❀️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.