Lookup cascade

Thay vì bắt mỗi trang khai báo dùng template nào, pyssg phân giải template tự động từ type, section và kind của trang - cùng một ý tưởng với template lookup của Hugo. Thả một blog/single.html vào layouts của bạn và mọi bài blog dùng nó, không cần frontmatter.

Thứ tự

Với mỗi trang, plugin thử các tên sau theo thứ tự và dùng tên đầu tiên tồn tại:

1. <frontmatter layout>        explicit override, always wins
2. <type>/<kind>.html          e.g. blog/single.html
3. <section>/<kind>.html       e.g. <top folder>/list.html
4. _default/<kind>.html        e.g. _default/single.html
5. <kind>.html                 e.g. list.html
6. <default_layout>            final fallback (default.html)

Các biến

kind là list cho các trang listing được sinh ra (trang tag, chỉ mục blog) và single cho mọi thứ còn lại. pyssg đặt nó từ cờ generated của trang, nên bạn không phải quản lý nó bằng tay.
type đến từ frontmatter type. Dùng nó để gán cho một nhóm trang một template riêng biệt bất kể chúng nằm ở đâu: type: tutorial -> tutorial/single.html.
section là thư mục cấp cao nhất của đường dẫn nguồn. Một file tại blog/hello.md có section là blog.

Ví dụ

Trang	Template được phân giải (tên đầu tiên tồn tại)
`blog/hello.md`	`blog/single.html` -> `_default/single.html` -> `default.html`
`blog/hello.md` với `type: featured`	`featured/single.html` -> `blog/single.html` -> ...
một trang tag được sinh ra trong `tags/`	`tags/list.html` -> `_default/list.html` -> ...
`about.md` (gốc)	`_default/single.html` -> `single.html` -> `default.html`
bất kỳ trang nào có `layout: special.html`	`special.html` trước tiên

Vì sao nó quan trọng

Cascade là thứ biến một thư mục layout thành một theme tái dùng được. Một trang chỉ cần layout cho những trường hợp thực sự cá biệt; trường hợp thông dụng - "mọi bài viết trông như thế này, mọi trang danh sách trông như thế kia" - được diễn đạt một lần trong _default/single.html và _default/list.html. Trang này không khai báo layout trong bất kỳ file nội dung nào; nó hoàn toàn được điều khiển bởi cascade.