环境搭建

git下载与安装

下载git ，安装就直接下一步即可，注意环境变量。
验证是否安装正确

1
git -v

显示版本号就表示成功

node下载与安装

下载node,点get node.js,选择LTS（长期维护的版本）最新版，当前是V22.21.1
验证是否安装正确

1
node -v

显示版本号就表示成功

安装Hexo

所有必备的应用程序安装完成后，即可使用 npm 安装 Hexo。

1
npm install -g hexo-cli

验证是否安装正确

1
hexo -v

显示版本号就表示成功

使用hexo创建项目

初始化(创建)项目有以下两个方式，推荐第二种

安装 Hexo 完成后，请执行下列命令，Hexo 将会在指定文件夹中新建所需要的文件。

1
2
3
$ hexo init <folder>
$ cd <folder>
$ npm install

推荐在资源管理器中创建一个文件夹，文件夹名就是项目名，注意此文件夹必须为空，运行如下命令

1
hexo init .

注意，结尾必须有一个” . “,英文的点,表示在当前目录下创建项目。
初始化后，您的项目文件夹将如下所示：

安装依赖，就是项目根目录下的package.json里的dependencies里的内容

1
npm install

写文章（博客），可以在source/_posts目录下手动创建”.md”的文件，也可以通过命令创建

1
hexo new page --path about/me "About me"

以上命令会创建一个 source/about/me.md 文件，同时 Front Matter 中的 title 为 “About me”

1
hexo new index

这个命令会在source/_posts目录下创建一个index.md的文件。

安装主题(以 butterfly 为例)

1
git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

如果https的方式不行，就试试ssh的方式

1
git clone -b master git@github.com:jerryc127/hexo-theme-butterfly.git themes/butterfly

必须立刻解除绑定，否则会与工作流产生冲突，执行如下命令(已废除)如果未删除.git和.github文件夹就运行了，那就不许删除缓存了

1
~~ git rm -r --cached themes/butterfly~~

改为如下代码，作用是删除butterfly目录下的.git文件夹（注意这个是隐藏的）和.github文件夹，也可以不用代码，手动在资源管理器中删除。这样可以避免后续的workflows工作流自动部署的冲突。

1
rm -rf themes/butterfly/.git themes/butterfly/.github

以上命令会把仓库butterfly克隆到thems目录下的butterfly子目录中 并删除主题里的.git与.github文件夹。

修改 Hexo 根目錄下的 _config.yml，把主題改為 butterfly

theme: butterfly

安装这个主题所需要的依赖

1
npm install hexo-renderer-pug hexo-renderer-stylus

修改项目的而不是主题的根目录下_config.yml文件

1,cloudflare可以正常显示页面，github page不能正常显示的配置如下
url: https://gitychzh.github.io/hskt6
root: /
2，github pages可以正常展示页面，cloudflare不能正常展示如下
url: https://gitychzh.github.io
root: /hskt6 /
3，hskt6换成你自己的项目名，暂时没有更好的办法解决这个问题，可以考虑建两个仓库，分别部署。

升级建议

在 hexo 的根目錄創建一個文件 _config.butterfly.yml，並把主題目錄的 _config.yml 內容複製到 _config.butterfly.yml 去。注意，这个_config.butterfly.yml优先级比根目录下的_config.yml高，所以不用担心冲突。

项目本地编译与预览

1
hexo clean && hexo g && hexo s

以上命令，会清除缓存，并编译静态资源到public文件夹下，并生成一个http://localhost:4000的网页供本地预览

创建远程仓库并push上传到远端仓库

github 注册 登录 ，创建仓库，点New repository ,输入仓库名，其他留空，以为hskt为例

然后在本地执行如下命令(项目里执行)

1
2
3
4
5
6
git init 
git add .
git commit -m "first commit"
git branch -M master
git remote add origin git@github.com:gitychzh/hskt.git
git push -u origin master

也可以强制推送
git push -u origin master –force
第一次，以后就只需要git push即可 或者后面加–force

git 克隆仓库的时候，记得在末尾 加 点 . 表示在当前目录下下载资源。