コンテンツにスキップ

テーマを 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

material theme の設定例参考ページ