windows hexo+github page建博客过程
Posted Eritque arcus
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了windows hexo+github page建博客过程相关的知识,希望对你有一定的参考价值。
hexo+github page建博客过程
本博客适用于windows环境
参考资料hexo中文文档
1. 环境
github
要一个账号
一个储存库(github pages在这个储存库是公开的时候是免费的,私有的要钱)
git
git可以说是一个github的客户端,用于同步代码到github的参考
从浏览器下载git
nodejs
hexo的本地环境需要nodejs,建议用nvm作为版本管理器(不使用n是因为在windows上不能用)
不使用nvm
直接去浏览器搜索nodejs下载最新版,npm会附加在nodejs下载
使用nvm
1.下载nvm
从nvm官方github的release里下载setup.zip解压然后用里面的文件安装
2.更改镜像地址
用win+r打开cmd,输入
nvm node_mirror https://npm.taobao.org/mirrors/node/
nvm npm_mirror https://repo.huaweicloud.com/npm-software/
这两条命令配置淘宝和阿里云的镜像
或参考这里
3.安装nodejs和npm
使用
nvm ls availabe
查看可用版本,建议选LTS上第一个,如
现在是14.16.0
然后输入
nvm install 14.16.0
安装,如果有报错什么的要么自己下载文件解压到指定位置,要么先nvm uninstall 14.16.0
把没有安装完全的卸载,重新安装
可能的问题
其中,我在安装的时候阿里云的镜像下载下来的npm文件文件名不对,可以自己去下载npm的压缩包,解压放到nvm安装路径/temp
里,文件夹名字就用npm的名字,如npm-6.14.11
,就会在下一次安装的时候自动加载你下载的文件夹
4.把版本设为使用
用nvm list
查看当前已下载版本,然后用nvm use version
设为使用,如nvm use 14.16.0
,然后nvm会自动加环境变量
5.检查
输入
node -v
npm -v
检查2个是否安装
2.hexo
1.下载hexo
一般来说按照中文文档来就行了
也就是说在CMD内输入
npm install -g hexo-cli
来安装
2. 新建hexo
在任意一个空文件夹内打开cmd(用cd命令进入这个空文件夹)
输入hexo init
或在任意文件夹中用cmd输入
hexo init <foldername>
就会自动新建个文件夹叫后面这个名字,如hexo init hexo
就会新建个hexo文件夹放网站内容
下面将会称这个文件夹为网站根目录
然后可以在_config.yml
里自定义自己网站的介绍内容,在source/_post
里写博客的博文
如果_config.yml
里单引号括起来的内容里要有单引号,如title: 'Eritque arcus's blog'
记得要改成双引号,如title: "Eritque arcus's blog"
3. hexo本地查看
总共3个命令,需要在网站根目录执行
hexo clean
清除已经有的静态文件(也就是public文件夹)
hexo g
生成静态文件(也就是网站内容)到public文件夹
hexo s
启动本地服务,下面会弹出网址,在浏览器打开就可以预览
4. 自动化上传到github page
安装hexo-deployer-git
官方github
在网站根目录执行npm install hexo-deployer-git --save
即可安装
配置
打开_config.yml
文件,在最下面找到
deploy:
type: ''
覆盖成
deploy:
type: git
repository: git@github.com:Nambers/Nambers.github.io.git
branch: main
其中,branch是你打算放网站的分支,可以是任意,然后在github仓库的github page也要改成当前分支
然后repository为仓库地址,可以在仓库页面获取
是https的或者SSH都可以
然后先在网站根目录把上面说的那些命令执行一遍,即
hexo clean
hexo g
然后输入
hexo d
接下来github会要求登录,按照要求登录即可,或者先在git客户端登录你的github账号,具体参考搜索引擎(如根据官方文档或简书等其他的)
接下来等这个命令执行完就上传成功了
3.可能遇到的问题
1. 127.0.0.1:xx端口refuse
检查git代理,如果有就去掉,这个解决方法在搜索引擎上有很多如这个
2. timeout或者其他下载github文件的问题
挂镜像
3. npm/node在nvm安装和使用use设定版本后还是找不到
nvm uninstall
这个版本然后重装,可能是安装的时候报错了
以上是关于windows hexo+github page建博客过程的主要内容,如果未能解决你的问题,请参考以下文章