Clone or fork this repo and change the url
and puburl
in _config.yml
To learn how to install and use this theme check out the Setup Guide for more information.
You will need ruby and the ruby-gem github-pages installed on your computer, if you want to serve the Jekyll page locally.
I highly recommend using rbenv. Installation is easy if you already have homebrew:
$ brew install rbenv
After you have rbenv installed, cd
to your Jekyll site's directory, and install a Ruby version. This theme was tested on 2.3.0:
# list available versions:
$ rbenv install -l
# install a ruby version (this might take a while):
$ rbenv install 2.4.0
# set the ruby version in the working directory:
$ rbenv local 2.4.0
# see which version is selected:
$ rbenv versions
With rbenv You don't need to SUDO, but we do need to install Bundler:
$ gem install bundler
Bundler tracks dependencies on a per-project basis, it is particularly useful if you need to run different versions of Jekyll in different projects, or if you don’t want to install Jekyll at the system or user level. If you are using Bundler for the first time, please read now it is configured here
Optionally to install our dependencies in an isolated environment, and ensuring they don't conflict with other gems in your system we can get gems installed into ./vender/bundle/
by:
bundle install --path vendor/bundle
to install the required gems for this project specified in the gemfile
$ bundler install
you can checkout what bundler does.
if you are struck with some of these ruby/ gems/ bundler stuff, this link might be helpful.
$ bundle exec jekyll serve --watch # the watch flag looks for real-time changes to files you edit
go to localhost:4000
in your browser to see your site.
For deployment on GitLab, this repo already include a .gitlab-ci.yml
file that should build the GitLab Page properly. I found this page to be particularly useful on using GitLab Pages.
- get rid of settings.js (i.e. move search engine config and search placeholder into a data
yml
file) - get average color and set font to contrast
- make it responsive
- fix weather function
- day vs night background function?