本文介紹如何利用Jekyll創建一個靜態站點,並託管到GitHub Pages上。
JeKyll
JeKyll是一個基於Ruby的博客類靜態網站生成器。
Jekyll是一個簡單,可擴展的靜態站點生成器。您可以使用自己喜歡的標記語言編寫文本,然後通過佈局來創建靜態網站。在整個過程中,您可以調整網站URL的顯示方式,佈局中顯示的數據等
基於JeKyll創建靜態網站
-
安裝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]
-
安裝打包器和jekyll
1
gem install --user-install bundler jekyll
-
創建一個新的Jekyll網站
1
jekyll new myblog
若提示 command not found: jekyll ,需要把gem路徑配置到PATH裏面
-
編譯網站並啓動本地服務
1 2
cd myblog bundle exec jekyll serve
訪問http://localhost:4000/查看效果
GitHub Pages
GitHub Pages是直接從GitHub倉庫託管的個人網站和項目網站。
基於GitHub Pages託管網站
-
創建一個倉庫
前往GitHUb創建一個新的倉庫,倉庫名稱爲username.github.io,其中username是你的GitHub用戶名或者組織名稱。 -
克隆倉庫
把步驟一創建的倉庫克隆到本地。1 2
git clone https://github.com/username/username.github.io
-
創建第一個頁面
進入項目目錄,新建一個index.html的文件。1 2 3
cd username.github.io echo "Hello World" > index.html
-
推送到遠程倉庫
增加、提交和推送你的更改1 2 3 4
git add --all git commit -m "初始提交" git push -u origin master
-
你已經成功完成
訪問https://username.github.io查看效果
整合部署
將Jekyll生成的靜態網站複製到username.github.io倉庫並提交推送到GitHub
1 |
cp -r myblog/** username.github.io |
後面直接修改倉庫文件,用Jekyll編譯提交即可。