【Hexo博客搭建】将其部署到GitHub Pages(三):怎么写作以及更新?

简介: 本系列文章属于半笔记半教程的零基础小白入门文,教你将 Hexo 部署到 GitHub Pages 应该怎么做,跟着此系列文章最终可以获得自己的静态博客网站。流程很长,分成不同的篇幅,此为本系列的第三篇。

前言

      本系列文章属于半笔记半教程的零基础小白入门文,教你将 Hexo 部署到了 GitHub Pages,从而获得自己的静态博客网站。流程很长,分成不同的篇幅,此为本系列的第三篇。


【注意】:本文纯属才疏尚浅的我以笔记的形式进行的记录,很多知识其实我也不是太懂,可能存在理解偏差和错误,来学习的朋友们请自己甄别,路过的大神们也别喷我哈哈哈,有什么建议和问题可以评论提出或者其它方式联系我。我会尽可能保持更新该文章所使用到的技术和做法,并随时接受勘误。



步骤

十一、开始写作

在上一篇文章中提到,初始化hexo博客后我们获得了它自动为我们生成的博客页面,同时还给我们生成了一个标题为“Hello World”的帖子。那么我们以后如何写新帖子发布到我们的博客网站呢?


打开“命令提示符窗口”进行操作,即之前用到的cmd窗口。


Windows用户打开方式是按住Win+R,再输入cmd然后回车即可。


打开后我的电脑是显示如下的:

Microsoft Windows [版本 10.0.19042.1165]
(c) Microsoft Corporation。保留所有权利。
C:\Users\10272>

和第二篇文章第六步的操作相同,


由于窗口默认是在C盘操作,我们需要进入到本地电脑之前存储网站代码的“文件夹目录”,对于我来说,由于我存储网站代码的“Barry-Flynn.github.io”文件夹是放在 E盘 的 BarryFlynn\Github\ 文件夹里的,所以我需要先进入 E盘 ,然后回车,显示如下:

Microsoft Windows [版本 10.0.19042.1165]
(c) Microsoft Corporation。保留所有权利。
C:\Users\10272>e:
E:\>

再通过cd命令进入 BarryFlynn\Github\Barry-Flynn.github.io” 文件夹:


(这一步请根据你自己之前存放的地址,不要照抄我的哈)

Microsoft Windows [版本 10.0.19042.1165]
(c) Microsoft Corporation。保留所有权利。
C:\Users\10272>e:
E:\>cd barryflynn\github\barry-flynn.github.io
E:\BarryFlynn\Github\Barry-Flynn.github.io>

(题外话:我通过上面这行命令亲自实践发现,虽然我的文件夹的命名同时包含大小写,但我全输入小写也是可以进入的)


好了,现在可以开始通过命令开始第一次写作了。


1.创建新帖子

输入以下命令,并回车:


(注意双引号是英文输入法下的!双引号内文字即为你要新建的文章帖子的标题)

hexo new "我的第一篇博客文章"

(或缩写成:hexo n "我的第一篇博客文章")


回车后不一会儿,它提示我 Barry-Flynn.github.io\source\_posts\我的第一篇博客文章.md 文件已经建好了。你会发现该文件后缀名是“.md”,没错,hexo默认我们用Markdown 格式书写文章。


Hexo 支持以任何格式书写文章,只要安装了相应的渲染插件。


例如,Hexo 默认安装了 hexo-renderer-marked 和 hexo-renderer-ejs,因此你不仅可以用 Markdown 写作,你还可以用 EJS 写作。如果你安装了 hexo-renderer-pug,你甚至可以用 Pug 模板语言书写文章。


只需要将文章的扩展名从 md 改成 ejs,Hexo 就会使用 hexo-renderer-ejs 渲染这个文件,其他格式同理。


现在,我之前让大家下载的VSCode编辑器这时候就派上用场了,当然,如果你对Markdown非常熟悉也有自己用的顺手的编辑器的话,当然可以根据你自己的习惯使用别的编辑器进行写作,但本文章仅使用VSCode进行演示。


2.编写文章内容

双击打开VSCode,


点击左上角“文件”,点击“选择文件”,


找到刚刚新建的“我的第一篇博客文章.md ” 并打开,


现在可以开始你的创作之旅了。


如果不会用Markdown语法书写文章的话可以在其他地方学习一下,

或进入官网进行学习:

Markdown 中文文档 https://markdown-zh.readthedocs.io/en/latest/


这里插个话:理论上,vscode 在没有安装任何插件的情况下是可以直接编写markdown文档的,书写过程中点击vscode右上角的其中一个小按钮可以在右侧实时预览效果。

我的第一篇博客vscode截图.png


但是为了能够得到一些更加丰富的功能和有好多体验,可以通过增添新的插件对其功能进行完善。


比如 Markdown Preview Enhanced 就是一个很好用的完善预览功能的插件,可以更加形象的展示所编写的pdf格式的文档样式。在插件库中搜索markdown即可找到该插件,然后点击安装后重新加载。下面是 Markdown Preview Enhanced 的官方网站:


https://shd101wyy.github.io/markdown-preview-enhanced/#/


写完后Ctrl+S保存你的文章(或点击vscode左上角“文件”,然后“保存”),关闭vscode。


十二、更新main分支

1.清除缓存(可跳过)

hexo clean

此命令用于清除缓存文件 (db.json) 和已生成的静态文件 (public)。


在某些情况(尤其是更换主题后),如果发现你对站点的更改无论如何也不生效,可能需要运行该命令。如果进行了多次生成,为了避免受错误缓存影响,最好使用 hexo clean 先清除一遍。也就是说,网站显示异常时可以执行这条命令试试。


2.生成静态文件

输入以下命令,并回车:

hexo generate

(或缩写成:hexo g )


此命令使刚刚完成写作的文章生成网站静态文件到默认设置的 public 文件夹。


3.启动本地服务器(可跳过)

此步骤用于发布前的本地预览

hexo server

(或缩写成:hexo s )


默认情况下,访问网址为: http://localhost:4000/


浏览器输入该网址就能看本地生成的博客了,但也仅仅在本地,GitHub上没有。


在cmd窗口按  Ctrl+C  中断服务器的运行,


系统提示  终止批处理操作吗(Y/N)?  输入 Y 然后回车。


4.一键部署

输入以下命令,并回车:

hexo deploy

(或缩写成:hexo d )


此命令使刚刚完成写作的文章自动生成网站静态文件,并部署到设定的仓库。


Hexo 提供了快速方便的一键部署功能,只需一条命令就能将网站部署到服务器上。在开始之前,必须先在 _config.yml 中修改参数,一个正确的部署配置中至少要有 type 参数。在我这个系列文章的第二篇第九步,我已经带大家修改过了,跟我一路走下来的朋友们不用管了,还没设置过 _config.yml 参数的新来的朋友麻烦去看一下本系列我的上篇文章哈。


只需等待一会,就可以打开你的博客地址看到新文章发布成功啦,


比如我的博客地址为:https://barry-flynn.github.io


我的第一篇博文发布成功.png


可以看到我刚刚写的文章已经生成并正常显示了。


这一切是如何发生的?


当执行 hexo deploy 时,Hexo 会将 public 目录中的文件和目录推送至 _config.yml 中指定的远端仓库和分支中,并且完全覆盖该分支下的已有内容。


十三、更新备份hexo分支

根据我上一篇文章中对 _config.yml 文件参数的修改,上边这个部署的命令默认是对我GitHub上的主分支(也可以叫main或者master分支)进行部署更新,上篇文章说过了,我同时管理了两个分支,分别存放不同内容:


main -负责展示静态网页

hexo -备份本地hexo文件


分别运行下面三行命令,进行hexo分支更新(后面括号内为注释,无需输入)

git add -A (此命令用来添加所有文件到暂存区)
git commit -m "新增博客文章"  (此命令用来提交,双引号内可自定义内容,双引号前有空格)
git push origin hexo (此命令用来推送hexo分支到Github)

第一行命令其实有三种写法:(注意第三种写法后面有个点)


git add -A  

提交所有变化(就是git add --all的缩写)


git add -u  

提交被修改 (modified) 和被删除 (deleted) 的文件,不包括新文件 (new)


git add .  

提交新文件 (new) 和被修改 (modified) 文件,不包括被删除 (deleted) 文件


git add . :他会监控工作区的状态树,使用它会把工作时的所有变化提交到暂存区,包括文件内容修改(modified)以及新文件(new),但不包括被删除的文件。


git add -u :他仅监控已经被add的文件(即tracked file),他会将被修改的文件提交到暂存区。add -u 不会提交新文件(untracked file)。(git add --update的缩写)


git add -A :是上面两个功能的合集(git add --all的缩写)

————————————————

此注释摘自:https://blog.csdn.net/caseywei/article/details/90945295


第二行的“-m”应该是“message”的缩写,双引号内是自定义提交信息


在上一篇文章中我们对 _config.yml  的message参数设置的就是这个,你可以自定义此次部署更新的说明,比如:“x年x月x日的备份”、“第x次备份”等等都可以


关于第二行命令提交时的自定义信息,具体的用处看下图,其实相当于是个注释

message自定义信息在GitHub的显示方式.png


三步全部执行完后打开GitHub相应库的hexo分支里就可以看到跟刚才不一样的地方了

提交自定义信息后的GitHub.png


意味着hexo源文件更新成功,推送到了 GitHub 仓库进行了备份。



总结

每次更新博客时都可以走以下三个大步


一、写作部分

1、打开cmd进入存放博客代码文件夹

2、创建文章:

hexo n "文章标题"

3、使用vscode打开新建的.md文件编写内容

二、对main分支进行部署更新:

hexo clean (清理缓存,可选用)
hexo g (生成资源文件)
hexo d (部署到服务器)

三、对hexo分支进行部署更新:

git add -A (添加所有文件到暂存区)
git commit -m "自定义信息" (提交此次更新的信息)
git push origin hexo (推送hexo分支到Github)

四、打开你的博客网址查看显示效果



好了,这就是本篇文章:


【Hexo博客搭建】将其部署到 GitHub Pages(三):怎么写作以及更新?


的全部内容了,更多内容会很快写出来,尽情期待。

相关文章
|
21天前
|
JSON 缓存 JavaScript
使用 jsDelivr 免费加速 GitHub Pages 博客的静态资源(二)
使用 jsDelivr 加速 GitHub Pages 的图片资源和动态编译的 JSON 资源。
21 2
|
2月前
|
网络协议 开发工具 git
hexo github部署,通过域名访问你的博客
本文介绍了如何使用Hexo命令部署博客到GitHub,并详细说明了如何通过自定义域名访问GitHub上部署的博客。
hexo github部署,通过域名访问你的博客
|
1月前
为什么 GitHub Pages 的文章标题不能以 @ 开头?
本文记录了一个 GitHub Pages 博客网页上文章标题以 `@` 开头导致的问题,并分析了原因,提供了解决方法。
41 0
|
3月前
GitHub——使用GitHub Pages生成在线文档
GitHub——使用GitHub Pages生成在线文档
23 0
|
5月前
|
Web App开发 缓存 移动开发
四万字符数带你使用 Vitepress 构建博客并部署到 github 平台
四万字符数带你使用 Vitepress 构建博客并部署到 github 平台 最近写了好多篇 Chrome 浏览器插件相关的文章,有十几二十篇,就想着构建个博客,用来放置相应的文章。 正好前段时间看到 VitePress 1.0.0 发布了,而且是用 markdown 写文章,正好写插件文章的时候文章都是 md 格式,所有用下这个然后顺便写一篇使用教程。 Chrome 插件开发博客地址:https://18055975947.github.io/extension/
70 0
|
5月前
|
JavaScript 应用服务中间件 程序员
技术人如何利用 github+Jekyll ,搭建一个独立免费的技术博客
技术人如何利用 github+Jekyll ,搭建一个独立免费的技术博客
|
6月前
|
JavaScript 网络安全 开发工具
[保姆级-从0到1]利用hexo+github托管实现搭建个人博客
[保姆级-从0到1]利用hexo+github托管实现搭建个人博客
|
5月前
VitePress 构建的博客如何部署到 github 平台?
VitePress 构建的博客如何部署到 github 平台?
88 0
|
6月前
使用github制作个人网站或者博客
使用github制作个人网站或者博客
50 0
|
1月前
|
编解码 Oracle Java
java9到java17的新特性学习--github新项目
本文宣布了一个名为"JavaLearnNote"的新GitHub项目,该项目旨在帮助Java开发者深入理解和掌握从Java 9到Java 17的每个版本的关键新特性,并通过实战演示、社区支持和持续更新来促进学习。
76 3