{data-outline=\\"level\\"} attribute syntax for headings, close #757 (#759)"},{"hash":"ddb77a06a5bea91593d797ee307fcf2f115dd60b","time":1763644166000,"email":"volodymyr@foxmail.com","author":"pengzhanbo","message":"feat(theme): add footer frontmatter"},{"hash":"385059f214cb07fc9a098859e889432fb81f998b","time":1759995965000,"email":"volodymyr@foxmail.com","author":"pengzhanbo","message":"docs: update en docs (#708)"},{"hash":"4d2361a7046214fe0f4e4af01831107fd00e38ad","time":1759849989000,"email":"volodymyr@foxmail.com","author":"pengzhanbo","message":"feat(theme)!: add collections support (#704)"},{"hash":"0fd6cac57412002f4d72dc10378789b529adc357","time":1742063370000,"email":"volodymyr@foxmail.com","author":"pengzhanbo","message":"refactor(theme): improve types and flat config (#524)"},{"hash":"a4ac3a30e0b74175b3cd4fd82c52b2321b013926","time":1741490087000,"email":"95458562+zhenghaoyang24@users.noreply.github.com","author":"zhenghaoyang24","message":"docs: add en-US docs (#514)","coAuthors":[{"name":"pengzhanbo","email":"volodymyr@foxmail.com"}]}]},"autoDesc":true,"filePathRelative":"en/config/frontmatter/basic.md","headers":[],"bulletin":false}`),u={name:`basic.md`};function d(c,l,u,d,f,p){let m=t(`VPLink`);return n(),i(`div`,null,[l[15]||=o(`General Frontmatter configuration applicable to all articles.
Example:
---
title: Title
createTime: 2024/03/02 20:01:09
permalink: /config/frontmatter/basic/
---Type: false | 'home' | 'doc' | 'custom' | 'page' | 'friends' | string
Default: doc
Details:
Page layout mode.
'home': Homepage layout'doc': Documentation page layout, including left sidebar, article content, right sidebar, navbar, comments, etc.'page': Includes only the navbar and MD file content. Use this layout for custom page content.'friends': Friends link page layout'custom': Includes only MD file content. Use this layout for fully custom page content.false: Equivalent to customstring: A global component name can be passed, which will be applied as the layout component.Type: string
Default: ''
Details:
Additional custom CSS class name for the page.
Type: string
Default: ''
Details:
Article title.
The theme automatically populates the current filename as the article title upon file creation.
string | { text: string, type?: 'info' | 'tip' | 'warning' | 'danger' }Display a badge on the right side of the article title.
Type: string
Default: ''
Details:
Article creation time.
The theme automatically populates the current time as the article creation time upon file creation.
Type: string
Default: ''
Details:
Article permanent link.
Upon file creation, the theme automatically populates:
/article/ + 8-character random string generated by nanoid as the permanent link.Type: boolean
Default: true
Details:
Whether to display the external link icon for external links within the current article.
Type: boolean
Default: true
Details:
Whether to display the back-to-top button for the current article.
Type: boolean
Default: true
Details:
Whether the current article is commentable. Only takes effect when the comment feature is enabled.
Type: boolean | 'left'
Default: true
Details:
Whether to display the right sidebar for the current article.
When set to 'left', the right sidebar will be displayed on the left side.
Type: boolean
Default: true
Details:
Whether to display the navigation bar for the current article.
Type: false | number | [number, number] | 'deep'
Default: [2, 3]
Details:
The heading levels to display.
A single number indicates displaying only headings of that level.
If a tuple is passed, the first number is the minimum level and the second number is the maximum level.
'deep' is the same as [2, 6], which displays all headings from <h2> to <h6>.
Tips
In markdown content, using the attribute syntax {data-outline="level"} / {outline="level"} after a heading allows you to reset the maximum display level for descendant headings under the current heading.
For example:
## Heading 1 {data-outline="5"} <!-- Only affects descendant headings of the current heading -->
### Level 3 Heading
#### Level 4 Heading
##### Level 5 Heading <!-- Level 3, 4, and 5 headings will appear in the sidebar -->
###### Level 6 Heading <!-- This heading will NOT appear in the sidebar -->
## Heading 2 <!-- Headings at the same level are not affected -->
### Level 3 Heading <!-- By default, only up to level 3 headings are shown -->
#### Level 4 Heading <!-- Level 4 headings are not shown -->Note that the value of level should be greater than the level of the current heading; otherwise, it will not take effect.
Type: string | { text: string, link: string, icon?: string }
Default: ''
Details:
Customize the previous article for the current article.
Type: string | { text: string, link: string, icon?: string }
Default: ''
Details:
Customize the next article for the current article.
Type: boolean
Default: true
Details:
Whether to display the reading time for the current article.
Type: boolean
Default: true
Details:
Whether to display the last updated time for the current article. The last updated time is automatically populated based on the git commit time.
Type: boolean
Default: false
Details:
Whether to display the page change history for the current page.
Type: boolean
Default: true
Details:
Whether to display the article edit button for the current article.
Type: boolean | WatermarkOptions
Default: undefined (When the theme does not enable watermarks, or when global watermarks are not enabled, the default value is false. If global watermarks are enabled, the default is true.)
Details: Configure the watermark for the current article.
When the type is boolean, it indicates whether to enable the watermark.
When the type is WatermarkOptions, it represents the watermark configuration for the current page.
You can refer to watermark-js-plus.
Type: boolean
Default: true
Details:
Whether to display the footer for the current article.