by Roman Zolotarev
This website is a minimalist boilerplate powered by GitHub Pages.
Check out Jekyll Newsletter —a companion website— if you want to setup RSS-to-mail campaigns.
It is not a Jekyll theme.
The goal of this project is to demonstrate meaningful defaults of Jekyll, GitHub Pages, and modern browsers. Websites we build today look virtually identical, but don’t we want to stand out?
Create your standalone website in few minutes without installing anything or touching the command line. All you need is your GitHub account (or email) and few minutes.
Build it from scratch. Make it unique. Design it for your needs. Express yourself in HTML and CSS, but do not overdo it, please. Make the web diverse and clean place.
Read the source code of this website. It is just three small files.
If you are looking for a theme, I would recommend
USERNAMEis your username on GitHub.
--- title: About --- This site is clean and beautiful.
It is important to use front matter with
title in every file. The new page
should be available at:
(based on its file name).
CNAME file to your repository with your domain name. For example:
CNAME record to DNS zone for your domain that points to
USERNAME.github.io. For example:
;; CNAME Records www.romanzolotarev.com. 300 IN CNAME romanzolotarev.github.io.
Now your site should be available via your domain name. In case of those examples at:
GitHub Pages uses Jekyll to do all this magic. If you are familiar with git, then you may want to install GitHub Pages (with Jekyll) on your computer. So you will be able to edit your pages locally (e.g. when you are offline) and view your site locally before publishing.
For example to install on Mac run this command:
# Install bundler gem install bundler # and then jekyll plus jekyll-livereload bundle install # Start local server bundle exec jekyll serve --livereload --increment
Then clone your repository and run Jekyll locally.
git clone https://github.com/USERNAME/USERNAME.github.io cd USERNAME.github.io jekyll serve -w
While Jekyll is running, open http://localhost:4000/ in your browser. Your site should be there. You can add and edit pages and Jekyll will automatically regenerate HTML files, just reload the page in the browser to see changes.
Learn more about Jekyll.
CC0 by Roman Zolotarev