Hexo博客搭建(Mac)

lwxwl

墨衍会员 · AI 创作全网分发码龄10年

关注

原创最新推荐文章于 2024-04-16 22:04:50 发布 529 阅读 AI 写同款· GEO 优化 ›

AI权益加码！Claude Code、Cursor等20+工具免费用！购周边限时加赠Coding Plan Lite，畅享主流AI工具！学习进阶更高效！阅读详情

系统环境配置

配置Github

1. 创建代码库

Create a new repository

2. 开启GitHub Pages功能

点击Automatic page generator，Github将会自动替你创建出一个Github pages的页面。你可以通过http://username.github.io 来访问你的个人主页。

安装Hexo

在自己认为合适的地方创建一个文件夹（以blog）为例，cd进该文件夹，在命令行中输入：

$ npm install -g hexo-cli
$ npm install hexo --save

如果出现了以下情况，Hexo下载不下来：

可以尝试使用cnpm代替npm（后面的操作中如有类似问题，都可沿用此方法，后文不再赘述）

这里会要求输入用户密码，之后便可成功安装。

接下来可以输入$ hexo -v查看是否安装成功：

（如果对我的“终端”感兴趣，可以戳这里：iTerm2 + oh my zsh )

初始化Hexo

接着输入$ hexo init
然后输入$ npm install，之后npm将会自动安装你需要的组件，只需要等待npm操作即可。

使用Hexo

配置Hexo

可以直接在_config.yml中进行修改，也可以在命令行中输入$ vi _config.yml直接进行修改，修改的内容可以参考官方文档

这里贴上一些必要的配置(记得改lwxwl）：

常用的命令

$ hexo generate (hexo g)   // 生成静态文件，会在当前目录下生成一个新的叫做public的文件夹
$ hexo server (hexo s)     // 启动本地web服务，用于博客的预览
$ hexo deploy (hexo d)     // 部署播客到远端（比如github, heroku等平台）
$ hexo new "postName"      // 新建文章
$ hexo new page "pageName" // 新建页面

// 常用的组合
$ hexo d -g                // 生成部署
$ hexo s -g                // 生成预览

更换主题

相关推荐

官网上收录了常用的一些主题，可以自行查找。
以下列出Github上Star较多的一些主题：

yilia

Material Theme

Ochuunn

还有很多好看又好用的主题，这里就不一一列举了……

相关操作（以NexT为例）

还是先cd进你的博客文件夹，参考对应主题所给出的下载方法，如：

$ git clone https://github.com/iissnan/hexo-theme-next themes/next

接着修改_config.yml，找到theme字段，将其修改为对应的主题名称。

一些更加详细的配置要参考你所使用的主题和你的个人喜好而定。
最后走一遍流程：

$ hexo g
$ hexo s
$ hexo d

常见问题

这里推荐一个博客，里面整理的问题比较全面。

下面列出我搭博客时遇到的一些问题：

1. 页面没有渲染（partial转义失败）

解决方案：cd进博客所在目录下，执行$ npm install用以安装插件。

解决方案：执行$ npm install hexo-deployer-git --save安装对应的deploy模块，检查_config.yml中deploy板块是否配置好了，若未配置好，参考上文配置Hexo板块进行配置。