# 前言
# 环境与工具安装
# 安装 Node.js 环境
前往官网：https://nodejs.org ，教程演示为长期维护版本 v18.15.0 ，也可以更改地址切换所需版本，选择 msi 格式进行下载
如果没有特殊要求一路 next 默认安装即可，安装后默认路径 C:\Program Files\nodejs
# 注册 GitHub 账户
- 前往官网：https://github.com ，注册账户
填写邮箱 👉 输入密码 👉 输入用户名 👉 是否通过邮箱方式接收产品更新和公告 👉 人机验证 👉 创建账户
# 安装 Git 终端
- 前往官网： https://git-scm.com/downloads ，选择对应的系统文件进行下载
如果没有特殊要求一路 next 默认安装即可，安装后默认路径 C:/Program Files/Git
# 创建 GitHub 仓库
- 注册完
GitHub账户后，点击左侧New按钮或者点击右上角+按钮 ，选择New repository，创建一个存储库
Repository name：创建仓库的格式<用户名>.github.ioDescription (optional)：仓库描述（选填）Public：互联网上的任何人都可以看到这个存储库。（选择）Add a README file：在这里你可以为你的项目写一个长描述。（可选）- 点击
Create repository进行创建
# Git 基本配置
- npm 指令有时候下载不动可能有多种原因，其中一种是 npm 的下载地址是国外的，导致下载很慢或者直接卡住不动，为了解决这个问题，你可以使用国内的镜像地址来下载 npm 模块，输入以下命令
npm install -g cnpm --registry=http://registry.npmmirror.com |
- 检查是否安装成功，安装成功之后，把
npm的命令换成是cnpm就可以了。
cnpm -v |
- 如果想要将 npm 的下载地址转回原来的地址，可以使用以下命令
npm config set registry https://registry.npmjs.org/ |
- 常用命令
git config -l #查看所有配置 | |
git config --system --list #查看系统配置 | |
git config --global --list #查看用户（全局）配置 |
- 配置用户名和邮箱
git config --global user.name "your username" #GitHub 的用户名 | |
git config --global user.email "your email" #注册 GitHub 的邮箱 |
- 使用
git config --global --list命令来检查配置文件，查看否配置成功，输出以下内容：
$ git config --global --list | |
http.sslverify=false | |
user.name="your username" #这里会出现你刚刚配置的用户名和邮箱 | |
user.email="your email" #你设置的邮箱 | |
filter.lfs.clean=git-lfs clean -- %f | |
filter.lfs.smudge=git-lfs smudge -- %f | |
filter.lfs.process=git-lfs filter-process | |
filter.lfs.required=true |
# 生成配置 ssh 公钥
- 输入以下命令生成 ssh 公钥，回车后会让你设置路径和密码，也可以不设置直接回车
ssh-key -t rsa -C "your email" |
ssh 公钥文件默认路径： C:\Users\username\.ssh\id_rsa.pub ，打开全选复制
- 进入 GitHub 👉
点击头像👉 选择Settings👉 点击左侧SSH and GPG keys👉 点击New SSH key
Title：标题随便填key： 粘贴 ssh 公钥- 点击
Add SSH key进行添加
- 使用
ssh -T git@github.com命令测试连接
$ ssh -T git@github.com | |
Hi chinoaider! You've successfully authenticated, but GitHub does not provide shell access. |
出现连接到账户的信息，说明连接成功
# 安装初始化 Hexo
- 打开 CMD 窗口，输入命令安装 hexo 脚手架
npm install hexo-cli -g |
- 创建一个用于存放项目的文件夹，使用
cd命令进入到你的文件夹目录下，或者在该文件夹下右键选择Git Bash Here，打开Git终端输入命令，执行hexo init命令初始化项目
hexo init "project name" #项目名 |
- 进入
your project，输入nmp i安装相关依赖
cd "your project" #进入到你的项目目录下 | |
npm i |
- 初始化项目后，目录结构如下
node_modules ：依赖包
scaffolds ：模版文件夹，当新建文章时，Hexo 会根据 scaffold 来建立文件
source ：存放用户资源的地方
themes ：主题文件夹，默认安装 landscape 主题，可以安装新主题到 themes 目录
.gitignore ：发布时忽略的文件（可忽略）
_config.landscape.yml ：主题的配置文件
_config.yml ：网站的配置信息文件，可以在此配置大部分的参数
package.json ：应用程序的信息。可以查看 hexo 的版本以及安装的扩展版本
- 输入以下命令，启动项目，
hexo s：启动本地服务器，用于预览网站。
hexo server | |
hexo s #缩写 |
- 执行命令后出现以下信息
INFO Hexo is running at http://localhost:4000/ . Press Ctrl+C to stop. |
在浏览器地址栏输入 http://localhost:4000/ 访问本地部署的 hexo 项目
如果显示正常说明本地部署项目成功
# 将项目挂载到 GitHub
- 安装部署所需依赖（在项目根目录下执行）
npm install hexo-deployer-git --save |
- 修改
_config.yml文件，末尾处username改成你的用户名，repository改成仓库名，主分支main
deploy: | |
type: git | |
repository: git@github.com:username/repository.github.io.git | |
branch: main |
- 将代码部署到
GitHub
hexo clean && hexo generate && hexo deploy | |
hexo clean && hexo g && hexo d #缩写 |
hexo clean ：清除缓存文件 db.json 和已生成的静态文件 public。网站显示异常时可以执行这条命令试试。
hexo g ：生成网站静态文件到默认设置的 public 目录。
hexo d ：自动部署网站静态文件，并部署到设定的仓库。
- 在
GitHub选择你的项目仓库，点击Settings选择左边的Pages这里的GitHub Pages会自动给你部署一个站点，供所有人访问
点击 Visit site 参观网站
# css 样式加载失败
- 如果出现 css 样式加载失败的情况，到
<root>/_config.yml，修改url
url 改成你项目仓库的路径即可
# 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/repository | |
#permalink: :year/:month/:day/:title/ | |
permalink: :title/ | |
permalink_defaults: | |
pretty_urls: | |
trailing_index: true # Set to false to remove trailing 'index.html' from permalinks | |
trailing_html: true # Set to false to remove trailing '.html' from permalinks |
再次访问，显示正常了
至此 Hexo 博客基础搭建完成～🎉
