搭建个人博客

个人博客搭建指北

搭建个人静态博客，Hexo+Next+Github Pages。

平台：macos

本地：nvm，JS一套，Hexo，Next主题

网站：免费github pages，或自己搞个云服务

本地配置

1. Xcode开发工具，带有一些基础环境和git

2. 安装本地NodeJS

   1. 这一步有坑，不要brew安装或者官网的sdk安装，会报错。在安装 Hexo 的过程中出现 EACCES 权限错误，这里不要看网上的建议，不要 使用 root、sudo 等方法覆盖权限。会报更大的错！

   2. 使用nvm或者nvs部署，这里用的是nvm。

      链接：https://github.com/nvm-sh/nvm

      terminal命令：

      curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh

      下完验证一下

      nvm -v

      如果没有，去配一下环境，别看网上一堆，要找mac zsh添加环境

   3. nvm安装node和npm

      nvm install node 可以指定版本，看一下nvm help

      装完验证一下，不行加环境变量

      node -v
      npm -v

3. 安装Hexo

   精简版

   npm install -g hexo-cli

   也可以用完整版安装指令，装完验证，要指定版本的话记得看一下版本对应

   hexo -v

4. 建站，创立项目文件夹

   hexo init <folder>
   cd <folder>
   npm install

   可以自定义路径，现在文件夹在主目录下，可以查看

5. 在文件夹安装Next主题

   cd your-hexo-site
   git clone https://github.com/iissnan/hexo-theme-next themes/next

   大功告成

Hexo

没有什么，是比官方文档更好使的教程！

中文：https://hexo.io/zh-cn/docs/ 英语：https://hexo.io/docs/index.html

创建文章，编辑source下的markdown文件。

hexo new [layout] <title>

生成

hexo g

服务器预览

hexo s

发布

hexo d

部署github

1. 安装 hexo-deployer-git。

   npm install hexo-deployer-git --save

2. 修改主config.yml配置

   deploy:
     type: git
     repo: <repository url> #https://bitbucket.org/JohnSmith/johnsmith.bitbucket.io
     branch: [branch]
     message: [message]

3. 生成站点文件并推送至远程库。执行 hexo clean && hexo deploy。注意，如果是从站，config里把前面的网站URL设置一下

GitHub Pages 源存储库的建议限制为1 GB。 有关详细信息，请参阅“关于GitHub 上的大文件” 发布的GitHub Pages 站点不得超过1 GB。 如果花费的时间超过10 分钟，GitHub Pages 部署将超时。

个人主页只能创建一个，项目主页可以创建多个

Next主题

同给出官方文档链接：

https://theme-next.iissnan.com/

似乎是旧版的，新版的我只找到更新日志，但是旧版大多通用

https://theme-next.org/index.html

在config里的修改theme，即可启用主题

theme: next

剩下的自定义功能还是去看官方文档吧

---

（ps: 第一次用typora写完一个文档，感觉好难用啊，有些本来要用上的html语法都识别不出来，:(，还有格式问题，不如直接vscode编辑，大呼上当)