簡介
要深入學習和理解一個框架，官方文檔是必須要仔細閲讀的。fyne 官網有非常系統和詳盡的文檔。官方網站：https://fyne.io/。有時候我們會有這樣一個需求——離線查看文檔。我經常乘坐高鐵來往杭州、上海兩地，地鐵、高鐵上通常網絡比較差，甚至沒有網絡。為此我特地去研究了一番怎樣搭建 fyne 離線文檔。
首先，我找到了 fyne 官方網站的 GitHub 倉庫，網址為https://github.com/fyne-io/developer.fyne.io。很快我發現 fyne 官網是採用 jekyll 構建的。jekyll 是採用 ruby 語言編寫的靜態網頁工具。jekyll 常用於搭建個人博客。它支持使用 markdown 語法編寫文章，然後自動生成相應的靜態頁面託管在遠程主機上供用户訪問。為了能本地運行文檔，我們必須先安裝 ruby + jekyll 環境。
Windows
在 Windows 平台上，我們可以從https://rubyinstaller.org/downloads/下載 RubyInstaller 直接雙擊安裝。這裏我們下載 Ruby+Devkit 2.6.6-1(x64)。
這會同時安裝 ruby 基本環境和 MSYS2 開發環境（用來編寫和編譯 C 擴展）。
默認會將可執行程序所在目錄加入 PATH 中：
MSYS2 開發環境默認也是安裝的：
ruby 安裝完成之後會使用 ridk 安裝 MSYS2 開發環境：
安裝完成之後，打開 cmd，輸入ruby -v。如果輸出正確的 ruby 版本信息，説明安裝成功。如果提示命令找不到，則未安裝成功，或環境變量設置不正確：
成熟的編譯語言通常都有相應的包管理工具，用於下載和管理依賴。正如 node 有 npm，python 有 pip，rust 有 cargo，ruby 也有它的 gem。gem 需要獨立下載安裝。下載地址https://rubygems.org/pages/download。我們可以直接下載壓縮包 TGZ/ZIP，或者 GEM 文件，或者使用 git 從 GitHub 倉庫克隆。
- 下載壓縮包之後，解壓；
- cd 到解壓之後的目錄；
- 執行 ruby setup.rb 安裝。
安裝完成之後，打開 cmd，輸入gem -v。如果輸出正確的 gem 版本信息，説明安裝成功。如果提示命令找不到，則安裝失敗，或環境變量設置不正確：
Mac
在 Mac 上可以直接使用 brew 安裝 ruby 和 gem。
安裝 jekyll
gem 安裝完成之後，安裝 jekyll 就很簡單了。只需要執行gem install jekyll等待安裝完成。
clone 官網倉庫
我們使用 git 將官網倉庫 clone 到本地計算機上：
$ git clone git@github.com:fyne-io/developer.fyne.io.git
安裝依賴
cd到developer.fyne.io目錄，使用gem安裝該網站的所有依賴：
$ gem install -ggem 安裝依賴的速度取決於你的網速，耐心等待~
本地運行網站
一切準備就緒，接下來只需要輸入下面的指令網站就在本地運行起來了：
$ jekyll serve一般會出現下面的錯誤：
這是應該有個依賴的版本問題，我們可以使用錯誤提示中的命令bundle啓動：
$ bundle exec jekyll serve運行成功：
這時，我們就可以在瀏覽器中輸入：http://localhost:4000就可以在本地隨意瀏覽官網了。
總結
本文介紹如何搭建 fyne 離線文檔，大家可以觸類旁通~
參考
- fyne.developer.io GitHub：https://github.com/fyne-io/developer.fyne.io
- Go 每日一庫 GitHub：https://github.com/darjun/go-daily-lib
我
我的博客：https://darjun.github.io
歡迎關注我的微信公眾號【GoUpUp】，共同學習，一起進步~
