Example

What's Jekyll?

01 Mar 2021

Jekyll is a static site generator, an open-source tool for creating simple yet powerful websites of all shapes and sizes.

Gem installs

sudo apt-get install ruby-full build-essential zlib1g-dev

echo '# Install Ruby Gems to ~/gems' >> ~/.bashrc
echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc
echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

gem install jekyll bundler
gem install "jekyll-theme-hydure"
bundle add webrick

To create a Github Page with a Jekylle theme

Assume you have a github account: https://github.com/yourname

Fork Theme

Go to Jekyll-Theme-Hydure click [Fork]
Click [Settings], Repository name enter YourBlogName (Ex. AI-course), click [Rename]
Delete 2 old branches, keep master branch
Create new Branch gh-pages
Click [Settngs], Left Menu Braches, Default branch set to gh-pages
Add Theme
Edit Gemfile to add:
```
gem "jekyll-theme-hydure"
```

Edit _config.yml to add:
To submit to github,

plugin:
  - jekyll-remote-theme
remote_theme: zivong/jekyll-theme-hydure

For running on localhost (PC), use the following:

plugin:
#  - jekyll-remote-theme
theme: jekyll-theme-hydure

Change Cover.jpg

Upload a cover.jpg (1920x2880) to _layouts
Modify _layouts/default.hmtl to change path of cover.jpg
```
assign cover = site.cover | default: "cover.jpg"
```
Change Title & Tagline

Modify _config.yml

- title: AI course
- tagline: Deep Learning Course

Modify _data/navigation.yml to change url

- tile Download
  url: https://github.com/rkuo2000/AI-course/archive/refs/heads/master.zip
- title: Github
  url: https://github.com/rkuo2000/AI-course

Modify _data/social.yml to change url

- title: Email
  url: mailto:yourname@gmail.com
  icon: fas fa-envelope
- title: FaceBook
  url: https://facebook.com/yourname
  icon: fab fa-facebook
- title: Twitter
  url: https://twitter.com/yourname
  icon: fab fa-twitter
- title: GitHub
  url: https://github.com/yourname
  icon: fab fa-github

Edit Posts

Modify _posts/*.md, upload or remove .md)
(posts display latest dated .md on the top)

2021-09-23-DeepLearning-intro.md
2021-09-23-AI-intro.md
2021-03-01-whats-jekyll.md

Modify _layouts/default.html for hiding side-header with a checkbox
see _layouts/default.html for detail

Run on localhost

cd ~/Desktop/Robotics/
rm Gemfile.lock` # for the first-time
jekyll serve

Open Browser at* localhost:4000

Open Github Page

Click https://yourname.github.io/yourpagename

jekyll