章节导航

一个章节的页面只需编写一次作为导航，然后根据应用的选择进行展示：在标题下的标签，就像本章节的其他页面一样，或者在进入该章节时的侧边菜单——就像本页面，左侧的菜单就是这个章节的导航。

编写内容

章节的布局设置了页面章节导航：章节是什么（标签、链接），留给什么（返回），以及它的视图（项目），每个都是读者可能打开的路径——其他的则被省略。一个项目在一系列页面上保持高亮（匹配），并且可以拥有自己的视图（子项）。

{%- set page_section_navigation = {
    label: organization.name,
    href: path('organization_show', { id: organization.id }),
    back: { href: path('organization_index'), label: 'Organizations' },
    items: [
        { label: 'Overview', icon: 'ph:bold/gauge', route: 'organization_show', params: { id: organization.id } },
        { label: 'Accounting', icon: 'ph:bold/calculator', route: 'accounting_show', params: { id: ledger.id }, children: [
            { label: 'Bank', icon: 'ph:bold/bank', route: 'accounting_bank_index', params: { ledger: ledger.id }, match: 'accounting_bank_' },
        ] },
    ],
} -%}

绘制内容

布局章节导航说明了如何：默认情况下为标签，显示页面所处的层级——在返回章节的路径下显示视图的子项——或者菜单，展示整个章节，返回路径在顶部，包含当前页面的视图展开。

{# The app's layout: every section takes the side menu while one is in it. #}
{%- set layout_section_navigation = 'menu' -%}