Deploy hexo in win with wsl

在一台新的win11上面进行wsl以及hexo的部署

在win上进行从零开始的hexo安装部署。

wsl安装

首先在微软应用商店安装Ubuntu。

1. 建议版本：

   • Ubuntu 22.04 LTS

   • Ubuntu 20.04 LTS

2. 安装步骤：

   • 点击想要的版本

   • 点击 “获取” 或 “安装” 按钮

   • 等待下载和安装完成

3. 启动 Ubuntu

   • 在开始菜单中找到 Ubuntu 并启动
   • 首次启动会要求设置用户名和密码

由于使用命令行和手动下载的速度受到网络的影响较大，应用商店反而是最快的方式。。。

git配置与使用

wsl安装好之后自带git，所以只需要自己进行相关的设置就好了。

1. 配置用户信息

   # 设置全局用户名和邮箱（重要：与 GitHub 一致）
   git config --global user.name "你的GitHub用户名"
   git config --global user.email "你的GitHub邮箱"
   
   # 检查配置
   git config --list

2. 生成ssh密钥

   ssh-keygen -t ed25519 -C "your_email@example.com"
   # 或使用 RSA
   ssh-keygen -t rsa -C "your_email@example.com"
   
   # 一路回车使用默认设置

   其公钥和私钥均保存在~/.ssh中，可以通过``cat ~/.ssh/id_rsa.pub和cat ~/.ssh/id_rsa`查看。

   • 复制公钥内容，添加到 GitHub：

     1. 登录 GitHub → Settings → SSH and GPG keys

     2. 点击 “New SSH key”

     3. 粘贴公钥内容

   测试 SSH 连接：

   ssh -T git@github.com
      # 应该看到：Hi username! You've successfully authenticated...

之后自行clone已有项目或者创建新项目即可。

hexo安装和部署

这个过程主要分为三步：

1. 安装 Node.js 和 npm (Hexo 的运行环境)
2. 安装 Hexo CLI (Hexo 的命令行工具)
3. 创建并初始化第一个 Hexo 博客

安装 Node.js 和 npm

Hexo 基于 Node.js，所以我们首先需要安装它。推荐使用 NodeSource 的仓库来安装较新版本的 Node.js。

1. 更新系统包管理器

   首先更新软件包列表以确保获取最新的软件源信息。

   sudo apt update && sudo apt upgrade -y

2. 安装 Node.js

   访问 NodeSource仓库查看最新的安装指令。例如，要安装最新的 LTS 版本（推荐），可以执行：

   # 安装 curl 如果尚未安装
   sudo apt install curl -y
   
   # 获取并执行 NodeSource 安装脚本（以 20.x 版本为例）
   curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
   
   # 安装 Node.js（它会同时安装 npm 和 node）
   sudo apt-get install -y nodejs

3. 验证安装

   安装完成后，通过检查版本号来验证 Node.js 和 npm 是否成功安装。

   node --version
   # 应该输出类似 v20.x.x 的信息
   
   npm --version
   # 应该输出类似 10.x.x 的信息

   如果这两个命令都正确输出版本号，说明第一步成功。

安装 Hexo CLI

现在我们已经有了 npm，可以使用它来全局安装 Hexo 的命令行工具。

1. 使用 npm 安装 Hexo CLI

   sudo npm install -g hexo-cli

   -g参数表示全局安装，这样可以在系统的任何位置使用 hexo命令。

2. 验证 Hexo 安装

   hexo version

   如果安装成功，它会显示 Hexo 的版本号以及其他相关组件的版本。

创建并初始化第一个 Hexo 博客

环境准备好后，我们来创建博客项目。

1. 初始化博客

   选择一个想存放博客文件的目录，然后使用 hexo init命令。

   # 切换到常用的目录，比如 Home 目录下的 Projects 文件夹
   cd ~
   mkdir Projects
   cd Projects
   
   # 初始化一个名为 myblog 的博客文件夹
   hexo init myblog

2. 进入博客目录并安装依赖

   cd myblog
   npm install

   npm install会根据 package.json文件安装 Hexo 运行所需的额外依赖包。

3. 启动本地服务器预览

   现在，博客已经创建好了。可以启动本地服务器来查看效果。

   hexo server
   # 或者简写为 hexo s

   终端会输出类似以下信息：

   INFO  Hexo is running at http://localhost:4000 . Press Ctrl+C to stop.

4. 在浏览器中查看打开网页浏览器，访问 http://localhost:4000。将看到 Hexo 默认主题 “Landscape” 的示例博客。恭喜！Hexo 博客已经成功在本地运行了。

---

常用 Hexo 命令总结

命令	说明
hexo clean	清除缓存文件 (db.json) 和已生成的静态文件 (public)。在遇到奇怪的问题时，首先尝试运行此命令。
hexo generate或 hexo g	生成静态网站文件，输出到 public目录。
hexo server或 hexo s	启动本地服务器，用于预览博客。
hexo deploy或 hexo d	部署网站到服务器（如 GitHub Pages）。需要先配置 _config.yml。
hexo new "文章标题"或 hexo n "文章标题"	在 source/_posts目录下创建一篇新的文章。

典型的工作流程是：

hexo new "我的第一篇文章"  # 写新文章
hexo clean                # （必要时）清理
hexo generate             # 生成网站
hexo server               # 本地预览
# ... 反复修改和预览 ...
hexo deploy               # 部署到线上