博客搭建总结报告

简介

本文将简要介绍使用 hexo 框架搭建静态博客，并部署在 Github Pages 上。^[2]

Hexo 是一个基于 Node.js 的快速、简单且强大的静态博客框架。它使用 Markdown 格式来书写文章，并能够通过主题和插件进行个性化定制。

使用 GitHub Pages 部署 Hexo 博客是一种简单且免费的方式，可以让你的博客快速上线，并且拥有稳定的托管服务。

搭建步骤

安装与初始化

• 安装 Node.js 和 Git： Hexo 基于 Node.js，首先需要在计算机上安装 Node.js。同时，你也需要安装 Git，以便于版本控制和部署。

• 安装 Hexo： 使用 npm（Node.js 包管理器）安装 Hexo：

  npm install hexo-cli -g

• 初始化博客： 在命令行中执行以下命令来创建一个新的 Hexo 博客：

  hexo init blog
  cd blog
  npm install
  hexo server

主题与博客撰写

• Hexo 支持各种主题，根据自己的喜好选择。安装主题的方式通常是将主题文件夹放置在博客根目录下的 themes 文件夹中，并在 _config.yml 文件中进行相应配置。本 blog 使用的主题是 fluid 。

• 书写文章： 使用 Markdown 格式书写文章，并将其保存在 Hexo 博客的 source/_posts 目录下。

• 生成静态文件： 在命令行中执行以下命令来生成静态文件：

  hexo generate

• 本地预览： 生成静态文件后，可以在本地预览博客。执行以下命令：

  hexo server

  然后在浏览器中访问 http://localhost:4000 即可查看博客。

博客部署

• 创建 GitHub 仓库： 在 GitHub 上创建一个新的仓库，仓库名称应该为 <用户名>.github.io，例如 username.github.io。这个仓库将用于托管博客网站。

• 配置 _config.yml： 打开 Hexo 博客根目录下的 _config.yml 文件，在文件中找到 deploy 部分，修改配置如下：

  yamlCopy codedeploy:
    type: 'git'
    repo: git@github.com:<用户名>/<用户名>.github.io.git
    branch: master

  将 <你的用户名> 替换为你的 GitHub 用户名。

• 部署到 GitHub Pages： 在命令行中执行以下命令进行部署：

  hexo clean
  hexo generate
  hexo deploy

  执行完毕后，Hexo 会将生成的静态文件推送到 GitHub 上你创建的仓库中。

• 访问博客： 打开浏览器，访问 http://<用户名>.github.io，即可查看部署在 GitHub Pages 上的博客网站。

• 自定义域名： 在阿里云购买域名，并进行绑定。在仓库设置中添加自定义域名，并在域名服务商处进行相应的设置。本 blog 使用的域名为 vitaminzl.com .

问题

SSH

个人博客第3篇——绑定GitHub并提交文件这一篇中的绑定GitHub是必要的，否则在 个人博客第5篇——安装node.js和Hexo 最后一步，登录 http://xxxx.github.io 时跳不出Hexo网站^{<span class="hint--top hint--rounded" aria-label="github连接报"ssh: connect to host github.com port 22: Connection timed out"错误">[3]}。

22号端口被占用

$ ssh -T git@github.com
ssh: connect to host github.com port 22: Connection timed out

解决方法：切换到 cd ~/.ssh/ ，进入到~目录下面的.ssh下面，修改ssh配置，新建config文件

将上述文件添加配置^[4]：

Host github.com /*服务器地址为github地址*/
User "XXX@XX.com" /*github上的注册邮箱为用户账号*/
Hostname ssh.github.com /*服务器地址为github地址*/
PreferredAuthentications publickey /*采用公匙*/
IdentityFile ~/.ssh/id_rsa /*公匙文件路径*/
Port 443 /*修改端口为443*/

总结

在搭建 Hexo 博客的过程中，我学到了很多关于静态网站生成器和博客托管的知识，也收获了一些经验和体会^[1]。

1. 简单高效： Hexo 提供了简单易用的命令行工具，可以快速生成静态文件，而且基于 Markdown 格式书写文章十分高效，让我能够专注于内容创作而不用关心繁琐的网站构建细节。

2. 自定义性强： Hexo 的主题和插件系统为博客提供了丰富的个性化定制选项，我可以根据自己的喜好选择合适的主题，并通过插件添加各种功能和特性，让博客更具吸引力。

3. GitHub Pages 的便利： 将博客部署到 GitHub Pages 上不仅方便快捷，而且免费稳定。通过简单的配置和命令，就能够将博客部署到全球范围内访问，让我能够与更多人分享我的思考和见解。

4. 持续学习与改进： 在搭建博客的过程中，我遇到了一些问题和挑战，但通过查阅文档、搜索解决方案以及尝试不同的方法，我逐渐解决了这些问题，也提高了自己的技能水平。搭建博客不仅是一个项目，更是一个持续学习和改进的过程。

总的来说，搭建 Hexo 博客是一次愉快的经历，让我更加深入地了解了网站构建和博客托管的原理和方法，同时也提高了我的技能和经验。我期待着在这个新的博客平台上不断分享我的思考和创意，与读者们建立更深入的联系。

参考资料

1. chatgpt3.5 ↩︎
2. 从零开始搭建个人博客（超详细） ↩︎
3. github连接报"ssh: connect to host github.com port 22: Connection timed out"错误 ↩︎
4. github默认端口22被占用，ssh: connect to host github.com port 22: Connection timed out ↩︎