本文将介绍如何搭建 Ghost Blog 主题开发环境,使用的主题框架为 handlebars
所有命令运行在 Windows Git Bash 下
开发环境
Node.js
https://nodejs.org/en/ 下载 node.js 软件。默认安装即可。(注意:node.js 可执行文件路径一定要添加至环境变量中)
Ghost 主程序
命令行下执行下列指令将依次安装 ghost-cli 、gscan 以及 ghost 主程序。
npm install ghost-cli@latest -g --verbose
npm install -g gscan --verbose
mkdir -p ghost/ghost-dev
cd ghost/ghost-dev
ghost install local
安装完成后,ghost-dev 下将保存 ghost 所有的安装文件。其中config.development.json 保存有开发环境的基础配置信息(本地端口号等等)。
启动 ghost
cd ghost/ghost-dev
ghost start
停止 ghost
cd ghost/ghost-dev
ghost stop
重启 ghost
cd ghost/ghost-dev
ghost restart
Ghost 主题
下载主题至本地:
cd ghost
git clone https://github.com/JiapengLi/ghost-theme-kaldorei.git
使用 cmd
指令 mklink
来创建主题文件路径软连接(仅限 Windows 平台,Linux 平台可以使用 ln
命令)。这里推荐使用软连接的形式,更简洁一些。软连接指向的是刚刚 clone 下来的仓库。
cd ghost/ghost-dev/content/themes
cmd //c mklink //D kaldorei "D:\\\\ghost\\\\ghost-theme-kaldorei"
这里下载的主题是基于 handlebars 框架的。参考官方文档:https://docs.ghost.org/api/handlebars-themes/ (基本涵盖了所有跟主题编辑相关的内容)
Ghost 配置
访问 http://localhost:2369/ghost/ 开始配置。根据指引填入相应信息即可。http://localhost:2369/ghost/ 页面是 Ghost 的控制台,所有相关的配置都可以在这个页面获取到。后续写新的文章也是在这个页面进行。
在 Design 页面选择 kaldorei 主题即完成了 Ghost 的主题开发环境搭建。访问 http://localhost:2369 ,查看具体效果。
其他
-
本地端口号定义在
ghost/ghost-dev/config.development.json
文件内 -
常用 ghost 指令
ghost ls ghost start ghost stop ghost log ghost restart
-
一些需要重启 Ghost 的情况
- i18n 修改 (编辑 local 目录下的 json 文件)
- 新建文件
-
Ghost 的开发模式应该是关闭了浏览器缓存,每次点击页面都会将资源重新刷新。语言包一类的资源并不在此列,应该是为了保证流畅性,所以没有动态编译语言文件
结束
下一篇将写一下怎么在零前端基础的情况下进行主题编辑。