Jekyll 是一個靜態(tài)站點生成器，內(nèi)置 GitHub Pages 支持和簡化的構建過程。 Jekyll 使用 Markdown 和 HTML 文件，并根據(jù)您選擇的布局創(chuàng)建完整靜態(tài)網(wǎng)站。 Jekyll 支持 Markdown 和 Lick，這是一種可在網(wǎng)站上加載動態(tài)內(nèi)容的模板語言。所以在Github Pages上使用Jekyll很合適，其他有關介紹請參考Github Docs關于Jekyll，以及jekyll中文指南站點（翻譯），jekyll英文指南站點，本篇部分內(nèi)容參考了以上文檔。
在Linux，MacOS上使用Jekyll，安裝過程較為簡單，下面為在Windows上的安裝過程。

通過 RubyInstaller 安裝Ruby環(huán)境

安裝 Ruby 和 Jekyll 的最簡單方法是使用RubyInstaller for Windows。

RubyInstaller是一個獨立的基于Windows的安裝程序，包括Ruby語言，執(zhí)行環(huán)境， 重要文檔等。

從RubyInstaller Downloads 下載并安裝Ruby+Devkit版本。

使用默認安裝選項。
在安裝向導的最后一個階段運行ridk install MSYS2 and MINGW development tool chain步驟。這是使用本機安裝 gem 所必需的 擴展。您可以在RubyInstaller 文檔中找到有關此內(nèi)容的其他信息。
從開始菜單打開一個新的命令提示符窗口，以便對環(huán)境變量的更改生效。
打開命令提示符窗口測試是否安裝完成：
輸入命令：ruby -v

安裝RubyGems

在Windows中下載RubyGems，直接ZIP格式的比較簡單，下載鏈接，下載后解壓并打開該目錄，在打開的Windows目錄進入命令提示符界面。
1.輸入命令：ruby setup.rb,即安裝。
2.輸入命令：gem -v,查看版本信息驗證
3.輸入命令：gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/配置國內(nèi)gem source源（原h(huán)ttps://rubygems.org有些慢）
4.輸入命令：gem sources -l查看驗證gem source配置

安裝Jekyll

1.輸入命令：gem install jekyll安裝jekyll
2.輸入命令：jekyll -v安裝完驗證版本

安裝jekyll-paginate

1.輸入命令：gem install jekyll-paginate安裝jekyll-paginate

安裝bundle

1.此時可以創(chuàng)建新的Jekyll項目，輸入命令：jekyll new myblog，進入到該目錄cd myblog,運行項目jekyll serve，可能會由于依賴不完整報錯，可以先安裝bundle
2.輸入命令：gem install bundle
3.輸入命令：bundle install,添加缺失的依賴,會自動安裝 Gemfile 內(nèi)聲明的依賴插件.
4.輸入命令：bundle exec jekyll serve，運行項目，如有缺失依賴，再根據(jù)打印的信息使用gem進行安裝。
5.至此Jekyll項目可以運行，打開瀏覽器輸入地址:端口號可以看見界面

找到適合自己的Jekyll主題

幾個比較熱門的Jekyll主題網(wǎng)站：

• GitHub.com #jekyll-theme repos

• jamstackthemes.dev

• jekyllthemes.org

• jekyllthemes.io

  插件庫

• jekyll-plugin topic on GitHub

• Planet Jekyll

例如此博客使用的主題地址。

應用找到的主題

1.使用Github Pages生成站點，需要創(chuàng)建倉庫名為<username>.github.io的倉庫，可以直接將主題項目fork到自己的<username>.github.io倉庫中，之后可以clone到本地進行進行編輯。clone到本地后進入目錄，將原文件.travis.yml .github刪除，配置自己的_config.yml內(nèi)容以及git倉庫。目錄結構大致如下

jekyll-theme-chirpy/
├── _data            # 存放網(wǎng)站數(shù)據(jù)，使用.yml，.yaml，.json或.csv格式和擴展名可以通過site.data訪問它們
├── _includes        # 存放html模塊，可以在多個html頁面進行引用
├── _layouts         # 布局文件
├── _posts           # 用于存放博客文章
├── _scripts
├── _site           # 項目構建完成之后所生成的靜態(tài)文件存放于此，可將其到.gitignore文件中
│   └── assets      # 生成的靜態(tài)網(wǎng)頁的CSS 文件、JS 文件以及圖片文件
├── _plugins        # 插件
├── assets          #靜態(tài)資源文件
├── tabs
├── .travis.yml      # 刪除
├── .github          # 刪除
├── .gitignore
├── 404.html
├── Gemfile          # 存放項目所依賴的 Ruby gems
├── LICENSE
├── README.md
├── _config.yml       # 項目的配置文件，項目的全局配置在此
├── tools           
├── docs
├── feed.xml
├── index.html
├── robots.txt
└── sitemap.xml

2.根據(jù)注解大致修改-config.yml文件內(nèi)容后，可以執(zhí)行bundle exec jekyll serve 命令或者直接jekyll serve打開內(nèi)置的開發(fā)服務器，該命令可以構建并運行項目，啟動Jekyll自帶的 web server，在瀏覽器中直接訪問項目地址http://127.0.0.1:4000.。

一些常用命令

jekyll new PATH
#=>創(chuàng)建新項目

jekyll new PATH --blank 
#=>創(chuàng)建新的空項目

jekyll new-theme 
#=>創(chuàng)建一個新的主題腳手架

jekyll build 
#=>當前文件夾中的內(nèi)容將被生成到./_site

jekyll build --destination <destination>
#=>當前文件夾中的內(nèi)容將被生成到<destination>

jekyll build --source <source> --destination <destination> <source>
#=>文件夾中的內(nèi)容將被生成到<destination>

jekyll build --watch 
#=>當前文件夾中的內(nèi)容將被生成到./_site, 檢查改動，并自動重新生成

jekyll serve 或 jekyll s 
#=>構建并啟用內(nèi)置服務運行項目，開發(fā)服務將會運行在http://localhost:4000/  會自動監(jiān)聽文件變化并部署，對于 _config.yml 的修改不會自動部署

jekyll clean 
#=>清除所有的構建產(chǎn)物

部署

使用 GitHub Actions進行部署

確保您的 Jekyll 網(wǎng)站包含.github/workflows/pages-deploy.yml文件。否則，創(chuàng)建一個新文件并填寫示例文件的內(nèi)容，并且 on.push.branches值應與存儲庫的默認分支名稱相同。然后將您的存儲庫重命名為 <GH_USERNAME>.github.io。

現(xiàn)在發(fā)布您的Jekyll網(wǎng)站：

1.在GitHub 上瀏覽倉庫。選擇Settings選項卡，然后單擊左側導航欄中的Pages。然后，在Source部分（在Build and deployment下）中，從下拉菜單中選擇“GitHub Actions”。

2.將任何提交推送到遠程以觸發(fā) GitHub 操作工作流。在倉庫的Actions選項卡中，應會看到workflowBuild and Deploy正在運行”。生成完成并成功后，就會自動部署站點。

3.在 GitHub 指定的地址訪問您的網(wǎng)站。

手動構建和部署

在自托管服務器上，您無法享受GitHub Actions的便利。因此，應在本地計算機上生成站點，然后將站點文件上載到服務器。

轉到源項目的根目錄，并按如下所示生成站點：

JEKYLL_ENV=production bundle exec jekyll b

或者在 Docker 上構建網(wǎng)站：

 docker run -it --rm \
    --env JEKYLL_ENV=production \
    --volume="$PWD:/srv/jekyll" \
    jekyll/jekyll \
    jekyll build

除非指定了輸出路徑，否則生成的站點文件將放置在項目根目錄的文件夾中?，F(xiàn)在，您應該將這些文件上傳到目標服務器。

結束

至此一個Jekyll博客基本可以跑起來了，當然完全配置為自己的博客還需要修改很多東西，包括布局，collections數(shù)據(jù)等等。文章來源地址http://www.zghlxwxcb.cn/news/detail-679620.html

到了這里，關于Jekyll（一）.使用Jekyll+Github Pages搭建自己的博客的文章就介紹完了。如果您還想了解更多內(nèi)容，請在右上角搜索TOY模板網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關文章，希望大家以后多多支持TOY模板網(wǎng)！