chore: add toc theme config option and update theme guides

This commit is contained in:
radishzzz 2025-05-18 17:23:32 +01:00
parent 94f9998f45
commit eb82a7d2f2
14 changed files with 121 additions and 15 deletions

View file

@ -86,6 +86,8 @@ global: {
dateFormat: 'YYYY-MM-DD'
// enable KaTeX for mathematical formulas rendering
katex: true // true, false
// enable table of contents for all posts by default
toc: true // true, false
}
```
@ -315,7 +317,7 @@ Pins the article to the top. The higher the number, the higher the priority of t
#### toc
Generate table of contents. Shows h2 to h4 headings. Default is true.
Generate table of contents. Shows h2 to h4 headings. Uses the global `global.toc` configuration by default, but can be overridden individually in each article.
#### lang

View file

@ -86,6 +86,8 @@ global: {
dateFormat: 'YYYY-MM-DD'
// habilitar KaTeX para renderizar fórmulas matemáticas
katex: true // true, false
// habilitar tabla de contenidos para todos los artículos por defecto
toc: true // true, false
}
```
@ -315,7 +317,7 @@ Fija el artículo en la parte superior. Cuanto mayor sea el número, mayor será
#### toc
Genera tabla de contenidos. Muestra encabezados h2 a h4. El valor predeterminado es true.
Genera tabla de contenidos. Muestra encabezados de h2 a h4. Utiliza la configuración global `global.toc` por defecto, pero puede ser modificada individualmente en cada artículo.
#### lang

View file

@ -86,6 +86,8 @@ global: {
dateFormat: 'YYYY-MM-DD'
// 数式表示のためのKaTeXを有効化
katex: true // true, false
// デフォルトですべての記事に目次を表示
toc: true // true, false
}
```
@ -315,7 +317,7 @@ abbrlink: theme-guide
#### toc
目次を自動生成するかどうか。h2からh4までの見出しを表示します。デフォルトは true
目次を生成するかどうか。h2からh4までの見出しを表示します。デフォルトではグローバル設定 `global.toc` を使用しますが、記事ごとに個別に設定することも可能です
#### lang

View file

@ -86,6 +86,8 @@ global: {
dateFormat: 'YYYY-MM-DD'
// включить KaTeX для отображения математических формул
katex: true // true, false
// включить оглавление для всех статей по умолчанию
toc: true // true, false
}
```
@ -315,7 +317,7 @@ abbrlink: theme-guide
#### toc
Генерировать оглавление. Показывает заголовки от h2 до h4. По умолчанию — true.
Генерировать оглавление. Показывает заголовки от h2 до h4. По умолчанию использует глобальный параметр `global.toc`, но может быть изменен индивидуально в каждой статье.
#### lang

View file

@ -86,6 +86,8 @@ global: {
dateFormat: 'YYYY-MM-DD'
// 啟用 KaTeX 數學公式渲染
katex: true // true, false
// 預設為所有文章開啟目錄
toc: true // true, false
}
```
@ -315,7 +317,7 @@ abbrlink: theme-guide
#### toc
是否生成目錄。顯示 h2 至 h4 標題。預設為 true
是否生成目錄。顯示 h2 至 h4 標題。預設為全域配置 `global.toc` 的選項,可在文章中單獨設定以覆蓋全域配置
#### lang

View file

@ -86,6 +86,8 @@ global: {
dateFormat: 'YYYY-MM-DD'
// 启用 KaTeX 数学公式渲染
katex: true // true, false
// 默认为所有文章开启目录
toc: true // true, false
}
```
@ -315,7 +317,7 @@ abbrlink: theme-guide
#### toc
是否生成目录。显示 h2 至 h4 标题。默认为 true
是否生成目录。显示 h2 至 h4 标题。默认为全局配置 `global.toc` 的选项,可在文章中单独设置以覆盖全局配置
#### lang