博客搭建(一)建站

null-qwerty

简述

本博客使用 Hexo 博客框架,主题采用 radefine 搭建,最终发布到 github pages。

安装 Hexo

官方教程

Hexo 是一个基于 Node.js 的静态页面博客框架,安装 Hexo 前需要安装 Node.js 和 git 。笔者之前安装过这两个应用,在这里不详细介绍它们的安装过程。

安装完上述应用后,打开控制台,输入:

1
npm install -g hexo-cli

即可安装 Hexo 。

创建博客

在打算放置博客的路径下打开控制台,输入:

1
2
3
hexo init "your-blog-name"
cd your-blog-name
npm install

执行完成后,当前文件夹的文件结构如下:

1
2
3
4
5
6
7
8
.
├── _config.yml
├── package.json
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── themes

_config.yml

网站的配置文件。

package.json

网站所需要的程序包。

scaffolds

模板文件夹,新建文章时会根据该文件夹下的模板创建文件。

source

资源文件夹是存放用户资源的地方。除 _posts 文件夹之外,开头命名为 _ (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹,而其他文件会被拷贝过去。

theme

主题文件夹。

安装主题

新建的 Hexo 博客默认使用 landscape 主题。

这里 可以找到更多的 Hexo 主题,每个主题有不同的配置方法,请根据文档进行配置,此处不做赘述。

在博客根目录打开控制台,输入:

1
hexo server

结果如下:

1
2
3
INFO  Validating config
INFO Start processing
INFO Hexo is running at http://localhost:4000/ . Press Ctrl+C to stop.

此时用浏览器访问 http://localhost:4000/ 可预览网页。

申请github pages

官方教程

创建仓库

创建用户或组织站点,则存储库必须命名为 <user>.github.io<organization>.github.io ,全小写。

创建站点

新建站点入口文件。GitHub Pages 将查找 index.htmlindex.mdREADME.md 文件,作为站点的入口文件。

  1. 进入仓库,找到 “settings”,打开。
  2. 在边栏中找到 “pages”,打开。
  3. 选择分支,点击 “save”。

等待一段时间后点击上方 “visit site” 或通过网址访问网页。

对站点的更改在推送到 GitHub 后,最长可能需要 10 分钟才会发布。

Hexo 连接到 github pages

先安装 hexo-deployer-git 插件,在博客根目录下运行:

1
npm install hexo-deployer-git

_config.yml 文件中添加或修改下方内容:

1
2
3
4
5
6
# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
type: 'git'
repo: 'https://github.com/<user>/<user>.github.io.git'
branch: '<your-branch>'

打开控制台,输入:

1
2
3
hexo clean # 清空上次生成的文件,第一次运行可不运行
hexo generate # 生成上传到仓库的文件,保存在 public 文件夹下
hexo deploy # 上传到仓库,第一次运行需要绑定 github 账号
  • 标题: 博客搭建(一)建站
  • 作者: null-qwerty
  • 创建于 : 2023-10-05 13:02:03
  • 更新于 : 2024-02-07 17:01:25
  • 链接: https://www.null-qwerty.top/2023/10/05/博客搭建(一)建站/
  • 版权声明: 本文章采用 CC BY-NC-SA 4.0 进行许可。
评论