使用Hexo Stellar 主题搭建一个独立博客站点

提醒

这里是使用stellar创建个人站点系列视频的文字部分,可以方便的粘贴一些配置项。

准备工作

  1. 安装 git 环境 https://git-scm.com/download/win
  2. 安装 nodejs 环境 https://nodejs.org/en/ 记得去官网下载,下载这个是免费的
  3. 安装 hexo-cli 我们可以访问hexo 中文网按照提示安装 hexo-cli
bash
npm i -g hexo-cli

初始化项目

bash
hexo init stellar-blog && cd stellar-blog

初次运行前,我们需要下载对应的依赖

bash
npm i

依赖安装后,我们可以运行

bash
npm run server

或者

bash
hexo server

来启动 hexo 项目。运行成功后,我们可以看到一个网址,我们访问这个网址,如果出现了下面的这个页面,说明我们已经成功初始化了一个 hexo 博客。接下来我们就使用 hexo 提供的主题功能美化一下它吧。

主题配置

进入stellar 主题官网,按照它的提示进行如下步骤:

  1. 安装主题
bash
npm i hexo-theme-stellar
  1. 在 stellar-blog/_config.yml 文件中找到并修改:
yml
theme: stellar

完成后,我们重新启动一下服务npm run server来看一下,发现网站已经变的和官网的页面差不多了,接下来来和我一起配置一下网站的其他内容吧。

配置网站基本信息

在 stellar-blog/_config.yml 文件夹中找到对应的选项修改为您站点的内容

yml
title: 您的网站名称
avatar: 您的头像链接
favicon: 您的网站icon

# 多语言
language:
  - zh-CN

_config.yml 只是进行一些基础的配置,关于 stellar 主题的配置,我们需要在根目录下创建 _config.stellar.yml

_config.stellar.yml 文件配置

我们可以去 node_modules/hexo-theme-stellar/_config.yml 找到啊 stellar 项目的原始配置文件,复制到我们创建的_config.stellar.yml文件中。然后在此基础上进行改动

一般我们需要改动的只有sidebar部分和footer部分。

sidebar 部分我们需要配置网站的侧边栏

yml
sidebar:
  menu:
    post: '[btn.blog](/)'
    wiki: '[专栏](/wiki/)'
    notes: '[导航](/notes/)'
    more: '[关于](/about/)'

我们也可以在 sidebar 部分配置每个页面需要出现的小部件。自定义的小部件需要我们在 widgets.yml 文件中声明

当我们需要添加一个底部站点导航时,我们需要在footer部分添加sitemap

yml
footer:
  sitemap:
    博客:
      - '[近期](/)'
      - '[分类](/categories/)'
      - '[标签](/tags/)'
      - '[归档](/archives/)'
    专栏:
      - '[vscode基础配置](/wiki/vscode/index.html)'
      - '[typescript基础](/wiki/typescript/index.html)'
    更多:
      - '[友链](/)'
      - '[关于本站](/about/)'
      - '[文档站点](http://doc.whbbit.cn)'
      - '[GitHub](https://github.com/Whbbit1999)'

自定义小部件

widgets.yml文件中,我们可以定义一些小组件。官方定义的我们直接粘贴就行。这里我说一下自定义小组件

yml
ad:
  layout: markdown
  title: 可能是广告位吧🤨
  content: |
    [![sable-admin-ad.jpg](/assets/sable-admin-ad.jpg)](https://github.com/Whbbit1999/sable)

创建独立页面

在 widgets.yml 中创建对应的 widgets

yml
Notes:
  name: 笔记
  title: 笔记
  description: 一个隐藏项目:笔记
  index: false
  # sidebar: [toc]
  tags: 知识库
  sections:
    日常问题解决方案: [100, 199]
    移动端开发笔记: [200, 299]
    前端学习笔记: [300, 399]
    在线工具: [400, 499]

添加后,可以在_config.stellar.yml中添加对应的 sidebar

yml
sidebar:
  # ...
  menu:
    # ...
    notes: '[笔记](/notes/)'

创建对应的文件夹(文件夹名需要对应路径),这里需要创建对应的 notes 文件夹

如果你有 wiki 页面并且不想让它出现在 wiki 页面中时,可以在projects.yml中添加

yml
Notes:
  index: false

接下来你就可以在对应的目录下书写对应的内容了。

添加友链

需要注意将 actions 的权限更改为可以写入内容

使用 GitHub pages 托管静态网站

进阶部分——使用 hexo 注入功能实现自定义功能

代码块复制功能

实现代码块复制功能

目前该主题已支持通过配置实现代码复制功能

注入谷歌统计和百度统计

这些只是 stellar 主题的基础使用,更多进阶部分您可以访问 stellar 主题页面中的探索号进行查看

结语

结合官方文档,您应该可以很轻松的使用 stellar 主题来搭建一个你自己的站点了。不妨先去试试!!!

如果您遇到什么问题可以在本期视频下方或者文章下方评论,我们可以一起解决问题。

使用frp将本地mc服务器映射到公网
远程工作尝试