Hexo搭建个人博客-Mac/Windows-Coding/Github/码云各种平台完全介绍

博客搭建 Hexo

博客搭建

发布日期: 2020-04-13

更新日期: 2023-11-02

文章字数: 1.3k

阅读时长: 4 分

阅读次数:

配置环境

方法一：官网下载（新手推荐） https://nodejs.org/en/

下载成功后，运行node-vXX.XX.XX.pkg进行安装

方法二：Mac，如果安装了brew,可通过命令安装
brew install nodejs
如果brew很久没用了，使用上述命令时还可能会先升级brew,比较费时

安装完成后，分别输入 node -v 和 npm -v 验证是否安装成功

Windows：管理员身份启动终端，终端输入npm install -g hexo 开始安装
Mac：终端输入sudo npm install -g hexo 开始安装
进入到想要创建Hexo博客的文件夹，终端输入hexo init xx进行克隆(xx代表创建的目录名称，以下如同)，这样就会在当前目录下，创建一个xx目录，就是你的博客目录
cd xx进入该目录，执行npm install安装node_modules依赖
执行hexo server进行本地测试，根据输出的地址，在浏览其中打开http://localhost:4000，若打开了Hexo的网页即代表成功，如果网页一直在等待中，可能是端口被占用了，通过以下命令更改端口即可hexo server -p 5000
Ctrl + C 关闭该服务

至此，环境已经搭建完成，接下来就要设置自己喜欢的网页主题了

选择好主题后，根据主题github上的说明进行下载安装，此处以matery主题为例
matery主题的github说明地址为 https://github.com/blinkfox/hexo-theme-matery/blob/develop/README_CN.md
根据提示执行操作
进入themes目录 cd themes
克隆主题 git clone https://github.com/blinkfox/hexo-theme-matery.git

修改 Hexo 根目录下的 _config.yml 的 theme 的值：theme: hexo-theme-matery

修改 Hexo 根目录下的 _config.yml 的deploy,repository设置为你的仓库地址，这里我使用的HTTPS的方式，SSH的方式太复杂，就不使用了，想用SSH的同学查一下用法。

deploy:
  type: git
  repository: https://e.coding.net/hansion_it/Blog.git
  branch: master

在浏览器中打开git给你分配的域名或者你自定义的域名，查看是否打开成功，与本地测试时显示相同
若使用的是码云，可能样式显示存在问题，需要修改Hexo 根目录下的 _config.yml中的url和root分别为你的域名和仓库名，例如：
```
url: http://xxxxx.io
root: /blog
```
DNS解析生效需要时间，同时注意浏览器缓存的影响

创建一个文章文件 hexo new "你的文章名称"，会在/source/_posts/目录下创建你的文章名称.md文件
在该.md文件内书写文章内容，文件内已默认创建了文章属性,若想添加其他属性，可参考主题的使用文档，一般来说都通用，这里以matery主题为例：https://github.com/blinkfox/hexo-theme-matery/blob/develop/README_CN.md#front-matter-%E9%80%89%E9%A1%B9%E8%AF%A6%E8%A7%A3
写完文章后，hexo g生成相关文件
hexo s本地预览一下，看看有没有问题
没有问题，hexo d提交

打开域名管理控制台，此处以阿里云为例，增加解析，添加两条CNAME记录，对应ipages域名
在博客的source目录新建一个文件，名称为CNAME，里面写入要自定义的域名，如www.hansion.win，然后hexo g,hexo d生成部署一下
在Github pages设置中，填写自定义域名后保存。