在本地运行 fyne 官网
source link: https://studygolang.com/articles/30508
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
简介
要深入学习和理解一个框架，官方文档是必须要仔细阅读的。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 [email protected]: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
我
我的博客： https://darjun.github.io
欢迎关注我的微信公众号【GoUpUp】，共同学习，一起进步~
有疑问加站长微信联系
Recommend
-
42
About Fyne is an easy to use UI toolkit and app API written in Go. We use OpenGL (through the go-gl and go-glfw projects) to provide cross platform graphics. The 1.0 rele...
-
24
作者简介 Chris Tozzi，曾担任记者和Linux管理员。对开源技术、敏捷基础架构以及网络问题兴趣浓厚。目前担任高级内容编辑，并且是Fixate IO的DevOps分析师。 Kubernetes的主要目的是通过复杂的负载均衡和资源...
-
30
简介 Go 语言生态中，GUI 一直是短板，更别说跨平台的 GUI 了。 fyne 向前迈了一大步。 fyne 是 Go 语言编写的 跨平台的 UI 库，它可以很方便...
-
10
昨天 Ian Lance Taylor 和 Robert Griesemer 发布了Go泛型的新的草案( The Next Step for Generics ), 国内外的Gopher反响非常的热烈，大家纷纷对草案和这个文章进行了解读，...
-
38
本地运行Go泛型代码 昨天 Ian Lance Taylor 和 Robert Griesemer 发布了Go泛型的新的草案(
-
20
Kubernetes作为最重要的开源容器编排平台，用于自动化部署，扩展和管理容器化应用程序。尽管大多数企业在云环境中运行Kubernetes，但不少企业选择在本地运行Kubernetes集群，因为首先在决定将其用作部署应用程序的主要平台之前，可以快速...
-
15
本地运行 Pug 文件漂洋过海来看你IT俱乐部-码出人生本地运行 Pug 文件Aug 19, 2020web41点...
-
7
Fyne设置中文 xiaojun1195 · 3天之前 · 209 次点击 · 预计阅读时间 1 分钟 · 大约8小时...
-
8
Self update for your Fyne application! Fynelabs has been working on solving the problem of distributing applications to mul...
-
5
A fresh new look, richer text and cloud integration delivers Christmas cheer! Whatever you celebrate at this time of year we hope you will enjoy this exciting, shiny new look release of the Fyne toolkit. With a refined design, cloud int...
About Joyk
Aggregate valuable and interesting links.
Joyk means Joy of geeK