テーマを material に変更しました
テーマを途中で変更すると大変だ
大きく異なるのは2点
前のページのtree 表示と比べてみてほしいが気づいたのは以下の2点。
次頁は異なるディレクトリのindex.htmlが作成される
docs にテーマを変更しましたという md ファイル(2ページ目のつもり)を作り、mkdocs build を実行したら、別のディレクトリーを作ったうえで、index.html が出来上がる。
[具体例]
theme_change_material.md を作成し、同一のディレクトリーに theme_change_material.html ができるのかと思ったら、theme_change_material ディレクトリーが作成され、その中に index.html が作成された。
テーマが使用する既定のディレクトリは自由にならない
テーマごとにディレクトリーやファイルが異なるのは理解できるが、それを自由に作ったりできず、テーマを変更するとすでに使用していたディレクトリーやファイルは消去される
[具体例]
変更前の readthedocs にあった /images/ フォルダーがなくなった。おかげでこのフォルダーを利用していた jpg ファイルも消去されてしまった。
それではと、material テーマにある assets/imgages フォルダーに jpg ファイルを入れて見たところ、build すると削除れてしまう。 フォルダはどうもテーマで管理されており自由にならない。
解決には docs フォルダーに テーマーで使われていないディレクトリーを作成し、md ファイルではこのディレクトリにリンクするようにすればよい。以下のようにだ。
docs
index.md
img/
xxxx.jpg
とにかく変更したばっかりなので、これから気づくことがあるかもしれないが、まだ2ページだけで良かったトホホ。
.
├── docs
│ ├── index.md
│ └── theme_change_material.md
├── mkdocs.yml
└── site
├── 404.html
├── assets
│ ├── images
│ │ └── favicon.png
│ ├── javascripts
│ │ ├── bundle.79ae519e.min.js
│ │ ├── bundle.79ae519e.min.js.map
│ │ ├── lunr
│ │ │ ├── min
│ │ │ │ ├── lunr.ar.min.js
│ │ │ │ ├── lunr.da.min.js
│ │ │ │ ├── lunr.de.min.js
│ │ │ │ ├── lunr.du.min.js
│ │ │ │ ├── lunr.el.min.js
│ │ │ │ ├── lunr.es.min.js
│ │ │ │ ├── lunr.fi.min.js
│ │ │ │ ├── lunr.fr.min.js
│ │ │ │ ├── lunr.he.min.js
│ │ │ │ ├── lunr.hi.min.js
│ │ │ │ ├── lunr.hu.min.js
│ │ │ │ ├── lunr.hy.min.js
│ │ │ │ ├── lunr.it.min.js
│ │ │ │ ├── lunr.ja.min.js
│ │ │ │ ├── lunr.jp.min.js
│ │ │ │ ├── lunr.kn.min.js
│ │ │ │ ├── lunr.ko.min.js
│ │ │ │ ├── lunr.multi.min.js
│ │ │ │ ├── lunr.nl.min.js
│ │ │ │ ├── lunr.no.min.js
│ │ │ │ ├── lunr.pt.min.js
│ │ │ │ ├── lunr.ro.min.js
│ │ │ │ ├── lunr.ru.min.js
│ │ │ │ ├── lunr.sa.min.js
│ │ │ │ ├── lunr.stemmer.support.min.js
│ │ │ │ ├── lunr.sv.min.js
│ │ │ │ ├── lunr.ta.min.js
│ │ │ │ ├── lunr.te.min.js
│ │ │ │ ├── lunr.th.min.js
│ │ │ │ ├── lunr.tr.min.js
│ │ │ │ ├── lunr.vi.min.js
│ │ │ │ └── lunr.zh.min.js
│ │ │ ├── tinyseg.js
│ │ │ └── wordcut.js
│ │ └── workers
│ │ ├── search.2c215733.min.js
│ │ └── search.2c215733.min.js.map
│ └── stylesheets
│ ├── main.484c7ddc.min.css
│ ├── main.484c7ddc.min.css.map
│ ├── palette.ab4e12ef.min.css
│ └── palette.ab4e12ef.min.css.map
├── index.html
├── search
│ └── search_index.json
├── sitemap.xml
├── sitemap.xml.gz
└── theme_change_material
└── index.html
14 directories, 80 files