外部 Vault のトラブルシュート

外部 Vault や複雑な directory 構成を使っている場合は、次の順番で確認すると原因を切り分けやすくなります。

Diagram source

flowchart LR
    Check["1. check"]
    Doctor["2. doctor"]
    Config["3. inspect config"]
    Content["4. inspect content --list"]
    Build["5. build"]
 
    Check --> Doctor
    Doctor --> Config
    Config --> Content
    Content --> Build

1. Config を検証する

npm exec riebeckite check

Config と Plugin contract が正しいか確認します。

2. Content Source を診断する

npm exec riebeckite doctor

filesystem content source が存在しない、読み込めないなどの問題を確認します。

3. 解決された Directory を確認する

npm exec riebeckite inspect config

content.directory が期待する絶対 path に解決されているか確認します。

4. Content を確認する

npm exec -- riebeckite inspect content --list

WikiLink や embed を調査する前に、期待する logical path と content が認識されていることを確認します。

5. 実際に Build する

npm exec riebeckite build

最後に Integration、SSG、route rendering まで含めて確認します。

History

1 changesCollapseExpand

From To

	1	`+ ---`
	2	`+ title: 外部 Vault のトラブルシュート`
	3	`+ sidebar:`
	4	`+ label: トラブルシュート`
	5	`+ order: 80`
	6	`+ ---`
	7	`+ # 外部 Vault のトラブルシュート`
	8	`+`
	9	`+ 外部 Vault や複雑な directory 構成を使っている場合は、次の順番で確認すると原因を切り分けやすくなります。`
	10	`+`
	11	+ ```mermaid id="5yfgda"
	12	`+ flowchart LR`
	13	`+ Check["1. check"]`
	14	`+ Doctor["2. doctor"]`
	15	`+ Config["3. inspect config"]`
	16	`+ Content["4. inspect content --list"]`
	17	`+ Build["5. build"]`
	18	`+`
	19	`+ Check --> Doctor`
	20	`+ Doctor --> Config`
	21	`+ Config --> Content`
	22	`+ Content --> Build`
	23	+ ```
	24	`+`
	25	`+ ## 1. Config を検証する`
	26	`+`
	27	+ ```sh id="7x4ypg"
	28	`+ npm exec riebeckite check`
	29	+ ```
	30	`+`
	31	`+ Config と Plugin contract が正しいか確認します。`
	32	`+`
	33	`+ ## 2. Content Source を診断する`
	34	`+`
	35	+ ```sh id="t7e22k"
	36	`+ npm exec riebeckite doctor`
	37	+ ```
	38	`+`
	39	`+ filesystem content source が存在しない、読み込めないなどの問題を確認します。`
	40	`+`
	41	`+ ## 3. 解決された Directory を確認する`
	42	`+`
	43	+ ```sh id="rgnpgo"
	44	`+ npm exec riebeckite inspect config`
	45	+ ```
	46	`+`
	47	+ `content.directory` が期待する絶対 path に解決されているか確認します。
	48	`+`
	49	`+ ## 4. Content を確認する`
	50	`+`
	51	+ ```sh id="4ssq64"
	52	`+ npm exec -- riebeckite inspect content --list`
	53	+ ```
	54	`+`
	55	`+ WikiLink や embed を調査する前に、期待する logical path と content が認識されていることを確認します。`
	56	`+`
	57	`+ ## 5. 実際に Build する`
	58	`+`
	59	+ ```sh id="9wnm73"
	60	`+ npm exec riebeckite build`
	61	+ ```
	62	`+`
	63	`+ 最後に Integration、SSG、route rendering まで含めて確認します。`
	64	`+`