What's Jekyll?
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 togh-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