This website is a minimalist boilerplate hosted on GitHub Pages.
Create your standalone website in few minutes without installing anything or touching the command line. All you need is your GitHub account (or email).
USERNAMEis your username on GitHub.
Your site should be available at:
--- 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
derived from 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 it on macOS run the following commands. First, clone your repository and run Jekyll locally:
$ git clone https://github.com/USERNAME/USERNAME.github.io $ cd USERNAME.github.io
$ gem install bundler
$ bundle install
Start your local web server:
$ bundle exec jekyll serve --livereload --increment
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.
© 2017-2018 by Roman Zolotarev
Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.