Making an independent website
This is what to do if you just want a website. (This page is a bit long, but it’s really not that much work.)
Start by cloning the repository for the present site. (Or, alternatively, fork it and then clone your own version.)
git clone git://github.com/kbroman/simple_site
Then change the name of that directory to something meaningful.
mv simple_site something_meaningful
(Of course, don’t use
something_meaningful but rather
Now change into that directory and remove the
(because you don’t want the history of my repository).
cd something_meaningful rm -r .git
Now make it a git repository again.
Things not to change
You’ll need to keep the following files and directories largely unchanged.
Rakefile _includes _layouts _plugins assets/themes
We will change one file within
_includes/; see below.
file contains a bunch of configuration information. You’ll want to
edit this file to replace my information with your information.
Perhaps edit the
if you’ve named
ReadMe.md differently. (I’ve
edited this line a bit, here.)
exclude: [..., "ReadMe.md", "Rakefile", "License.md"]
Edit the lines about the site name and author.
title : simple site author : name : Karl Broman email : firstname.lastname@example.org github : kbroman feedburner : nil
kbroman with your github user name, and replace
simple_site with the name that your repository will have on github
production_url : https://kbroman.github.io/simple_site
Note that the
http) is important here; see
“Securing your github pages site with https.”
(I need to use
http because my site uses the custom domain
kbroman.org, but you likely need
with the same url.
BASE_PATH : https://kbroman.github.io/simple_site
There’s also an
but you can leave that commented-out (with the
# symbol at the beginning).
Note that for the
BASE_PATH, I actually have
https://kbroman.org/ in place of
https://kbroman.github.io/. I set up
which involved a series of emails with a DNS provider. I
don’t totally understand how it works, and I’m not entirely sure
that I’ve done it right. But if you want to have a custom domain, take
a look at
that GitHub help page.
file defines how a basic page will look on your site. In particular,
it contains a bit of html code for a footer, if you want one.
Find the footer for my site and remove it or edit it to suit. This is the only bit of html you’ll have to deal with.
<!-- start of Karl's footer; modify this part --> <a href="https://creativecommons.org/publicdomain/zero/1.0/"> ... <a href="https://kbroman.org">Karl Broman</a> <!-- end of Karl's footer; modify this part -->
Edit or remove the Markdown files
file, which will become the main page for your site.
First, edit the initial chunk with a different title and tagline. Feel free to just delete the tagline.
--- layout: page title: simple site tagline: Easy websites with GitHub Pages ---
Now edit the rest (or, for now, just remove) the rest of the file.
Now go into the
pages/ directory and remove or rename and modify
all of the Markdown files in there
Note that when you link to any of these Markdown-based pages, you’ll
want to use a
.html extension rather than
.md. For example, look
for this site; the links in the bullet points for the various pages
look like this:
- [Overview](pages/overview.html) - [Making an independent website](pages/independent_site.html) - [Making a personal site](pages/user_site.html) - [Making a site for a project](pages/project_site.html) - [Making a jekyll-free site](pages/nojekyll.html) - [Testing your site locally](pages/local_test.html) - [Resources](pages/resources.html)
Commit all of these changes.
At the start, we’d removed the
.git/ subdirectory (with the history
of my repository) and then used
git init to make it a new git
Now you want to add and commit all of the files, as modified.
git add . git commit -m "Initial commit"
Then change the name of the master branch to
git branch -m master gh-pages
Push everything to GitHub
Now go back to GitHub and create a new repository, called something
meaningful. (I’ll again pretend that it’s explicitly
Then go back to the command line and push your repository to GitHub.
git remote add origin email@example.com:username/something_meaningful
username with your GitHub user name and
something_meaningful with the name of your repository. And you might
want to use the
https:// construction instead, if you’re not using ssh.
git remote add origin https://github.com/username/something_meaningful
Finally, push everything to GitHub.
git push -u origin gh-pages
Note that we’re using
gh-pages and not
master here, as we want
this stuff in a
Check whether it worked
https://username.github.io/something_meaningful and cross your
fingers that it worked. (Really, I should be crossing my fingers.)
Now go to making a personal site.