安装 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),在常用的文本编辑器中打开该文件,并将其复制到剪贴板。
- 在GitHub任何页面右上角,单击个人资料照片,然后单击“Settings”。
- 在边栏的“Access”部分中,单击“SSH and GPG keys”。
- 单击“New SSH key”。
- 在“Title”字段中为新密钥添加描述性标签。 例如,如果使用的是个人笔记本电脑,则可以将此密钥称为“个人笔记本电脑”。
- 在“Key”字段中,粘贴公钥。
- 单击“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社区维护版本