本仓库对应博客地址:https://jolly336.github.io
- 博客仓库使用 hexo 分支来保存基于 hexo 框架的源文件;hexo 生成的静态博客 html 文件默认放在 master 分支上;
- 如果要更新博客主题,需要把主题拷贝至 theme 文件夹下;
- hexo 分支源文件没有保存 node_modules 文件夹,使用时需要执行
npm install
命令来拉取 hexo 框架依赖;
具体可参考这篇博客设置!
- node_modules: hexo 需要的模块,需要 git 忽略,可以本地执行
npm install
获取 - themes 主题文件夹,如果需要更新主题,可以拷贝主题到这里即可)
- sources 博文 md 文件
- public 框架生成的静态网页(git 忽略)
- package.json 记录 hexo 需要的包信息
- _config.yml 全局配置文件
- .gitignore git 忽略配置
- hexo s --debug 可以在本地部署blog,localhost:4000即可,--debug是输出调试日志
- hexo g 生成html文件等
- hexo d 部署文章到 github.io,因为本地已经关联了github的账号,具体设置在 hexo 分支的 _config.yml 全局配置文件里
- hexo new "xx" xx是文章title,具体的tag和category可以在MD文件中设置
流程:
- 在仓库 hexo 分支上使用命令创建文章
hexo new "xx"
- hexo s --debug 本地预览调试
- hexo g 生成 html 静态网页
- hexo d 快捷部署到 github
- 安装 Node
hexo 使用 Node.js 编写,需要先安装 node,具体可以参考 使用 nvm 管理不同版本的 node 与 npm。
详细步骤:
-
终端执行
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.1/install.sh | bash
命令安装来 nvm,其中 v0.35.1 是版本号,最新版本命令去这里获取 Github/nvm; -
添加如下配置到
~/.bash_profile
文件里,再执行source ~/.bash_profile
命令 重新刷新下配置;export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")" [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm
-
安装 Node
执行
nvm install 13.3.0
安装 Node,13.3.0 为版本号,最新版本号查看这里;
- 安装 Hexo
使用 node nmp 包管理器来安装依赖模块
// 安装 hexo
npm install hexo-cli -g
// 在自己博客文件夹下执行
hexo init
// 安装依赖
npm install
// 写博客/发布等等...
hexo new "xx" 创建文章
hexo generate 本地生成静态网页
hexo server 本地发布
- npm install 报各种 permissions denied
hexo 框架使用 Node.js 编写,本地环境需要安装 Node.js,具体安装请参考官网,官方推荐用 nvm 管理器来安装,不推荐使用 brew install node
,因为 node 的包管理器-npm 后面安装其他依赖时,会报各种 permissions 错误! nvm 安装 node 可以参考 使用 nvm 管理不同版本的 node 与 npm。
- npm install 报错
使用 nvm 安装 node 之后,npm install 其他依赖时还会报权限错误,可以忽略,不影响使用!
hexo
Node 安装
错误