Go GUI 库:在本地运行 fyne 官网

Go语言精选

共 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 仓库克隆。

  1. 下载压缩包之后,解压;
  2. cd 到解压之后的目录;
  3. 执行 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

安装依赖

cddeveloper.fyne.io目录,使用gem安装该网站的所有依赖:

$ gem install -g

gem 安装依赖的速度取决于你的网速,耐心等待~

本地运行网站

一切准备就绪,接下来只需要输入下面的指令网站就在本地运行起来了:

$ jekyll serve

一般会出现下面的错误:

这是应该有个依赖的版本问题,我们可以使用错误提示中的命令bundle启动:

$ bundle exec jekyll serve

运行成功:

这时,我们就可以在浏览器中输入:http://localhost:4000就可以在本地随意浏览官网了。

总结

本文介绍如何搭建 fyne 离线文档,大家可以触类旁通~

参考

  1. fyne.developer.io GitHub:https://github.com/fyne-io/developer.fyne.io
  2. Go 每日一库 GitHub:https://github.com/darjun/go-daily-lib


推荐阅读



学习交流 Go 语言,扫码回复「进群」即可


站长 polarisxu

自己的原创文章

不限于 Go 技术

职场和创业经验


Go语言中文网

每天为你

分享 Go 知识

Go爱好者值得关注



浏览 44
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报
评论
图片
表情
推荐
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报