本地环境配置
软件安装
安装如下软件:
- Node.js Node.js 官网
- Git Git 官网
检查是否安装成功,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 初始化配置
- 设置用户名和密码
git config --global user.name "rchangl"
git config --global user.email rchangl@outlook.com
–注意邮箱没有双引号
- 查看用户名和邮箱
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 | deploy: |
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 的博客