Wei Xie's Blog
0%

如何搭建本博客

Posted on Edited on In

安装 Git

以下内容参考自廖雪峰官方网站的Git教程

Windows 上，从Git官网下载 Git 并安装。

安装完成后，还需要最后一步设置，在 Git Bash 命令行输入：

$ git config --global user.name "Your Name"
$ git config --global user.email "email@example.com"

使用 SSH 连接到 GitHub

以下内容参考自GitHub官网教程

检查现有 SSH 密钥

在 Git Bash 中输入如下命令以查看是否存在现有SSH密钥：

$ ls -al ~/.ssh

检查目录列表以查看是否已经有 SSH 公钥。 默认情况下，公钥的文件名是以下之一：

- id_rsa.pub
- id_ecdsa.pub
- id_ed25519.pub

生成新 SSH 密钥

生成新 SSH 密钥，在 Git Bash 中粘贴下面的文本（替换为您的GitHub电子邮件地址）

$ ssh-keygen -t ed25519 -C "your_email@example.com"

提示您 “Enter a file in which to save the key（输入要保存密钥的文件）” 时，按 Enter 键。 这将接受默认文件位置。

> Enter a file in which to save the key (/c/Users/you/.ssh/id_ed25519):[Press enter]

在提示时输入安全密码。 For more information, see “Working with SSH key passphrases.”

> Enter passphrase (empty for no passphrase): [Type a passphrase]
> Enter same passphrase again: [Type passphrase again]

将 SSH 密钥添加到 ssh-agent

手动启动 ssh-agent

$ ssh-agent bash

在无提升权限的终端窗口中，将 SSH 私钥添加到 ssh-agent

$ ssh-add C:/Users/YOU/.ssh/id_ed25519

或

$ ssh-add C:\\Users\\YOU\\.ssh\\id_ed25519

新增 SSH 密钥到 GitHub 账户

如果您的 SSH 公钥文件与示例代码不同，请修改文件名以匹配您当前的设置。 在复制密钥时，请勿添加任何新行或空格。

$ clip < ~/.ssh/id_ed25519.pub

提示：如果clip不可用，可找到隐藏的.ssh文件夹（C:\Users\xw.ssh），在常用的文本编辑器中打开该文件，并将其复制到剪贴板。

  1. 在GitHub任何页面右上角，单击个人资料照片，然后单击“Settings”。
  2. 在边栏的“Access”部分中，单击“SSH and GPG keys”。
  3. 单击“New SSH key”。
  4. 在“Title”字段中为新密钥添加描述性标签。 例如，如果使用的是个人笔记本电脑，则可以将此密钥称为“个人笔记本电脑”。
  5. 在“Key”字段中，粘贴公钥。
  6. 单击“Add SSH key”。

测试 SSH 连接

$ ssh -T git@github.com

验证生成的消息包含您的用户名，则连接成功了。

> Hi USERNAME! You've successfully authenticated, but GitHub does not provide shell access.

安装 Node.js

在Node.js官网下载并安装。默认设置即可，无需勾选 “自动安装必要工具”。

检查 “C:\Program Files\nodejs\” 是否已添加到 Windows 环境变量的系统变量中。

安装全局 Hexo

在 GitHub 新建一个私有仓库，例如 hexo，将该仓库 git clone 克隆到本地。打开本地 hexo 文件夹，在空白处右键选择Git Bash Here，依次输入以下指令安装 hexo 和 hexo 服务器模块（-g表示全局安装）：

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

执行完成后，hexo文件夹内会生成子文件夹node_modules、文件package.json和package-lock.json

初始化博客：

$ hexo init blog

执行完成后，hexo文件夹内会多出子文件夹blog，git bash进入该文件夹

$ cd blog

在blog文件夹内，测试 hexo 是否安装成功（g 表示生成，s 表示在本地运行 hexo 服务器，这两条命令等价于命令 hexo generate 和 hexo server）：

$ hexo g
$ hexo s

成功后会有提示，进入 http://localhost:4000/ 即可看到刚刚生成的网页。按 Ctrl + C 停止运行。

将 hexo 部署到 GitHub

在 GitHub 创建仓库

在 GitHub 新建一个公共仓库，Repository name（仓库名）必须是“你的 GitHub 用户名.github.io”，Description（描述）和 Initialize this repository with: add a README file（初始化仓库时添加一个说明文件）均为可选项。

修改 hexo 配置文件

在 blog 文件夹下找到 _config.yml 文件，这是你的 hexo 博客的配置文件，用 sublime 或 VSCode 或 记事本打开，找到下面两处设置的位置，将其按如下的内容修改，username 换成你的 GitHub 用户名。

# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
type: git
repo: https://github.com/username/username.github.io.git
branch: master

另一处，

# URL
## Set your site url here. For example, if you use GitHub Page, set url as 'https://username.github.io/project'
url: https://username.github.io/

安装 Git 部署命令工具

npm install hexo-deployer-git --save

然后执行下面三行命令后，就可以在 username.github.io 访问你的博客啦！

$ hexo clean
$ hexo g
$ hexo d

常用命令

Git 常用命令

$ git add -A
$ git commit -m "git tracks changes"
$ git push origin master

Hexo 常用命令

$ hexo new "pagename" 
$ hexo new page "pagename"
$ hexo clean
$ hexo g
$ hexo d
$ hexo s

其中，hexo new “pagename” 表示在 source/_post/ 下新建页面，hexo d 表示 push 到服务器。

Hexo 个性化

用 sublime 或 VSCode 或 记事本打开 blog 文件夹你的博客的配置文件 _config.yml，可以设置博客标题、作者姓名、语言等等

安装 NexT

注意：NexT原官网对应的Next原仓库已不再维护，社区维护版本是Next社区维护版本

克隆Next社区维护版本到blog目录下的 themes/next

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

在 Hexo 根配置文件 中设置主题：hexo/blog/_config.yml

theme: next

Next 个性化

在 next 文件夹下的 _config.yml 中设置 home 和 archives 路径，以及主题（本博客使用的是 Gemini 主题）。

参考资料

[1] 廖雪峰官方网站的Git教程

[2] 使用SSH连接到GitHub

[3] Hexo官网

[4] Next社区维护版本