这里是使用stellar创建个人站点系列视频的文字部分,可以方便的粘贴一些配置项。
准备工作
- 安装 git 环境
https://git-scm.com/download/win
- 安装 nodejs 环境
https://nodejs.org/en/
记得去官网下载,下载这个是免费的 - 安装 hexo-cli 我们可以访问hexo 中文网按照提示安装 hexo-cli
npm i -g hexo-cli
初始化项目
hexo init stellar-blog && cd stellar-blog
初次运行前,我们需要下载对应的依赖
npm i
依赖安装后,我们可以运行
npm run server
或者
hexo server
来启动 hexo 项目。运行成功后,我们可以看到一个网址,我们访问这个网址,如果出现了下面的这个页面,说明我们已经成功初始化了一个 hexo 博客。接下来我们就使用 hexo 提供的主题功能美化一下它吧。
主题配置
进入stellar 主题官网,按照它的提示进行如下步骤:
- 安装主题
npm i hexo-theme-stellar
- 在 stellar-blog/_config.yml 文件中找到并修改:
theme: stellar
完成后,我们重新启动一下服务npm run server
来看一下,发现网站已经变的和官网的页面差不多了,接下来来和我一起配置一下网站的其他内容吧。
配置网站基本信息
在 stellar-blog/_config.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 部分我们需要配置网站的侧边栏
sidebar: menu: post: '[btn.blog](/)' wiki: '[专栏](/wiki/)' notes: '[导航](/notes/)' more: '[关于](/about/)'
我们也可以在 sidebar 部分配置每个页面需要出现的小部件。自定义的小部件需要我们在 widgets.yml
文件中声明
sidebar: widgets: # ### 自动生成的页面 #### # 主页 home: search, welcome, recent, ad, tagcloud, timeline # for home # 博客索引页 blog_index: search_blog, recent, ad, timeline # for categories/tags/archives # 文档索引页 wiki_index: search_docs, recent, ad, timeline # for wiki # 其它(404) others: search, welcome, recent, timeline # for 404 and ... # ### 手动创建的页面 #### # 文章内页 post: toc, ghrepo, search, ghissues, ad # for pages using 'layout:post' # 文档内页 wiki: search, ghrepo, toc, ad, ghissues, related # for pages using 'layout:wiki' # 其它 layout:page 的页面 page: welcome, toc, ad # for custom pages using 'layout:page'
当我们需要添加一个底部站点导航时,我们需要在footer
部分添加sitemap
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
文件中,我们可以定义一些小组件。官方定义的我们直接粘贴就行。这里我说一下自定义小组件
ad: layout: markdown title: 可能是广告位吧🤨 content: | [](https://github.com/Whbbit1999/sable)
创建独立页面
在 widgets.yml 中创建对应的 widgets
Notes: name: 笔记 title: 笔记 description: 一个隐藏项目:笔记 index: false # sidebar: [toc] tags: 知识库 sections: 日常问题解决方案: [100, 199] 移动端开发笔记: [200, 299] 前端学习笔记: [300, 399] 在线工具: [400, 499]
添加后,可以在_config.stellar.yml
中添加对应的 sidebar
sidebar: # ... menu: # ... notes: '[笔记](/notes/)'
创建对应的文件夹(文件夹名需要对应路径),这里需要创建对应的 notes 文件夹
如果你有 wiki 页面并且不想让它出现在 wiki 页面中时,可以在projects.yml
中添加
Notes: index: false
接下来你就可以在对应的目录下书写对应的内容了。
添加友链
使用 GitHub pages 托管静态网站
进阶部分——使用 hexo 注入功能实现自定义功能
代码块复制功能
目前该主题已支持通过配置实现代码复制功能
注入谷歌统计和百度统计
"use strict" // 百度统计和google 统计 hexo.extend.injector.register("body_end", function () { return `<script> var _hmt = _hmt || []; (function() { var hm = document.createElement("script"); hm.src = "https://hm.baidu.com/hm.js?31181a38d70c8faf2c5bed0d93cab07b"; var s = document.getElementsByTagName("script")[0]; s.parentNode.insertBefore(hm, s); })(); </script> <script async="async" src="https://www.googletagmanager.com/gtag/js?id=G-FTR5YKFFCM"></script> <script> window.dataLayer = window.dataLayer || []; function gtag(){dataLayer.push(arguments)}; gtag('js', new Date()); gtag('config', 'G-FTR5YKFFCM'); </script> ` })
这些只是 stellar 主题的基础使用,更多进阶部分您可以访问 stellar 主题页面中的探索号进行查看
结语
结合官方文档,您应该可以很轻松的使用 stellar 主题来搭建一个你自己的站点了。不妨先去试试!!!
如果您遇到什么问题可以在本期视频下方或者文章下方评论,我们可以一起解决问题。