☰

博客搭建(四)如何使用和维护这个博客

2024-12-30 分类： 学习 标签： ，，

博客结构

这个博客使用 Hexo 搭建，采用了自定义主题，主要分为四个大板块：

  1. 学习：记录各种学习笔记和教程
  2. 生产：记录工具开发和效率提升相关内容
  3. 投资：记录投资相关的思考和策略
  4. 其他：记录生活感悟和随笔

每个板块下都有相应的子分类，方便内容的组织和管理。

写作新文章

创建文章

使用以下命令创建新文章：

hexo new "文章标题"

这会在 source/_posts 目录下创建一个新的 markdown 文件。

文章配置

每篇文章开头需要配置 Front-matter，包含以下信息：

---
title: 文章标题
date: 2024-01-01
categories:
  - learning  # 主分类：learning/production/investment/others
subcategory: blog-tutorial  # 子分类ID
tags:
  - 标签1
  - 标签2
---

子分类说明

目前支持的子分类如下：

学习板块

  • blog-tutorial：博客教程
  • cursor-tutorial：Cursor教程
  • python-tutorial：Python教程
  • frontend：前端开发

生产板块

  • tools：工具开发
  • automation：自动化
  • productivity：效率提升

投资板块

  • fund：基金投资
  • stock：股票投资
  • strategy：投资策略

其他板块

  • life：生活感悟
  • reading：阅读笔记
  • essay：随笔

Markdown 语法

文章支持标准的 Markdown 语法：

# 一级标题
## 二级标题
### 三级标题

- 无序列表项
1. 有序列表项

*斜体* 或 _斜体_
**粗体** 或 __粗体__
***粗斜体*** 或 ___粗斜体___

> 引用文本

[链接文本](链接地址)

![图片描述](图片地址)

\`行内代码\`

\`\`\`python
# 代码块
def hello():
    print("Hello, World!")
\`\`\`

置顶项目管理

置顶项目和待办事项配置在 source/_data/topics.yml 文件中，按照以下格式添加：

learning:  # 对应板块名称
  sticky:  # 置顶项目
    - name: "项目名称"
      description: "项目描述"
      status: "进行中"  # 可选：未开始/进行中/已完成
      priority: 1  # 优先级：1最高，数字越大优先级越低
      deadline: "2024-12-31"  # 可选：项目截止日期
      links:  # 可选：相关链接
        - name: "项目文档"
          url: "/2024/01/01/项目文档/"
        - name: "GitHub仓库"
          url: "https://github.com/username/repo"
  future:  # 未来计划/待办事项
    - name: "计划1"
      deadline: "2024-03-31"  # 可选：计划完成日期
      priority: 1  # 可选：优先级
    - name: "计划2"
      deadline: "2024-06-30"
      priority: 2

置顶项目维护建议

  1. 定期更新状态：

    • 每周检查一次置顶项目的状态
    • 更新项目进展和描述
    • 已完成的项目可以移除或标记为已完成

  2. 优先级管理：

    • 使用 priority 字段标记项目优先级
    • 定期评估和调整优先级
    • 建议每个板块最多保留3-5个置顶项目

  3. 链接维护：

    • 确保所有相关链接可访问
    • 及时更新过期或失效的链接
    • 添加新的相关文档链接

待办事项维护建议

  1. 分类管理：

    • 按照板块分类管理待办事项
    • 每个板块的待办事项建议不超过10个
    • 可以按季度或月份组织待办事项

  2. 定期更新：

    • 每月初审查待办事项清单
    • 移除已完成的项目
    • 添加新的计划项目
    • 调整项目优先级和截止日期

  3. 实施建议：

    • 将大型项目拆分为小任务
    • 设置合理的截止日期
    • 关联相关的参考资料或文档

示例配置

learning:
  sticky:
    - name: "博客系统开发"
      description: "使用Hexo开发个人博客系统，包含四大板块的内容管理"
      status: "进行中"
      priority: 1
      deadline: "2024-03-31"
      links:
        - name: "需求文档"
          url: "/2024/01/01/博客需求文档/"
        - name: "开发日志"
          url: "/2024/01/01/博客开发日志/"
    - name: "Python进阶学习"
      description: "学习Python高级特性和设计模式"
      status: "未开始"
      priority: 2
      deadline: "2024-06-30"
  future:
    - name: "学习Vue.js框架"
      deadline: "2024-04-30"
      priority: 1
    - name: "掌握Docker容器技术"
      deadline: "2024-05-31"
      priority: 2

production:
  sticky:
    - name: "自动化工具开发"
      description: "开发提高工作效率的自动化工具"
      status: "进行中"
      priority: 1
      links:
        - name: "项目仓库"
          url: "https://github.com/username/tools"
  future:
    - name: "开发命令行工具集"
      deadline: "2024-04-30"
    - name: "构建自动化测试框架"
      deadline: "2024-06-30"

注意事项

  1. 保持 YAML 格式正确，注意缩进
  2. 定期备份 topics.yml 文件
  3. 修改后记得运行 hexo clean && hexo generate 重新生成
  4. 建议在本地预览确认无误后再部署
  5. 可以使用 Git 管理配置文件的版本历史

本地预览

使用以下命令启动本地预览：

hexo clean  # 清理缓存
hexo generate  # 生成静态文件
hexo server  # 启动本地服务器

然后访问 http://localhost:4000 查看效果。

部署说明

部署到 GitHub Pages：

hexo clean  # 清理缓存
hexo generate  # 生成静态文件
hexo deploy  # 部署到 GitHub Pages

维护建议

  1. 合理使用分类和标签，保持内容的组织结构清晰
  2. 定期更新置顶项目和未来计划
  3. 保持文章质量，包含必要的代码示例和说明
  4. 定期备份源文件

常见问题

  1. 如果本地预览时显示异常，尝试清理缓存后重新生成
  2. 图片显示问题请参考《使用 GitHub + jsDelivr 搭建免费图床》
  3. 代码高亮支持多种编程语言，注意在代码块中指定正确的语言
  4. 子分类的修改需要同时更新 source/_data/categories.yml 文件

更新记录

  • 2024-01-01：创建文档
  • 2024-01-02：添加子分类使用说明
↑