Writing is rewriting. Writing and editing come in iterative progression. If you want to focus on writing, Jekyll is a good solution to keep a blog. Jekyll is “an open-source simple static site generator”. What that means is Jekyll converts plain text files from a computer into a website or blog. If you like writing in Markdown, you will like a solution like Jekyll for blogging. Using Jekyll has some advantages over more complex systems. It is built for writing. You don’t need to log anywhere to access and change your content although you can also edit it through a GitHub account. But you can just as well write a text on your computer and let Git mirrors it and build it, either on GitHub or on your own self hosted server. Git “is a free and open source distributed version control system”. Pushing revisions to Git is a convenient way to publish and review notes. Since Git keeps track of all changes, you can revert to any previous version at anytime. Using GitHub pages is free. Web hosting, traffic pikes, databases or downtimes are no longer a concern once your site is set up. Serving static files is fast. Another major advantage is security: there is no entry point to hack.
Requirements: → Ruby
→ Linux, Unix, or Mac OS X1
Install Jekyll on Mac OS X
Install Xcode from the AppStore: https://developer.apple.com/download/
First, make sure you have Xcode Command Line Tools installed.
Using the Terminal located in
You can now use the command line to run the rest of the installation commands.
First install Homebrew:
Homebrew is useful because it will manage the various packages installations. If you have Homebrew already, check for updates.
Next, you need install Ruby. Your system might already have this, but we’ll be getting the latest version.
Now, at last, you are ready to install Jekyll
Using the command line:
You can also use:
And, working with drafts:
jekyll serve —drafts
✑ Set up Git: https://help.github.com/articles/set-up-git
Using Jekyll with GitHub Pages:
☆ GitHub: Using Jekyll with pages — Pages help & how-to.
Prose — Prose is a simple content editor for GitHub designed for managing websites. Useful to edit your Jekyll site from any computer, work in team etc.
→ Minima is the current default Jekyll theme
→ https://jekyllthemes.dev A collection of free Jekyll themes
→ Dr Jekyll’s themes — http://drjekyllthemes.github.io is a free static website theme directory
→ Alembic, is a Jekyll boilerplate theme designed to be a starting point for any Jekyll website
✑ Getting Started with Jekyll by Nicholas Cerminara (@nickforthought). This is one of the most thorough article on how to set up a Jekyll site in a few comprehensive steps.
✑ http://jekyll.tips/ — Step by step tutorials and screencasts covering everything you need to know about Jekyll.
✑ Jekyll Talk http://talk.jekyllrb.com — A place for the Jekyll community to ask questions, get help, and share their wonderful creations!
✑ Add a portfolio to your jekyll site: https://github.com/hez/jekyll.portfolio
✑ Jekyll SEO: Brett Hardin’s Jekyll and seo optimization
Jekyll or WordPress?
Jekyll is gaining more and more attention. Once set up, maintaining a Jekyll blog is convenient and hassle-free. Simplicity, focus on writing and the speed advantage Jekyll provides make it an ideal tool for blogs. There are a lot of articles around about people converting their WordPress blogs to Jekyll. Or glossing about going back to WordPress and why. In the end what you use doesn’t matter. These are both fantastic tools. Their beauty is that once you adapt them to your needs, they will remain behind the scene. The important thing is what you make out of them.
Other static site generators
Here is a list of more Open-Source Static Site Generators, complete with stat usage and info.
Credits for this site
silentcomics.com runs on Jekyll. The theme for this site is based on minimal mistakes by Michael Rose. Read the Minimal Mistakes theme setup for thorough documentation and comprehensive install how-to. Thanks to @mmistakes for sharing his excellent work — you can find more open source themes by Michael Rose here and on GitHub.
Tom Preston-Werner(@mojombo). “Blogging Like a Hacker.” http://tom.preston-werner.com/2008/11/17/blogging-like-a-hacker.html.
Young Hahn, Development Seed. “Using Jekyll and GitHub Pages For Our Site.” http://developmentseed.org/blog/2011/09/09/jekyll-github-pages/ — a thorough article about how Jekyll works.
Mathias Biilmann Christensen, Smashing Magazine “Why Static Website Generators Are The Next Big Thing.” (November 2015) http://www.smashingmagazine.com/2015/11/modern-static-website-generators-next-big-thing/—The same article, discussed on HN
It works on Windows too. ↩