Hexo博客搭建 安装启动与编辑部署--Mac端


1.安装node.js

Hexo框架需要node生成 node.js官网

终端输入指令 sudo su 输入电脑密码,进入root用户

查看node版本:node -v 验证是否安装成功,显示版本号则安装成功

安装node后会自动安装好npm包管理器,npm -v 查看npm版本

2.设置淘宝镜像源cnpm

Hexo需要借助npm包管理器来安装,国内使用npm镜像源速度很慢,需要设置淘宝镜像源cnpm,终端输入

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

完成后输入 cnpm -v 查看版本,验证是否安装成功

如果报错需要在命令前加 sudo 赋予权限

3.使用cnpm安装Hexo博客框架

cnpm install -g hexo-cli

hexo -v 查看版本,验证是否安装成功

4.本地创建博客文件夹并初始化

所有hexo博客文件将在这里创建,如果初始化过程中出现错误的话将文件夹干掉重来即可(重要文件备份,不要误伤)

终端cd 进入文件夹根目录,初始化博客文件

sudo hexo init
   Win10不需要加sudo,但要以管理员身份进入,下完git后,打开git里的cmd,新建文件夹后继续hexo init

   sudo 是linux/mac 中获得管理员权限的命令   windows里不需要加上sudo命令

初始化完成后会在文件夹内生成一些文件,之后博客设置及更新全部基于这些文件进行,终端ls -l查看,或者直接打开文件夹

5.启动hexo

终端 hexo s (s即serve)启动,注意需要在博客文件夹根目录下执行

会在本地的localhost:4000端口启动预览,浏览器输入localhost:4000就可以访问

4000端口一般做测试用,写好的博客可以先在本地4000预览,然后再部署到服务器上

打开后可以看到已经自动生成了第一篇博客”hello world“,标注了一些简单的hexo操作指令及文档链接

博文以Markdown格式保存在博客文件夹中,如果想新建博文,可以使用文档中提供的指令创建和编辑,也可以用支持Markdown格式的编辑器写好后放进文件夹中

此文件夹中的所有操作都需要电脑管理员权限

博文文件位置:/blog/source/_posts/

Ctrl+C 关闭4000端口

6.部署到GitHub

github上新建一个仓库(new repository)

用户部署个人博客的github仓库的命名必须符合要求,之后在浏览器中访问的就是这个地址

你的github用户名.github.io

备注仓库信息,设置公开/私有,Create repository

在博客文件夹下安装部署插件,终端

cnpm install --save  hexo-deployer-git

打开博客文件夹下_config.yml文件,拉到最下方deploy:位置,添加字段

deploy:
 type: git
 repo: https://github.com/用户名/用户名.github.io.git
       (刚刚在github中创建的仓库地址)
 branch: main

终端输入 hexo d 开始部署,期间需要输入github账号名和令牌密码personal access token

2021年8月之后不能用密码登陆,需要在GitHub的setting-Developer setting-Personal access token中设置personal access token作为密码登陆
令牌建议妥善保存,后续更新博客都需要令牌作为密码,令牌有时效限制,需要定期更新,如果忘记了可以重新生成,但任何使用此令牌的脚本或应用程序都需要更新

向远端推送完成后可以看到github仓库里多了一些文件,这些就是博客生成的内容,之后就可以通过github仓库访问博客了

访问地址 用户名.github.io

7.更新博客内容

清理,重新生成,部署到github

hexo clean
hexo g
hexo d

部署期间需要输入用户名和令牌密码

注意令牌的时效,定期更换

完成

8.更换博客主题

如果不喜欢Hexo默认的主题界面,可以自己更换

这里以主题yilia为示例 github下载地址

终端 cd 到博客文件夹根目录

git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia

会将主题文件clone到根目录下themes文件夹中

修改根目录下的 _config.yml文件中theme:字段

默认主题 theme: landscape 修改为 theme: yilia

清理,重新生成,部署到github

hexo clean
hexo g
hexo d

部署期间需要输入用户名和令牌密码
完成

主题配置文件在主目录下的_config.yml,github下载地址中有详细的配置介绍,根据自己需要修改使用

如果有其他喜欢的主题,也可以自行更换,失败没关系,多尝试折腾下

本文整理内容来自B站UP:CodeSheep

上一篇:基于Django实现 RESTful API 之RestFramework框架1


下一篇:hexo,butterfly添加系列文章功能(二级目录)