个人博客攻略(一) - 搭建个人博客

本地环境配置

软件安装

安装如下软件:

检查是否安装成功,cmd (命令提示符)命令:

npm -v

git -v

npm config set registry https://registry.npm.taobao.org 配置npm的淘宝镜像

安装 Hexo

npm install hexo-cli -g(这里-g 是全局安装)

hexo -v 检查 Hexo 安装是否成功

npm install hexo-deployer-git --save 安装 hexo-deployer-git 部署发布插件

初始化

创建一个空文件夹作为博客根目录,右键空白处点击 Git Bash Here

输入命令:

hexo init 初始化 Hexo ,服务器在国外,可能会失败,如果失败了需要多试几次或使用其他手段

Git 初始化配置

  1. 设置用户名和密码

git config --global user.name "rchangl"

git config --global user.email rchangl@outlook.com –注意邮箱没有双引号

  1. 查看用户名和邮箱

git config user.name

git config user.email

将本地的博客发布到Github

上面已经在本地搭建好了一个可以运行的博客,现在我们把它发布到Github上

首先去 Github 上注册一个账号,然后新建一个仓库 (repository)

仓库名字一定是 username.github.io username 是你 Github 注册的用户名

Github 与本地绑定

打开 Windows 用户文件夹(C:\Users\用户名),如果有 .ssh 文件夹将他删除

生成 SSH ,输入命令:

ssh-keygen -t rsa -C "rchangl@outlook.com" 。(注册Github的电子邮箱地址。)接下来的几个输入提示信息,直接按回车即可

此时,.ssh目录在 Windows 用户文件夹 下被产生,打开文件 id_rsa.pub 复制内容作为 SSH key

打开 Github 项目 -> Setting -> 侧栏下面的 Deploy Keys -> Add deploy key -> SSH and GPG keys -> SSH keys -> New SSH key 在 key 中输入上一步复制的SSH key, Titlle 任意起,Add添加,至此公钥添加完成

Git命令行中,输入命令:

ssh -T git@github.com 测试是否绑定成功 如有需要确认的提示,输入yes即可,看到 successfully 字样说明已经成功(因为网络等原因可能会失败,可以多试几次)

常规生成博客

hexo cl 清除已生成的文件(避免无用目录残留等)

hexo g 生成相关的网页文件

hexo d 将生成好的博客同步到 Github

本地预览服务

hexo s 打开本地预览服务,可以在浏览器中打开 http://localhost:4000/访问本地博客

配置 _config.yml 文件

上面创建的本地项目文件里有一个 _config.yml 文件,用文本编辑器打开,编辑最后面的部分,改成:

1
2
3
4
deploy:
type: git
repository: github地址
branch: main

github地址 就是项目的git地址 是github项目的网址加上 .git 在Github项目页面可以看得到

注意冒号后面是有一个空格的,这是yaml的语法要求

Git 命令行中,输入命令:

hexo g 生成文件

git config --global user.email "电子邮箱地址" 配置email

git config --global user.name "rchangl" 配置用户名

设置令牌:

进入网页 Github -> Setttings -> Developer settings -> Personal access tokens -> Generate new token

Note 随便起一个名字,Expiration 有效期自己看着选,Select scopes 令牌权限全选(有些用不到但是全选也没事),点击生成令牌

成功后跳转的页面有一串字符,一定将他记下,只能看到这一次,再次打开页面后无法再看到

Git 命令行输入命令:

hexo d 本地文件上传到Github上面,会弹出一个登录页面,登录即可,密码是上面生成的令牌

(如果报错 ERROR Deployer not found: git ,这是因为没安装 hexo-deployer-git 插件,文章开头的环境配置已说明需要安装)

完成后github上的仓库会有已上传好的文件。这时候可以在互联网访问博客了!网址:用户名.github.io

开始写博客

博客已经搭建好了,我们可以开始写博客了!


博客默认的样式的功能性或美观上有所不足,像是排版不够清晰、有些小功能没有,这时我们可以安装其他的主题。主题是别人已经写好的代码,只需要做一些简单的配置就可以使用,不用自己再去写代码来实现。


网站实例:RC 的博客