部署Github Page
前言
一年前的这个时候,为了练练手搞了一个博客项目,不过一直以来都没有用过,因为动态的博客写起来并不是很方便,因此这几天又通过Gatsby搭建了一个简单静态博客。
部署步骤
- 安装Gatsby
最近都使用yarn了,能节省不少空间,速度还很快。
yarn global add gatsby
- 创建项目
为了快速搭建博客,我选择了lumen starter,通过gatsby cli的以下命令就可以创建一个全新的项目文件夹并把远程的starter拉进去了。
gatsby new blog git@github.com:wpioneer/gatsby-starter-lumen.git
拉下来以后我发现这个starter其实还存在不少问题:
-
prefixLink(非pages文件夹下静态文件路径)生产环境会出现路径错误。[Fixed by #34] -
开发环境装了eslint-config-airbnb却没有使用,作为一个编码规范洁癖感觉很难受,直接在.eslintrc里加上了该配置。[Fixed by #33] -
加上airbnb编码规范后以及import、react、jsxa11y插件的各种约束,很多文件都会提示警报,因为文件数量较少也就直接自己改了,不然似乎可以试试prettier。
- 部署前准备
-
更改config.toml中的所需要用到的配置项,此文件中设置的变量可直接通过require或import 'config’引入。
-
删除不必要的文件,如travis.yml以及/pages/articles/中的文章等。
-
在/components/自定义组件、在/pages/articles/中添加自己的文章、在/pages/pages/中添加需要增加的页面。
- 部署至Github Page
-
在config.toml中添加
linkPrefix="/yourProjectName"
这一段非常重要否则会导致生产环境下路径地址不正确。 -
运行
gatsby build --prefix-links && gh-pages -d public
或直接yarn run deploy
。 -
然后打开yourUsername/github.io/yourProjectName/可以发现部署已成功。
-
当然也可以把开发版本push到该项目的另一个branch中去方便管理。
- Gatsby优缺点
-
PROS:
-
基于React,对熟悉React的用户友好
-
客户端渲染,切换路由无须重载页面
-
热加载可实时编辑,开发效率高
-
-
CONS:
-
暂无官网,文档不够齐全
-
可供选择的Starter不够多
-
添加或删除文件暂不支持热加载,需要重新运行
gatsby develop
[Help Wanted]
-