L

主题系统

目录结构

每个主题位于 litedocs/themes/{name}/ 下:

litedocs/themes/default/
├── theme.json
├── templates/
│   ├── base.html
│   ├── page.html
│   ├── macros/
│   │   └── sidebar_node.html
│   ├── partials/
│   │   ├── header.html
│   │   ├── sidebar.html
│   │   └── ...
│   └── errors/
│       └── 404.html
└── static/
    ├── css/style.css
    └── js/app.js

静态资源服务

主题静态文件挂载在 /_themes/{name}/。模板中引用方式:

<link rel="stylesheet" href="/_themes/default/css/style.css">

模板上下文

渲染器为所有模板提供以下变量:

变量 类型 描述
page Page 当前页面数据
config SiteConfig 站点配置
nav_items list 顶部导航项
sidebar list 侧边栏节点
locale str 当前语言代码
doc_slug str 当前文档目录名
doc_list list 所有注册的文档