添加Mkdocs博客

💾 AI智能摘要 (智谱清言)

Mkdocs博客插件易于配置，通过添加特定行至mkdocs.yml文件，并配置作者信息，即可快速搭建个人博客。

📖 阅读信息

阅读时间：1 分钟 | 中文字符：114 | 有效代码行数：19

博客效果展示：博客

官方文档：Built-in blog plugin

与所有内置插件一样，博客插件的入门非常简单。只需将以下行添加到mkdocs.yml

1
2
plugins:
  - blog

然后在/docs/blog/posts下写md文件即可（无需再mkdocs.yml配置，如没有post文件，新建一个即可） 但是bolg文件夹下要有index.md文件(没有这个文件新建即可)！

在mkdocs.yml的nav部分这样写 

1
2
3
nav:
  - 博客:
      - index: blog/index.md

元标签参考： 

1
2
3
4
5
6
7
8
---
title: 
authors: [Wcowin]  #作者
date: 2023-10-04   #时间
draft: true   # 是否为草稿
categories:  #分类
  - Hello
---

作者信息在docs/blog/.authors.yml里配置（没有.authors.yml新建即可） 

1
2
3
4
5
authors:
  Wcowin:
    name: Wang Kewen    # Author name
    description: Free and casual # Author description
    avatar: https://s1.imagehub.cc/images/2024/02/02/91a767e93d1a344e44c69936464c583e.png          # Author avatar
结束