搭建博客过程中遇到的问题
首先安装Git和node.js。(按操作流程就行)
登录你的github账号并创建一个仓库
创建一个仓库:填写的仓库名一定为“用户名.github.io”,用户名一定和要和左边用户名一样(切记),不然会在最后将hexo部署到github上时出错!!!
在合适的位置创建一个文件夹。(桌面就是一个不错的选择)
如果不建文件夹就会这样
成功的界面是这样的
部署到github(这里着实问题有点大,哈哈哈!!!)
1,编辑根目录下_config.yml文件,添加如下代码并进行保存(agaion1110记得改成自己的github用户名)
因为最新的GitHub创建库分支默认为main
记住要添加的地方可不仅仅是一个地方哟!!!(还有blog子文件里的_config.yml呦)
如果不把这里面代码修改,后期部署是会有问题的。
2,添加秘钥(小心,你可能会找错)
3,设置你的账号信息。name与email后需输入自己的名字与邮件地址。
4,最后一步进入博客所在目录,右键打开 Git Bash Here,创建博文:
hexo new “My New Post”
然后 source 文件夹中会出现一个 My New Post.md 文件,就可以使用 Markdown 编辑器在该文件中撰写文章了。
写完后运行下面代码将文章渲染并部署到 GitHub Pages 上完成发布。以后每次发布文章都是这两条命令。
hexo g # 生成页面
hexo d # 部署发布
也可以不使用命令自己创建 .md 文件,只需在文件开头手动加入如下格式 Front-matter 即可,写完后运行 hexo g 和 hexo d 发布。
title: Hello World # 标题
date: 2019/3/26 hh:mm:ss # 时间
categories: # 分类
- Diary
tags: # 标签 - PS3
- Games
摘要
正文
网站设置
包括网站名称、描述、作者、链接样式等,全部在网站目录下的 _config.yml 文件中,参考官方文档按需要编辑。
注意:冒号后要加一个空格!
更换主题
在 Themes | Hexo 选择一个喜欢的主题,比如 NexT,进入网站目录打开 Git Bash Here 下载主题:
git clone https://github.com/iissnan/hexo-theme-next themes/next
然后修改 _config.yml 中的 theme 为新主题名称 next,发布。(有的主题需要将 _config.yml 替换为主题自带的,参考主题说明。)
常用命令
hexo new “name” # 新建文章
hexo new page “name” # 新建页面
hexo g # 生成页面
hexo d # 部署
hexo g -d # 生成页面并部署
hexo s # 本地预览
hexo clean # 清除缓存和已生成的静态文件
hexo help # 帮助
8 常见问题
1、Hexo 设置显示文章摘要,首页不显示全文
Hexo 主页文章列表默认会显示文章全文,浏览时很不方便,可以在文章中插入 进行分段。
该代码前面的内容会作为摘要显示,而后面的内容会替换为 “Read More” 隐藏起来。
2、设置网站图标
进入 themes/主题 文件夹,打开 _config.yml 配置文件,找到 favicon 修改,一般格式为:favicon: 图标地址。(不同主题可能略有差别)
3、修改并部署后没有效果
使用 hexo clean 清理后重新部署。
4、开启 HTTPS 后访问网站显示连接不安全?
证书还未部署生效,等待一会儿,清除浏览器缓存再试。
5、Mac 安装 Hexo 报错无法安装
Mac 用户需要管理员权限运行,使用 sudo npm install -g hexo-cli 命令安装。
6、npm 下载速度慢,甚至完全没反应
使用 npm 安装程序等待很久也没反应,或者下载速度很慢,可以更换 npm 源为国内 npm 镜像。
临时更换方法:在 npm 安装命令后面加上:
–registry https://registry.npm.taobao.org
结语
Hexo 是一种纯静态的博客,我们必须要在本地完成文章的编辑再部署到 GitHub 上,依赖于本地环境。不能像 WordPress 或 Typecho 那样的动态博客一样能直接在浏览器中完成撰文和发布。
综上,搭建一个博客应该不是很难,哈哈哈哈。
希望我的总结能给大家带来一些帮助http://localhost:4000