全体設定

plugins/EasyMenu/config.ymlには、すべてのメニューに共通する設定を書きます。

メニューの見た目やアイテムはmain.ymlまたはsub内のYAMLへ書いてください。

初期設定

language: "en_us"
debug: false

load-on-startup: true
precache-submenus: true

async:
  worker-threads: 2

cache:
  submenu-expiry-seconds: 300
  submenu-max-size: 100
  cleanup-interval-seconds: 60
  resolved-path-max-size: 200

submenu:
  search-depth: 3

各項目の説明

項目	説明
language	en_us、ja_jp、ru_ruなどの言語code
debug	詳しいdebug logを出すかどうか
load-on-startup	起動時にメニューを確認するかどうか
precache-submenus	起動またはreload時にサブメニューもcacheするかどうか
async.worker-threads	ファイル読み込みに使うworker数
cache.submenu-expiry-seconds	読み込んだメニューをcacheへ残す秒数
cache.submenu-max-size	cacheへ残すメニューの最大数
cache.cleanup-interval-seconds	期限切れcacheを確認する間隔
cache.resolved-path-max-size	見つけたmenu file pathを覚える最大数
submenu.search-depth	subフォルダ内を何階層まで探すか

0以下などの無効な値には安全な初期値を使用します。

reloadの動作

/menu reloadは、新しいconfig.yml、言語、main.yml、すべてのサブメニューを先に確認します。

すべての確認が終わった場合だけ、新しい設定へ切り替えます。

YAMLの書き間違いや無効なMaterialがある場合は切り替えず、それまでのメニューを維持します。

worker数とcache設定もreload後に反映されるため、server再起動は不要です。