Hexo+Github+Netlify博客搭建教程 友情链接+踩坑注意事项
NIJIANBING233

前言

最近在编程导航上看到了这篇博客搭建指南。于是着手操作从零开始搭建了一个自己的 Hexo 博客。在过程中,大部分步骤比较顺利,但也踩了一些坑。为了帮助有同样需求的朋友少走弯路,我记录了自己的经验、工具选择以及注意事项,希望对你·有所帮助。


1. 使用 NVM 管理 Node.js 版本

在实际项目开发中,Node.js 是不可或缺的工具。为了便于管理多个版本的 Node.js,我推荐使用 **NVM (Node Version Manager)**。它可以快速安装和切换 Node.js 的版本,极大地方便了开发环境的配置。

参考教程:NVM 安装与使用指南


2. Git Bash 网络代理问题

使用 Git Bash 执行 Git 命令时,可能会遇到网络代理的问题,尤其是在访问 GitHub 时连接速度很慢甚至无法连接。

解决方案:


3. 个人域名购买与解析

个人域名的购买非常简单:

  1. 访问域名服务商网站(如阿里云)。

  2. 搜索你喜欢的域名,挑选性价比高的直接购买。

  3. 购买后,进入解析设置,添加两条解析记录即可完成域名绑定。

    记得一定要添加CNAME文件,每一次提交代码之后GitHub里面的CNAME文件都会被清除。想要持久化保存的话必须要在本地文件夹的source文件夹内添加CNAME文件,先就用记事本,然后把.txt后缀删掉就行,里面是你自己的网站比如wuhu233.site,CNAME不用后缀,把后缀去掉

参考阿里云域名购买指南


4. Hexo 初始化时的命名问题

运行 hexo init 时,一定要在命令后面跟上项目名称。例如:

1
hexo init my-blog

如果不指定名称,可能会导致初始化失败或报错。

5. Hexo 主题配置

Hexo 提供了丰富的主题供用户选择,主题配置是博客个性化的重要部分。以下是使用主题的步骤:

  1. 查找主题
    访问 Hexo Themes 官方页面 或者 GitHub 搜索自己喜欢的主题。

  2. 安装主题
    进入博客目录的 themes 文件夹,运行以下命令安装主题:

    1
    git clone https://github.com/iissnan/hexo-theme-next themes/next
  3. 修改配置
    打开博客根目录下的 _config.yml 文件,找到 theme 参数,将其修改为安装的主题名称,例如:

    1
    theme: next
  4. 阅读主题文档
    每个主题都会附带详细的文档,建议认真阅读文档了解主题的功能和个性化设置。

提示
如果不需要特别的个性化定制,只需调整 _config.yml 文件中的基础配置即可,节省时间和精力。


6. 关于 Netlify 的使用体验(不推荐使用)

Netlify 是一款优秀的静态网站托管工具,可以实现自动化部署和免费的 HTTPS 支持。然而,对于数据量较小的个人博客,手动部署往往更加高效。

手动部署步骤

  1. 在本地完成 Markdown 文件的编辑后,执行以下命令:

    1
    2
    3
    hexo clean
    hexo generate
    hexo deploy
    • hexo clean:清理旧的生成文件。
    • hexo generate:生成新的静态页面。
    • hexo deploy:将静态页面上传到 GitHub 仓库。
  2. 提交静态文件到 GitHub 后,即可通过 GitHub Pages 访问你的博客。

Netlify 的优缺点

  • 优点
    • 自动化构建和部署,操作简单。
    • 免费提供 SSL 证书,支持 HTTPS。
    • 支持定制化域名配置。
  • 缺点
    • 国内访问速度较慢。
    • 对于更新频率较低的小型博客,功能显得多余。

建议
如果你的博客更新频繁且需要简化部署流程,推荐使用 Netlify 的自动化功能;否则手动部署更适合日常使用。


7. 阅读官方文档的重要性

阅读官方文档 是掌握 Hexo 和其他技术的关键。官方文档通常提供以下内容:

  • 快速入门:如何快速搭建基础框架。
  • 配置说明:详解配置文件的参数及其用途。
  • 个性化功能:指导用户如何调整样式、功能和插件。

官方文档阅读建议

  1. 充分利用翻译工具
    如果官方文档没有中文版本,可以使用 沉浸式翻译插件,支持快捷翻译整个页面。常用快捷键:
    • Ctrl+A:一键翻译。
  2. 多动手实践
    仔细阅读 _config.yml 和主题的配置文件,结合文档进行调整,能够快速熟悉 Hexo 的工作原理。

提示
搭建博客的过程不仅是技术上的学习,更是对内容表达和个性化创作的一次探索。

总结经验:

使用合适的工具:如 NVM、Git Bash 和翻译插件。

多读文档:官方文档和主题文档是最可靠的参考资料。

量力而行:根据实际需求选择功能,避免过度定制。

 评论
评论插件加载失败
正在加载评论插件