Taking some notes regarding building a website.


First you may need to buy and host a domain. For example,

  • To check domain status, you can use whois. This can provide you with some information, but not a service to host your own domain.

  • To register or buy a new domain, you can use GoDaddy or Aliyun. They are domain service providers, and can help you host and manage this domain (including setting up DNS server).

Jekyll Local Setup

For the latest version (22.04) of Ubuntu system, you should be able to set up everything by following this official latest tutorial: Quick Start, Ubuntu Installation

For Ubuntu 20, you may encountered some errors in gem install jekyll bundler. To address this, just to install a previous version of jekyll. Either of the following way shall work.

gem install jekyll -v 3.9.3
gem install jekyll --version="~> 4.2.0"

Then just follow the rest of Quick Start to compile and run the web pages locally.

Github Pages

There are some issues with the rendering of Github Pages on the Github remote server. The webpages can build and render correctly in local environment, but not on the Internet after pushing to Github repo. Two things to change:

  • In markdown source files (e.g.,, change the keyword layout to layouts. This is may be a legacy issue. Reference: Stackoverflow question.

  • In the _config.yml file, baseurl and url have to be set propely to a remote address. For example:

baseurl: "/"
url: ""


Last updated