Go GUI 库:在本地运行 fyne 官网
共 1864字,需浏览 4分钟
·
2020-09-05 04:26
简介
要深入学习和理解一个框架,官方文档是必须要仔细阅读的。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 -g
gem 安装依赖的速度取决于你的网速,耐心等待~
本地运行网站
一切准备就绪,接下来只需要输入下面的指令网站就在本地运行起来了:
$ 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
推荐阅读
站长 polarisxu
自己的原创文章
不限于 Go 技术
职场和创业经验
Go语言中文网
每天为你
分享 Go 知识
Go爱好者值得关注