基於Jekyll和GitHub Pages搭建個人博客

本文介紹如何利用Jekyll創建一個靜態站點,並託管到GitHub Pages上。

JeKyll

JeKyll是一個基於Ruby的博客類靜態網站生成器。

Jekyll是一個簡單,可擴展的靜態站點生成器。您可以使用自己喜歡的標記語言編寫文本,然後通過佈局來創建靜態網站。在整個過程中,您可以調整網站URL的顯示方式,佈局中顯示的數據等

基於JeKyll創建靜態網站

  1. 安裝Ruby開發環境 (以macOS 爲例macOS Mojave 10.14 可省略以下安裝步驟

    1.1 安裝Homebrew和Ruby

    1
    2
    3
    4
    
    # Install Homebrew
    /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
    
    brew install ruby
    

    1.2 導出Ruby環境變量

    1
    
    echo 'export PATH=/usr/local/opt/ruby/bin:$PATH' >> ~/.zshrc
    

    1.3 檢查Ruby是否安裝成功

    1
    2
    3
    4
    
    which ruby
    /usr/local/opt/ruby/bin/ruby
    ruby -v
    ruby 2.6.0p0 (2018-12-25 revision 66547) [x86_64-darwin18]
    
  2. 安裝打包器和jekyll

    1
    
    gem install --user-install bundler jekyll
    
  3. 創建一個新的Jekyll網站

    1
    
    jekyll new myblog
    

    若提示 command not found: jekyll ,需要把gem路徑配置到PATH裏面

  4. 編譯網站並啓動本地服務

    1
    2
    
    cd myblog
    bundle exec jekyll serve
    

    訪問http://localhost:4000/查看效果

GitHub Pages

GitHub Pages是直接從GitHub倉庫託管的個人網站和項目網站。

基於GitHub Pages託管網站

  1. 創建一個倉庫
    前往GitHUb創建一個新的倉庫,倉庫名稱爲username.github.io,其中username是你的GitHub用戶名或者組織名稱。

  2. 克隆倉庫
    把步驟一創建的倉庫克隆到本地。

    1
    2
    
    git clone https://github.com/username/username.github.io
    
  3. 創建第一個頁面
    進入項目目錄,新建一個index.html的文件。

    1
    2
    3
    
    cd username.github.io
    echo "Hello World" > index.html
    
  4. 推送到遠程倉庫
    增加、提交和推送你的更改

    1
    2
    3
    4
    
    git add --all
    git commit -m "初始提交"
    git push -u origin master
    
  5. 你已經成功完成
    訪問https://username.github.io查看效果

整合部署

將Jekyll生成的靜態網站複製到username.github.io倉庫並提交推送到GitHub

1
cp -r myblog/** username.github.io

後面直接修改倉庫文件,用Jekyll編譯提交即可。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章