## 事象 [[🦉Toki]]で[[MkDocs]]のsandboxプロジェクトを作成し、起動しても[[Live Reloading (MkDocs)|Live Reloading]]による自動更新がされない。 ```console toki mkdocs mkdocs-sandbox cd mkdocs-sandbox uv run mkdocs serve -a localhost:8081 ``` 以前は上手くできていた。 ### 環境 | 対象 | バージョン | | ---------- | ------ | | [[macOS]] | 15.7.1 | | [[Python]] | 3.13.7 | | [[MkDocs]] | 1.6.1 | | [[uv]] | 0.8.22 | パッケージのバージョン。 ``` Installed 52 packages in 228ms + annotated-types==0.7.0 + babel==2.17.0 + backrefs==5.9 + bracex==2.6 + certifi==2025.10.5 + charset-normalizer==3.4.4 + click==8.3.0 + colorama==0.4.6 + ghp-import==2.1.0 + gitdb==4.0.12 + gitpython==3.1.45 + idna==3.11 + jinja2==3.1.6 + markdown==3.9 + markupsafe==3.0.3 + mdx-truly-sane-lists==1.3 + mergedeep==1.3.4 + mkdocs==1.6.1 + mkdocs-awesome-nav==3.2.0 + mkdocs-backlinks-section-plugin==0.0.6 + mkdocs-get-deps==0.2.0 + mkdocs-git-authors-plugin==0.10.0 + mkdocs-git-revision-date-localized-plugin==1.4.7 + mkdocs-glightbox==0.5.1 + mkdocs-material==9.6.22 + mkdocs-material-extensions==1.3.1 + mkdocs-obsidian-bridge==1.2.0 (from git+https://github.com/tadashi-aikawa/mkdocs-obsidian-bridge@84cc9381faac94800a291fd9f236300da67d976e) + mkdocs-open-in-new-tab==1.0.8 + natsort==8.4.0 + obsidian-callouts==1.0.1 + obsidian-media==2.0.0 + packaging==25.0 + paginate==0.5.7 + pathspec==0.12.1 + platformdirs==4.5.0 + pydantic==2.12.2 + pydantic-core==2.41.4 + pygments==2.19.2 + pymdown-extensions==10.16.1 + python-dateutil==2.9.0.post0 + pytz==2025.2 + pyyaml==6.0.3 + pyyaml-env-tag==1.1 + requests==2.32.5 + selectolax==0.3.29 + six==1.17.0 + smmap==5.0.2 + typing-extensions==4.15.0 + typing-inspection==0.4.2 + urllib3==2.5.0 + watchdog==6.0.0 + wcmatch==10.1 ``` ## 原因 [[Click]]のバージョン8.3.0で発生している問題によるもの。 <div class="link-card-v2"> <div class="link-card-v2-site"> <img class="link-card-v2-site-icon" src="https://github.githubassets.com/favicons/favicon.svg" /> <span class="link-card-v2-site-name">GitHub</span> </div> <div class="link-card-v2-title"> `mkdocs` does not watch for file changes when using `click>8.2.1` · Issue #4032 · mkdocs/mkdocs </div> <div class="link-card-v2-content"> I noticed when I did a dependency upgrade to some of the latest and greatest, that mkdocs was no longer watching ... </div> <img class="link-card-v2-image" src="https://opengraph.githubassets.com/d35652514480a1c367075c009641e26da6cadb29bfd6001c490d5b2882764a11/mkdocs/mkdocs/issues/4032" /> <a href="https://github.com/mkdocs/mkdocs/issues/4032"></a> </div> boolフラグの取扱に変更が生じており、[[Click]]でもissueとなっていそう。 <div class="link-card-v2"> <div class="link-card-v2-site"> <img class="link-card-v2-site-icon" src="https://github.githubassets.com/favicons/favicon.svg" /> <span class="link-card-v2-site-name">GitHub</span> </div> <div class="link-card-v2-title"> Bug: Optional value not optional anymore · Issue #3084 · pallets/click </div> <div class="link-card-v2-content"> Outline As stated in official documentation: Setting isflag=False, flagvalue=value tells Click that the option c ... </div> <img class="link-card-v2-image" src="https://opengraph.githubassets.com/7be411a89e194f90c4a9973bcd65ed9f25dd3ad8ee6c4f4c3c7d30c0f2083e6e/pallets/click/issues/3084" /> <a href="https://github.com/pallets/click/issues/3084"></a> </div> ## 回避策 [[Click]]を 8.2.1 に戻す。 もしくは `--livereload` フラグをつけて起動する。 ```console uv run mkdocs serve -a localhost:8081 --livereload ``` ## 参考 - [MkDocsでClick 8.2.1「より新しいバージョン」を使うとライブリロードされない - Sig9 Memo v4.0](https://sig9.org/blog/2025/10/07/)