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建博客过程的主要内容,如果未能解决你的问题,请参考以下文章

Github Pages + Hexo 建站图文教程

Github Pages + Hexo 建站图文教程

Github Pages + Hexo 建站图文教程

Github pages和Hexo搭建自己的博客

github pages 和 hexo 写自己的静态博客

GitHub Pages + Hexo搭建个人博客网站-github风格-采坑记录