如何搭建本博客

安装Git

参考廖雪峰官方网站的Git教程

Windows 上,从Git官网下载安装 Git。

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

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

示例:

$ git config --global user.name "xw"
$ git config --global user.email "xieweikevin@qq.com"

使用SSH连接到GitHub

参考GitHub官网教程

生成新SSH密钥

(默认您初始没有 SSH 密钥,可使用下一节的方法检查您是否有任何现有的 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密钥

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

$ ls -al ~/.ssh
# Lists the files in your .ssh directory, if they exist

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

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

新增SSH密钥到GitHub账户

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

$ clip < ~/.ssh/id_ed25519.pub
# Copies the contents of the id_ed25519.pub file to your clipboard

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

将其添加到您的 GitHub 账户设置的 SSH and keys 中,参考官网教程

测试SSH连接以及将SSH密钥添加到ssh-agent等更多内容请参考 GitHub 官网教程

安装Node.js

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

将 “C:\Program Files\nodejs\” 和 “C:\Users\Kevin\AppData\Roaming\npm” 添加到 Windows 环境变量的系统变量中。

安装全局Hexo

使用命令行工具(例如 git bash)进入你的博客文件夹,依次输入以下指令安装 hexo 和 hexo 服务器模块(-g表示全局安装):

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

初始化博客:

$ hexo init blog

测试 hexo 是否安装成功(g 表示生成,s 表示在本地运行 hexo 服务器,这两条命令等价于命令 hexo generate 和 hexo server):

$ hexo g
$ hexo s

成功后会有提示,进入 http://localhost:4000/ 即可看到刚刚生成的网页。

常用命令

$ hexo new "pagename" 
$ hexo new page "pagename"
$ hexo clean
$ hexo g
$ hexo d
$ hexo s
$ git add -A
$ git commit -m "git tracks changes"
$ git push origin master

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

安装NexT

参考NexT官网

前往 NexT 版本发布页面,下载稳定版本 zip 压缩包,解压后重命名为 next 放至 themes 文件夹下即可。可在 next 文件夹下的 _config.yml 中设置 home 和 archives 路径,以及主题(我用的是 Gemini)。

参考资料

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

[2] 使用SSH连接到GitHub

[3] Hexo官网

[4] NexT官网

-------------End of this articleThanks for reading-------------