客製化文件版型

Docsy 樣板類型

Docsy 樣板類型有三種

在 content 目錄中可以分別建立 docs、 blog 、 community 這三種目錄去建立你的內文，這個目錄會分別針對這三種版型去產生畫面

客製化目錄路徑及版型

若你想要有自己客製化的路徑而顯示特定的版型，可以建立完客製化的目錄後，在該目錄的文件 meta 設定加入 type 的參數，設定該文章畫面類型是哪一種

---
title: "My amazing new section"
weight: 1
type: docs
---

客製化目錄同時套用同個版型

若要指定目錄下同時套用同一個版型，可以在該目錄的 _index.md 檔案中設定 cascade 的 type，這樣該目錄下所有的文章都會套用同一個版型

像是下方的 cascade 的 type 設定為 blog，則該目錄下所有的檔案內文皆會用 blog 版型

---
title: "Latest News"
linkTitle: "News"
menu:
  main:
    weight: 30

cascade:
- type: "blog"
---

指定目錄排除套用版型

在指定完目錄套用版型，若有某些子目錄想要套用其他版型，可以使用 _target 指定目錄

像是下方的 cascade 的 type 設定為 blog，只會套用在 /news 目錄

而其他所有的目錄則皆會套用 type 為 docs 的版型

---
title: "My Wonderful Site"

cascade:
- type: "blog"
  toc_root: true
  _target:
    path: "/news/**"
- type: "docs"
  _target:
    path: "/**"
---

這個設定檔案可以放在 content 目錄的最外層 _index.md，像是 /content/zh/custom-folder/_index.md，這樣就可以一次設定整個內文的所有需要套用的版型類型

參考資料

• Adding Content | Docsy