Hexo创建博客

  1. 创建Github 域名和空间
    1.1注册
    首先你需要注册一个Github账号
    1.2 创建仓库
    然后需要创建一个仓库(repository) 来存储我们的网站,点击首页任意位置出现的 New repository按钮创建仓库, Respository name 中的username.github.io 的username 一定与前面的Owner 一致,记住你的username下面会用到。

  2. 安装
    Hexo 可以说是目前最流行的博客框架了,基于Nodejs,更多信息可以google,
    下面需要安装的工具包括 Git,Nodejs,Hexo。(Windows 用户自行搜索这些工具,直接安装即可,试过基本没啥问题)

安装Git

安装Nodejs
先安装nvm,这是Nodejs版本管理器,可以轻松切换Nodejs版本。

安装Hexo
以上所有都安装完成之后再安装Hexo

$ npm install hexo-cli -g

所有必须工具已经安装完成,下面我们就可以生成博客,上传至我们的Github 仓库了。

  1. 编写,发布
    接下来我们需要用Hexo初始化一个博客,然后更改一些自定义的配置,或者加上自己喜欢的主题,写上第一篇文章,然后发布到自己的个人Github网站(username.github.io)。

创建博客
将下面的 username 替换成你自己的username(其实也无所谓,作者强迫症),执行成功后,会创建出一个名为 username.github.io 的文件夹。

$ hexo init username.github.io

更改配置
主题安装
为了使博客不太难看,我们需要安装一个主题,切换至刚刚生成的Hexo 目录,安装主题

$ cd username.github.io
$ git clone https://github.com/iissnan/hexo-theme-next themes/next

这里选了一个极简的主题,也是Hexo众多主题中最受欢迎的一个。上面出现的喵神的主题 在这里。Hexo也有更多主题供你选择。
基础配置:打开文件位置username.github.io/_config.yml修改几个键值对,下面把几个必须设置的列出来按需求修改,记得保存, 还有注意配置的键值之间一定要有空格。更多设置...

title: dimsky 的 9 维空间 //你博客的名字
author: dimsky //你的名字
language: zh-Hans //语言 中文
theme: next //刚刚安装的主题名称
deploy:
type: git //使用Git 发布
repo: https://github.com/username/username.github.io.git // 刚创建的Github仓库

主题配置:
主题配置文件在username.github.io/themes/next/_config.yml中修改,这里略过。设置详情

写文章
所有基础框架都已经创建完成,接下来可以开始写你的第一篇博客了
在username.github.io/source/_posts下创建你的第一个博客吧,例如,创建一个名为FirstNight.md的文件,用Markdown大肆发挥吧,注意保存。
如:

 ---
 title: First Night
 ---
 > 我有一头**小毛驴**,可是我从来都不骑。

测试

$ hexo s

测试服务启动,你可以在浏览器中输入https://localhost:4000 访问了。

如果没有访问成功

npm install
npm install --save hexo-renderer-jade hexo-generator-feed hexo-generator-sitemap hexo-browsersync hexo-generator-archive

安装hexo-deployer-git自动部署发布工具

$ npm install hexo-deployer-git --save

发布
测试没问题后,我们就生成静态网页文件发布至我们的Github pages 中。
$ hexo clean && hexo g && hexo d
如果这是你的第一次,终端会让你输入Github 的邮箱和密码,正确输入后,骚等片刻,就会把你的博客上传至Github 了。以后在每次把博客写完后,执行一下这个命令就可以直接发布了,灰常苏胡。

安装过程遇到的坑

hexo切换Next主题之后,页面不渲染

解决方法:npm i hexo-renderer-swig
原因:hexo在5.0之后把swig给删除了需要自己手动安装

deploy之后, ERROR Deployer not found: git

辅助工具没安

npm install --save hexo-deployer-git

fatal: Authentication failed

fatal: Authentication failed for 'https://github.com/JimyFengqi/JimyFengqi.github.io.git/'

解决办法:
把配置项中的库的地址换了,将https换成git:

repo: git://github.com/username/username.github.io.git // 刚创建的Github仓库 

或者加上自己的token,因为现在github 使用token验证身份,这样也不用每次输入密码了

repo: git://token@github.com/username/username.github.io.git // 刚创建的Github仓库 

git报错 错误设置证书验证位置:(error setting certificate verify locations)处理

解决办法

在git bash窗口里面 ,执行命令:

办法1,修改为正确的位置:

git config --system http.sslcainfo "C:\Program Files (x86)\git\bin\curl-ca-bundle.crt"

(注意修改为正确的文件路径)

办法2,删除验证:

git config --system http.sslverify false
posted @ 2024-07-17 10:31  枫奇丶宛南  阅读(19)  评论(0编辑  收藏  举报