
前言
最近在编程导航上看到了这篇博客搭建指南。于是着手操作从零开始搭建了一个自己的 Hexo 博客。在过程中,大部分步骤比较顺利,但也踩了一些坑。为了帮助有同样需求的朋友少走弯路,我记录了自己的经验、工具选择以及注意事项,希望对你·有所帮助。
1. 使用 NVM 管理 Node.js 版本
在实际项目开发中,Node.js 是不可或缺的工具。为了便于管理多个版本的 Node.js,我推荐使用 **NVM (Node Version Manager)**。它可以快速安装和切换 Node.js 的版本,极大地方便了开发环境的配置。
参考教程:NVM 安装与使用指南。
2. Git Bash 网络代理问题
使用 Git Bash 执行 Git 命令时,可能会遇到网络代理的问题,尤其是在访问 GitHub 时连接速度很慢甚至无法连接。
解决方案:
- 配置代理地址。
- 参考这篇博客:Git Bash 网络代理配置。
3. 个人域名购买与解析
个人域名的购买非常简单:
访问域名服务商网站(如阿里云)。
搜索你喜欢的域名,挑选性价比高的直接购买。
购买后,进入解析设置,添加两条解析记录即可完成域名绑定。
记得一定要添加CNAME文件,每一次提交代码之后GitHub里面的CNAME文件都会被清除。想要持久化保存的话必须要在本地文件夹的source文件夹内添加CNAME文件,先就用记事本,然后把.txt后缀删掉就行,里面是你自己的网站比如wuhu233.site,CNAME不用后缀,把后缀去掉
参考:阿里云域名购买指南
4. Hexo 初始化时的命名问题
运行 hexo init
时,一定要在命令后面跟上项目名称。例如:
1 | hexo init my-blog |
如果不指定名称,可能会导致初始化失败或报错。
5. Hexo 主题配置
Hexo 提供了丰富的主题供用户选择,主题配置是博客个性化的重要部分。以下是使用主题的步骤:
查找主题
访问 Hexo Themes 官方页面 或者 GitHub 搜索自己喜欢的主题。安装主题
进入博客目录的themes
文件夹,运行以下命令安装主题:1
git clone https://github.com/iissnan/hexo-theme-next themes/next
修改配置
打开博客根目录下的_config.yml
文件,找到theme
参数,将其修改为安装的主题名称,例如:1
theme: next
阅读主题文档
每个主题都会附带详细的文档,建议认真阅读文档了解主题的功能和个性化设置。
提示:
如果不需要特别的个性化定制,只需调整_config.yml
文件中的基础配置即可,节省时间和精力。
6. 关于 Netlify 的使用体验(不推荐使用)
Netlify 是一款优秀的静态网站托管工具,可以实现自动化部署和免费的 HTTPS 支持。然而,对于数据量较小的个人博客,手动部署往往更加高效。
手动部署步骤
在本地完成 Markdown 文件的编辑后,执行以下命令:
1
2
3hexo clean
hexo generate
hexo deployhexo clean
:清理旧的生成文件。hexo generate
:生成新的静态页面。hexo deploy
:将静态页面上传到 GitHub 仓库。
提交静态文件到 GitHub 后,即可通过 GitHub Pages 访问你的博客。
Netlify 的优缺点
- 优点:
- 自动化构建和部署,操作简单。
- 免费提供 SSL 证书,支持 HTTPS。
- 支持定制化域名配置。
- 缺点:
- 国内访问速度较慢。
- 对于更新频率较低的小型博客,功能显得多余。
建议:
如果你的博客更新频繁且需要简化部署流程,推荐使用 Netlify 的自动化功能;否则手动部署更适合日常使用。
7. 阅读官方文档的重要性
阅读官方文档 是掌握 Hexo 和其他技术的关键。官方文档通常提供以下内容:
- 快速入门:如何快速搭建基础框架。
- 配置说明:详解配置文件的参数及其用途。
- 个性化功能:指导用户如何调整样式、功能和插件。
官方文档阅读建议
- 充分利用翻译工具
如果官方文档没有中文版本,可以使用 沉浸式翻译插件,支持快捷翻译整个页面。常用快捷键:Ctrl+A
:一键翻译。
- 多动手实践
仔细阅读_config.yml
和主题的配置文件,结合文档进行调整,能够快速熟悉 Hexo 的工作原理。
提示:
搭建博客的过程不仅是技术上的学习,更是对内容表达和个性化创作的一次探索。总结经验:
使用合适的工具:如 NVM、Git Bash 和翻译插件。
多读文档:官方文档和主题文档是最可靠的参考资料。
量力而行:根据实际需求选择功能,避免过度定制。