Ghost 02 - Ghost 主题开发环境搭建

本文将介绍如何搭建 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 的开发模式应该是关闭了浏览器缓存,每次点击页面都会将资源重新刷新。语言包一类的资源并不在此列,应该是为了保证流畅性,所以没有动态编译语言文件

结束

下一篇将写一下怎么在零前端基础的情况下进行主题编辑。

发表于: 作者:JiapengLi
由于某种不存在的原因,评论区正在努力加载中……