快速搭建一个自己的博客

准备

本地系统环境:Ubuntu 20.04.5 LTS

Node版本:18.15

Git版本:2.25.1

一个github账号

一台云服务器

一个备案好的域名

系统环境不同,根据自己的系统来操作就行,步骤差不多。

Node、Git的版本选择长期稳定支持的新版本就行。

云服务器和域名不是必须的,只是为了私有化更强。

相信看到这篇文章的大部分应该对这些东西都有基本的了解,准备性的东西就不罗嗦了。

安装Hexo:

全局安装Hexo,终端输入命令:sudo npm install hexo-cli -g

安装成功后终端输入hexo -v,看到版本号表示成功,本次版本hexo-cli: 4.3.0

配置仓库

在github中新建一个仓库,名称必须是用户名.github.io,这是用于托管博客,方便其他人访问博客。

为了以后的文件托管方便,可以通过ssh的方式连接,不需要每次手动输入密码,不会的自行解决。

初始化本地博客

在电脑中新建一个文件夹,名字随意(为了不出现莫名错误,不要有特殊符号或中文),这里取名为Blog。

在Blog目录下打开终端,输入hexo init初始化博客项目,没有异常将会生成如下重要文件夹或文件:

.
├── _config.yml // 博客配置文件
├── node_modules // 项目依赖包
├── scaffolds // 文章生成模板
├── source // 文章
├── themes // 主题

终端输入hexo g进行静态部署,终端输入hexo s启动服务器,在浏览器中输入localhost:4000访问,出现hexo的默认页面表示博客搭建成功。

到此,博客搭建成功,但还不能访问,需要部署到GitHub或自己的服务器上才能实现让他人访问。

将Hexo部署到GitHub

用编辑器打开Blog目录找到_config.yml 文件,找到deploy配置项,修改为如下内容:英文冒号,冒号后要加一个空格

deploy:
  type: 'git'
  repository: 'github仓库名'
  branch: main # 绑定的分支

光改配置还不够,需要安装git插件deploy-git,才能部署到github。

终端输入npm install hexo-deployer-git --save进行安装。

安装完成后,终端输入如下三条命令:

hexo clean #清除缓存文件和已经生成的静态文件
hexo g #生成网站静态文将到默认设置的public文件夹
hexo d #自动生成网站静态文件,并部署到指定仓库

hexo s # 本地部署

以上四个命令是经常用到的

至此,在浏览器中访问:https://xxxxx.gibhub.io就能访问博客了。

解析自定义域名

以腾讯云为例,进入域名控制台,进入域名解析页面,添加一条解析记录:

打开Blog/source目录,添加CNAME文件,在里面填上自己的域名,不需要带www。

在Blog目录中打开终端,hexo clean hexo g hexo d三条命令执行一遍,打开GitHub如果CNAME文件出现在项目中,点击Settings——> pages——>Custom Domain 输入解析的域名,不要带www,然后浏览器输入绑定的域名,能打开博客说明成功。

注意是在用户名.github.io的仓库中设置,不是主页设置

到此,自定义域名完成,可以通过自定义域名访问博客。

发布文章

发布文章可以使用两个命令新建.md的文件,命令可以二选一,但不支持手动新建:

hexo n "文章名"   # hexo new "文章名"

新建的文件默认在博客根目录的source/_posts中,默认会写入一些模板内容,修改模板在目录scaffolds/post中进行。

具体的设置看文档说明。

安装主题美化博客

Hexo主题很多,但使用方式都基本差不多,都是下载,然后应用。主题的配置涉及很多方面,具体的内容要翻主题文档。

这里以Butterfly为例:https://butterfly.js.org/posts/21cfbf15/#安裝

在博客根目录打开终端,输入git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly安装主题

也可以通过npm安装:npm install hexo-theme-butterfly

个人喜欢通过npm的方式安装

npm安装需要hexo5.0以上版本才支持,这种方式安装的主题在node_modules中,不在themes中。

升级方法:在主题目录下,运行 git pull

升级方法:在 根目录下,运行 npm update hexo-theme-butterfly

应用主题:修改根目录下的 _config.yml,把主题改为 butterfly

注意:该主题需要安装pug和stylus渲染器,安装命令:npm install hexo-renderer-pug hexo-renderer-stylus --save

为了方便升级,可以在根目录中创建文件_config.butterfly.yml,把主题目录中的_config.yml内容复制过去。

注意:是主题的yml不是根目录hexo的yml,仔细区分

所有有关butterfly的配置在新的_config.butterfly.yml中,它的优先级高于主题的优先级,并且会自动合并主题的不同配置。

改完后依次执行三件套部署本地,看是否配置成功,最终改好后再部署到服务器。

更具体的内容参考主题说明。

出处:千江游鲤的网站

个性签名:眼中有尘天下窄,心中无事一床宽

如果觉得这篇文章对你有小小的帮助的话,记得在右下角点个“推荐”哦,感谢!