Setting up Blog on github.io

This article shares the process of setting up blog website on github.io.

Create a new github and git clone to local computer

# the project to your own account and renaming the repo with <yourusername>.github.io
git clone git@github.com:xxx/xxx.github.io

Install packages

conda create -n jekyll
conda activate jekyll
conda install -c conda-forge c-compiler compilers cxx-compiler
conda install -c conda-forge ruby
gem update --system
gem install bundler
gem install jekyll
gem install jekyll-paginate

Remark: $ conda install -c conda-forge ruby=3.3.3

and checking,

which jekyll
which ruby
ln -s /xxx/anaconda3/envs/jekyll/bin/ruby /xxx/anaconda3/envs/jekyll/share/rubygems/bin/ruby
bundle init
bundle install
bundle update --bundler
bundle add jekyll
gem "jekyll"
gem "jekyll-paginate"
bundle update
bundle exec jekyll -v
vim Gemfile + gem "jekyll-paginate"

Run on local computer

bundle update
bundle exec jekyll serve

iMac is

Run in verbose mode to see all warnings.
                    done in 2.362 seconds.
 Auto-regeneration: enabled for '/Users/wpsze/Documents/git-local/waipangsze.github.io'
    Server address: http://127.0.0.1:4000
  Server running... press ctrl-c to stop.
[2022-06-01 13:15:18] ERROR `/js/pageContent.js' not found.

Open a browser with the ip address in above output

Upload to github

git pull --rebase # do this at the beginning
git status
git add . # add all files
git commit --amend
git push (-f)
git push -u origin main

Errors

1. jekyll/share/rubygems/bin/ruby: No such file or directory
2. Error installing jekyll: Failed to build gem native extension
3. cannot load such file – jekyll-paginate
4. Could not locate Gemfile (bundle init)
5. jekyll is not currently included in the bundle, perhaps you meant to add it to your Gemfile (Edit Gemfile, + gem "jekyll", "~> 4.3"
6. make: /usr/bin/mkdir: Command not found ==> in .zshrc, add source ~/.bashrc, and sudo ln -s /bin/mkdir /usr/bin/mkdir

Reference: 1. Setting up a blog site with jekyll using conda 2. TeXt Theme 3. _posts 4. gaohaoyang.github.io) 5. Welcome to HyG's Blog! 这里记录着我的前端学习之路