Setup Blog

このWebページをbuildするのに利用しているMaterial for MkDocsのBlog機能が支援者以外でも利用できるβ版がリリースされていたのでセットアップしてみた

Setup

既存のmkdocs環境に対して下記の操作を行う

1. Material for MkDocsのv9.2.0b0をインストール

   pip install mkdocs-material==9.2.0b0
   

2. mkdocs.ymlに追記

   nav:
     - Blog:
       - blog/index.md
   plugins:
     - blog:
         blog_toc: true
   

   • トップページをnavigationに追加
   • blog: プラグイン追加
   • blog_toc: トップページに目次を表示
3. 記事を追加 blog/posts/に適当な.mdファイルを追加し，下記yamlヘッダを追加

   ---
   title: Setup Blog
   date: 2023-07-14
   categories:
     - diary
   ---
   

4. ビルド

   mkdocs build
   

Reference

• Setting up a blog - Material for MkDocs
• Blog support just landed - Material for MkDocs
• Release mkdocs-material-9.2.0b0 · squidfunk/mkdocs-material