コンテンツにスキップ

カテゴリ管理できないのか?

CMS には必ずあるはずのカテゴリ管理できないか試してみました。

新たなディレクトリCMSに従来のファイルを移動し、新たなファイルを作成

  • cms というカテゴリを作成
  • ここに既作製の theme_change_material.md というファイルを移動。
  • このディレクトリに directory_change.md(このファイルです。)を作成。

tree 表示するとこのような状態です。

── my-project
    ├── docs
    │   ├── cms
    │   │   ├── directory_change.md
    │   │   └── theme_change_material.md
    │   ├── img
    │   │   └── 20260115.jpg
    │   └── index.md

mkdocs.ymlの記載を変更

nav:
  - Home: index.md
  - CMS: 
    - materil_theme:  cms/theme_change_material.md
    - directory_change: cms/directory_change.md

この状態で build

$ mkdocs build --clean
INFO    -  Cleaning site directory
INFO    -  Building documentation to directory: /home/ken/Nextcloud2/mkdocs/my-project/site
INFO    -  Documentation built in 0.38 seconds

出来上がったのは?

表示はできましたが、ディレクトリ構成は以下のとおりになりました。

        ├── cms
        │   ├── directory_change
        │   │   └── index.html
        │   └── material_theme
        │       └── index.html

むーん。やはり新たなディレクトリが作成され、index.html ができております。これがどうも理解し難い。

望むディレクトリ構成は以下のようなものなのです。

        ├── cms
        │   ├── directory_change.html
        │   └── theme_change_material.html
        │     

それにこのようなカテゴリ管理は、いちいち mkdocs.yml の記述を加筆しなければならず、多数のポストを含むカテゴリ管理としては限界が生じてくるだろう。