luoweihua7 / vkit-blog

vKit 博客

个人博客，使用 Hexo 框架，及使用很干净漂亮的 ICARUS 主题皮肤。

使用

通过默认的布局 post 创建页面

npx hexo new "Page Title"

也可以指定布局创建页面，使用方法参考 Hexo写作文档 说明。

layout 布局参考 scaffolds 目录下的md文件。

# 根据布局创建文章，文件存储到 source 目录
npx hexo new page "Page Title"

# 根据布局创建文章，文件存储到 source/_posts 目录
npx hexo new post "Post Title"

# 创建草稿，文件存储到 source/_drafts 目录，generate时不会自动发布
npx hexo new draft "Draft Title"
# 草稿文章完成修改后，进行发布。默认以 post 布局发布，也可以指定布局。发布后会移动到对应布局的目录
npx hexo publish [layout] "Draft Title"

布局

通过布局创建后的Markdown文档，一般为如下内容

---
title: {{ title }}
date: {{ date }}
cover:
thumbnail:
tags:
  - Tag
categories:
  - Category
toc: true
---

在 `<!-- more -->` 之上的为导读部分内容，文章列表中会展示导读部分，并显示 `阅读更多` 按钮。

<!-- more -->

文章详情内容

说明

项	说明
title	文章标题，创建时会自动填充，无需修改
date	创建时间，创建时会自动填充，无需修改
cover	文章列表展示封面图，大小建议为 760*325 的尺寸图片
thumbnail	缩略图，用于
tags	文章标签，可以添加多个，该文章则在多个标签下都存在
categories	文章分类，会在分类列表页面中展示。 添加多个后，会形成层级树状结构
toc	是否在文章详情左侧展示文章目录结构，建议设置为 true

构建

npm install
npx hexo generate

更多请访问 Hexo指令 文档

Github Actions

通过使用 Github Actions 的自动化能力，通过 Tencent Cloud COS Action 实现自动化的部署到腾讯云存储桶。可以在腾讯云存储桶中开启静态网站功能实现静态网站的部署。

首先在 Settings > Secrets > Actions 页面中，点击 New repository secret 按钮，分别添加以下配置

Name	Value
TENCENT_CLOUD_SECRET_ID	填写腾讯云的 secretId
TENCENT_CLOUD_SECRET_KEY	填写腾讯云的 secretKey
TENCENT_CLOUD_COS_BUCKET	填写腾讯云的 COS 存储桶名称
TENCENT_CLOUD_COS_REGION	填写腾讯云的 COS 存储桶的地域