Overview of GitHub Pages
The present site is simple, with a style derived from JekyllBootstrap and Twitter Bootstrap with a particular theme. I’ll explain how to create a site with exactly this style. If you want something else, try the GitHub Pages automatic site generator, or look at the resources page.
These GitHub Pages sites are constructed by having a
of a GitHub repository, with specific files layed out in a specific
way. To see the structure of such a repository, look at the
repository for the present site.
_includes/ _layouts/ _plugins/ assets/ pages/ .gitignore License.md Rakefile ReadMe.md _config.yml index.md
The directories beginning with an underscore contain materials
defining the basic layout and style for the site. If you
build the site locally (for testing
purposes), there will also be a
_site/ directory containing the
actual site (with
converted to html). You don’t want the
_site/ directory in your
repository, so include that in the
directory contains any non-Markdown materials for the site (e.g.,
images or example code). These files won’t be touched in the
conversion but will be just copied over as-is.
It’s best to always include
files. But you wouldn’t need these to be placed on the website; they’d
just be viewed in the repository on GitHub. The
a line sort of like the following
(but listing a few more files), indicating files to not move to the
exclude: ["ReadMe.md", "Rakefile", "License.md"]
is the Markdown version of the main page for your site.
--- layout: page title: simple site tagline: Easy websites with GitHub Pages description: Minimal tutorial on making a simple website with GitHub Pages ---
In the conversion of the site from Markdown to html, this bit says
that the current file is to be converted with the “page”
layout, and gives the title and the (optional) “tagline.”
description:” part gets converted into
<meta name="description" content="Minimal tutorial on...">
which, in principle, may be used in the results of google searches.
The rest is basically plain Markdown, though the present site is
configured to use kramdown as the
Markdown converter (via
this line in the
Read about the kramdown syntax
or just look at the
Now go to the page about how to make an independent website.