## 準備
[[obsidian-publish-mkdocs]]のREADMEに従って試す。
- プロジェクトテンプレートを作成
- クローン
- マークダウンファイルやディレクトリを`docs`配下にコピー
## ローカル起動準備
```console
poetry init
poetry add mkdocs-material mkdocs-roamlinks-plugin
poetry run mkdocs serve
```
## 日本語検索に対応する
`theme`に`language: ja`を追加。
```yaml:mkdocs.yml
theme:
# 中略
language: "ja"
# 中略
```
`plugins.search`に`lang`を指定する[^1]。
```yaml:mkdocs.yml
plugins:
- search:
lang:
- en
- roamlinks
```
## クローラーにクローリングされないようにする
[[noindex]]を使う。ヘッダに`meta`タグを差し込むため`custom_dir: overrides`を設定。
```yaml:mkdocs.yml
theme:
# 中略
custom_dir: overrides
```
`overrides/main.html`を作成。
```html:overrides/main.html
{% extends "base.html" %}
{% block extrahead %}
<meta name="robots" content="noindex">
{% endblock %}
```
## 公開する
git pushして[[GitHub Pages]]を設定。`Save`をクリック。
![[Pasted image 20220103214428.png]]
## トラブルシューティング
- [[📝WindowsだとMkdocs Roamlinks Pluginで2つ以上親のファイルへリンクされない]]
[^1]: [[Mkdocsのprebuild_indexはv8.0.0で非推奨になった]]ため使用しない