Posted on August 13, 2017 at 03:00 by
title: Welcome
permalink: /docs/home/
This site aims to be a comprehensive guide to Jekyll. We’ll cover topics such
as getting your site up and running, creating and managing your content,
customizing the way your site works and looks, deploying to various
environments, and give you some advice on participating in the future
development of Jekyll itself.
Jekyll is a simple, blog-aware, static site generator. It takes a template
directory containing raw text files in various formats, runs it through
a converter (like Markdown)
and our Liquid renderer, and
spits out a complete, ready-to-publish static website suitable
for serving with your favorite web server. Jekyll also happens to be the engine
behind GitHub Pages, which means you can use Jekyll
to host your project’s page, blog, or website from GitHub’s servers for
free.
Throughout this guide there are a number of small-but-handy pieces of
information that can make using Jekyll easier, more interesting, and less
hazardous. Here’s what to look out for.
These are tips and tricks that will help you be a Jekyll wizard!
These are for the extra tidbits sometimes necessary to understand Jekyll.
Be aware of these messages if you wish to avoid certain death.
Some pieces of this website are for future versions of Jekyll that are not yet released.
If you come across anything along the way that we haven’t covered, or if you
know of a tip you think others would find handy, please [file an
issue]({{ site.repository }}/issues/new) and we’ll see about
including it in this guide.