0%

博客搭建与发布教程

记录一下博客搭建的整个历程,包括日后新增一些实现的功能

博客搭建

主要参考:Hexo+GitHub搭建个人博客教程(2023最新版)_hexo github个人网站教程-CSDN博客

这篇CSDN的搭建教程,感谢博主,以下教程纯属自用,一些图片也是摘自此博主的

搭建思路:

1.利用Hexo 一款快速、简洁且高效的博客框架,允许用户使用Markdown语言编写内容,并渲染成静态网页,其相当于一个网站的主题模块;

2.利用GithubPages:Github Pages 是 Github 官方提供的一个静态站点托管服务,它允许用户将 GitHub 仓库中的代码转换为可访问的网站。借助 Github Pages,我们不需要购买服务器也能部署我们的网站。

这两款工具进行博客的整体搭建

1.1 安装本地环境

1.node.js环境:

安装 nodejs, 因为Hexo是基于 Node.js 驱动的一款博客框架:下载地址

2.git环境:

Git 是一种分布式版本控制系统,即,代码的本地克隆就是一个完整的版本控制存储库,利用git可以进行版本控制,内容管理

git工作流程

Git 各平台安装包下载地址为:http://git-scm.com/downloads,一路next;

安装完毕后的检查——打开cmd命令

查看node.js版本:node -v

查看git版本:git --version

在开始菜单里找到"Git"->"Git Bash",会弹出 Git 命令窗口,你可以在该窗口进行 Git 操作;或在桌面或文件夹任意位置右键,列表中会出现:Open Git GUI here 和 Open Git Bash here

接下来创建一个文件夹,是存放你的博客的目录,如D->blog文件夹(后续我们称为博客根目录),在当前文件夹中,右键,点击Open Git Bash here,在弹出的Git命令窗口进行如下操作

3.安装hexo:

首先为了防止网络问题(国外服务器),先安装配置镜像:

1
npm install -g cnpm --registry=https://registry.npm.taobao.org

然后安装hexo和初始化

1
2
cnpm install -g hexo-cli
hexo init

初始化成功后文件夹会出现许多文件:

  1. **__config.yml**:这是 Hexo 的配置文件,你可以在这里设置博客的各种配置选项,比如标题、描述、主题等。
  2. node_modules:这个文件夹包含了博客依赖的所有 Node.js 模块,例如 Hexo 自身和其他插件。
  3. scaffolds:在这个文件夹中,你可以放置一些模板文件,用于创建新文章或页面时的默认结构。
  4. source:这个文件夹包含了你的博客的源文件,比如文章、页面、静态资源等。
  5. themes:在这里存放着博客的主题文件,你可以根据需要选择或自定义主题。
  6. db.json:这是 Hexo 的数据库文件,用于存储一些数据,比如文章列表、标签等。
  7. package.json 和 package-lock.json:这两个文件是 Node.js 项目的配置文件,包含了项目的依赖信息和版本信息。
  8. public:这个文件夹包含了生成的静态网页文件,当你执行 hexo generate 命令后,生成的 HTML 文件就会保存在这里

hexo init以后,现在已经有一个默认的本地博客了,可以先预览看看,还会默认克隆一个 Landscape 主题,这个默认的博客样式主题就是Landscape

1
hexo server(hexo s)

命令行在运行,别关闭,然后打开浏览器,地址栏输入:localhost:4000

即可看到第一篇默认的博客Hello World

1.2 Github环境

注册Github账号并创建仓库,GitHub官网

Github创建博客仓库
Github创建博客仓库

注意选择public 注意仓库的取名格式:用户名.github.io(这将是以后的访问域名)

next以后会出现可选https和ssh,选择ssh

1.3 本地GitPage绑定

我们首先设置ssh连接,SSH key 和 GitHub 绑定有以下几个好处:

使用 SSH,即安全外壳协议,可以加密通信内容,提高了数据传输的安全性。通过 SSH key 鉴权,可以避免传统密码登录方式可能存在的风险,增强账户的安全性,一旦将 SSH key 添加到 GitHub 上,就无需每次使用 Git 操作时都输入用户名和密码,减少了输入密码的繁琐过程,提高了工作效率,而且可以设置github上的SSH key的有效时间,不用频繁更改加密连接;

首先在git Bash下 输入命令:

1
2
cd ~/.ssh           //进入.ssh文件
ssh-keygen -t rsa -C ‘注册时的邮箱地址(你的github邮箱地址)’

接着去查看C盘目录(此文件夹所在C:),然后在记事本中打开id_rsa.put文件并复制生成的key(或者使用everything时间搜索id_rsa.put),这个时候生成了一个密钥

将密钥配置到Github中:

在GitHub主页的头像下找到seething -> 然后点击SSH and GPG keys,点击New SSH key

将刚刚在.ssh目录下所复制的id_rsa.put文件中的信息复制进key(注意空格)(名字随意)

接下来进行验证:

在git中输入命令进行ssh验证:

1
ssh -T git@github.com 并且输入yes之后,行末尾会显示你的用户名

会受到邮件提醒,成功绑定~

然后输入命令进行本地绑定与Github的用户名和邮箱(git):

1
2
git config --global user.name “注册时用户名”
git config --global user.email “注册时邮箱”

这样便连接完毕本地和Github了

1.4 博客访问域名

找到直接创建博客文件夹中的 _config.yml

把文章末尾改成:

1
2
3
4
5
6
deploy:
type: git
repo: https://github.com/用户名/用户名.github.io.git

(或者git@github.com:用户名/用户名.github.io.git)【推荐,我是用这个成功了,第一个未成功】
branch: main(一定是main不能是master!!!)

注意,上面的type repo和branch后面都有一个英文空格,输入以后保存文件,退出,博客便绑定成功

博客日常运行

我们刚才安装hexo时的的npm(Node Package Manager)和cnpm(淘宝镜像)都是 Node.js 的包管理工具,用于在 Node.js 项目中安装、升级、删除和管理依赖包,可以理解成应用商店,直接从此下载,类似conda pip等命令

2.1 博客基本发布

hexo中带有很多的模块工具包以供我们使用,注意,此时你的hexo只是安装在了你的博客地址目录下,而不是全局目录,所以你想要查看现在有哪些包,即打开博客文件夹下的:node_modules:这个文件夹包含了博客依赖的所有 Node.js 模块,例如 Hexo 自身和其他插件。

我们为了上传本地博客到网页端,需要安装一个工具

1
cnpm install hexo-deployer-git

上传流程

在博客的文件夹的git bash中依次输入:

1
2
3
4
5
6
hexo clean           //清除 Hexo 生成的缓存文件和静态文件
hexo new "文章名称" //新建文章
// 新建文章后,在 source->_posts文件夹中可以看到.md文件,进行编辑文件
hexo s //文章预览,s是source的意思
hexo g //generate的意思,生成文件
hexo d //部署到github上

之后每次上传博客都是此顺序,部署之后可发现GitHub中多了文件,此时浏览器输入,用户名.github.io(Github仓库名)就可以访问博客啦

1
2
3
4
5
这是全角空格:Em Space: (别忘了分号)   半角空格

这是空行 ASCII码: 

这是换行 HTML:<br>

A空格了吗?  B

C 空行了吗?

 

D换行了吗?

2.2 博客的进阶操作

说是进阶操作,其实就是为了让文章部署在网页时,可以满足一些在markdown中可以实现的基本需求,我的需求仅仅有四项:

换个自己喜欢的主题,图片的上传管理、数学公式的编辑和每篇文章有个目录 or 标签,便于文件夹管理访问

1.主题更换

当前博客的主题是next哦~:hexo-theme-next应该是目前最广泛使用的hexo主题了,优点是简洁,定制度高,因为代码是开源的,所以有很多开发者维护。由于前任管理员不提供权限,故开发了一个新的分支,详情。

打开你的博客文件夹的themes子文件夹,可以看到有哪些主题,默认应该就有一个landscape,是我们当时初始化hexo init下载的

在网站:https://hexo.io/themes/中可以找到很多主题

这里以 hexo-theme-next 这个主题为例做一下说明,打开你的博客根目录文件夹,在git bash中输入:

1
2
3
git clone --branch v7.8.0 https://github.com/theme-next/hexo-theme-next themes/next

git clone --branch v7.8.0 git@github.com:theme-next/hexo-theme-next.git themes/next

版本是自己选择的,下载以后会发展博客根目录文件下的 themes文件夹多了一个next文件夹,即我们下载的主题

然后在博客根目录文件夹的站点配置文件_config.yml(之前1.4节配置绑定github时用过), 找到 theme 字段,并将其后面的值更改为 next即可

1
hexo s //进入localhost:4000看看主题效果

需要修改此主题的一些内容细节:如增加评论,添加搜索,修改样式,增加广告等等等,可以参考修改next主题博客,如:

hexo | 鹏叔的技术博客 (pengtech.net)

2.图片的上传管理

我尝试了很多方法,最后选择了图床的方式,即把图片上传到github上管理,而不是本地管理图片,网页在需要图片时从github页面获取即可

参考:搭建一个免费图床!彻底解决博客文章中图片存储问题! - 知乎 (zhihu.com)

图床:图床(Image Hosting Service)是指提供在线图片存储和管理服务的网络平台。用户可以将图片上传到图床服务器,然后通过生成的图片链接来分享图片或在网页上显示这些图片。

A.安装配置PicGo:

PicGo 是一个用于快速上传图片并获取图片URL链接的工具,选择合适的版本并下载,可访问PicGo的官方文档进一步了解其功能和用法。我使用的是 win10系统,下载的是最新的版本。下载可能会很慢,可借助迅雷进行下载。下载后双击进行安装,注意不要安装在C盘。

Github创建图床仓库

下载地址:https://github.com/Molunerfinn/PicGo/releases

使用指南:https://picgo.github.io/PicGo-D

可以在PicGo设置中先设置一下自己的喜好,现在看不懂没关系,下面配完以后实际上传了一个图片就明白了(注:图床的功能很强大,这里我们只是用了很小的一部分,用来上传到自己的个人博客中)

PicGo 支持的图床很多,如七牛图床、腾讯云 COS、阿里云 OSS、Github 图床、Gitee 图床等等,我们当然用免费的Github或者Gitee啦

B.Github新建一个仓库专门存放图片文件,即图床仓库:

新建Github仓库并生成Token:

  • 注册 Github 用户

  • 在 Github 上新建一个用于存储的仓库,点击 New repository 创建一个新仓库。

  • 生成一个 Personal access tokens

在 Github 中依次点击Settings->Developer settings->Personal access tokens->Generate new token,勾选 repo 权限,填写描述,然后点击 Generate token 按钮,生成 token。由于生成的 token 只会在第一次显示,建议保存下来备用,否则后续只能重新生成 token。(一定要保存下来备用!!!)

C.打开PicGO配置Github图床

点击图床设置->Github图床:

  • 设定仓库名:按照照“用户名/仓库名”的格式填写,比如我的ning565/picblog(终究首反应还是没能驼峰命名)
  • 设定分支名:默认主分支 main 即可。
  • 设定 Token:将之前生成的 token 复制粘贴到这里。
  • 指定存储路径:github的那个图床仓库目录下的子目录,默认是根目录。
  • 设定自定义域名:自定义域名的作用是在上传图片后成功后,PicGo 将以“自定义域名+子目录名+图片名”生成访问连接。这里我们的自定义域名为:https://cdn.jsdelivr.net/gh/用户名/仓库名,用的是http://cdn.jsdelivr.net提升图片的加载速度。

D.Typora配置PicGo

我们每次写博客都是利用Typora软件,然后在其中插入图片等等,我们需要实现在Typora中插入的任一图片都直接通过PicGo软件上传到Github的图床仓库中,这样在hexo d上传博客时才能从图床仓库取图片

依次点击Typora的文件 -> 偏好设置 -> 图像

插入图片时选择上传图片

上传服务设定中,上传服务选择PicGo,路径选择PicGo.exe所在路径,然后进行验证上传,等待一段时间,windows系统电脑右下角出现弹窗上传成功,即代表着成功上传,此时图片便成功部署了,每次直接在typora中放的图片都能直接显示在网页中

3.数学公式编辑

参考:这次彻底解决在Hexo中渲染MathJax数学公式出现的问题!!!_uninstall hexo-renderer-marked失败-CSDN博客

Hexo渲染数学公式:配置方法与原理浅释 | 明 (pku-zyf.github.io)

用Github Pages+Hexo搭建博客之(十)Hexo博客next主题MathJax数学公式渲染问题_github 个人博客数学公式-CSDN博客

在Markdown文档编写中,我们可以使用LATEX的语法输入数学公式。常见的Markdown编辑器如Typora都可以方便地渲染数学公式。然而,Hexo在默认设置下部署博客时,并不能渲染数学公式。

原因在于,渲染数学公式需要使用MathJax(一种模块化的JavaScript框架);而Hexo的默认渲染器是hexo-renderer-marked(在目录根目录下的modules看到)引擎,它并不支持MathJax。

更换一个渲染引擎即可:

1
2
npm uninstall hexo-renderer-marked --save
npm install hexo-renderer-kramed --save

然后在主题next目录配置文件中_config.yml:

修改perpage为true mathjax后面的enable为true

1
2
3
4
5
6
7
8
9
10
# Math Formulas Render Support
math:
# Default (true) will load mathjax / katex script on demand.
# That is it only render those page which has `mathjax: true` in Front-matter.
# If you set it to false, it will load mathjax / katex srcipt EVERY PAGE.
per_page: true

# hexo-renderer-pandoc (or hexo-renderer-kramed) required for full MathJax support.
mathjax:
enable: true

切记:我最初在操作的时候,各种急着下载模块,不仅用了mathjax还用了很多modules,下载的很乱,一定先认准一个方法配置,如果配不好,先卸载了刚才下载的module,再重新找方法找module下载,某些module不能在一起共存的,欲速则不达

4.为文章设置目录/标签

在博客文件夹根目录下打开Git bash,然后执行

1
hexo new page categories

此时,在source 目录中会生成一个 categories 文件夹,文件夹内有一个 index.md 文件,打开此文件,将其中的 type 字段的值修改为 categories

1
2
3
......
type: "categories"
......

创建标签的方式一样:

1
2
3
4
5
hexo new page tags
//在tag文件夹中的index.md中
...
type: "tags"
...

为每篇文章设置:

1
hexo new "文章名称"

以后,在文章开头部分会自动添加如下内容:

1
2
3
4
5
title: 博客搭建与发布教程
date: 2024-03-15 12:10:21
tags:
categories:
- 入门使用

像我这样,在categories或者tages的下一行 输入:

1
- "目录/标签名称"   //注意减号后面的空格哦~

Contining~~~

如果以后有用到其他的博客内容再更新嗷~