Documentation Index
Fetch the complete documentation index at: https://mintlify.com/syhily/yufan.me/llms.txt
Use this file to discover all available pages before exploring further.
Navigation and social links are configured in the admin console and stored in two settings sections — changes take effect immediately on the next page load without a cache flush or redeployment.
Changes to navigation and social settings take effect on the next page load — no cache flush or redeploy needed.
Navigation (blog.navigation)
Path: /admin/settings/navigation
The Navigation section manages the links shown in the site header/sidebar and the items that appear in the footer bar.
Side navigation (sideNav)
sideNav is an ordered array of up to 20 link items displayed in the site header or sidebar. Each item has the following fields:
| Field | Required | Description |
|---|
| Text | Yes | Display label (1 – 40 characters) |
| Link | Yes | Destination URL or path (1 – 200 characters) |
| Target | No | Link target attribute, e.g. _blank (max 20 characters) |
footerNav is an ordered array of up to 5 items shown in the site footer bar. Each item is one of three types:
| Type | Description |
|---|
social | Renders a social-network icon link — pair with a network value from your Socials configuration |
themeToggle | Renders the dark/light mode toggle button |
search | Renders the search icon button |
Socials (blog.socials)
Path: /admin/settings/socials
The Socials section stores an array of social profile entries. Each entry is tied to one of the supported platforms and is displayed as an icon link in the sidebar or footer.
| Field | Description |
|---|
| Name | Display name for the profile |
| Network | Platform identifier (chosen from the supported network list) |
| Type | link for a direct URL, qrcode for a QR code overlay (set automatically per platform) |
| Title | Optional tooltip or accessible label (max 120 characters) |
| Link | Absolute URL of the social profile |
qrcode display type; all other platforms use link.
SEO (blog.seo)
Path: /admin/settings/seo
The SEO section controls the table-of-contents depth and the canvas dimensions for server-rendered Open Graph images.
Table of contents
| Field | Default | Description |
|---|
| Minimum heading level | H2 | Headings at this level and deeper appear in the TOC (1 – 6) |
| Maximum heading level | H4 | Headings deeper than this are excluded from the TOC (1 – 6) |
##, ###, and #### headings are included; ##### and ###### are not.
Open Graph image dimensions
| Field | Default | Constraints |
|---|
| OG image width | 1200 px | 600 – 4096 px |
| OG image height | 630 px | 315 – 4096 px |
/admin/settings/comments
The Comments section configures comment pagination, Gravatar avatar display, and the comment token lifetime.
| Field | Default | Description |
|---|
| Comments per page | 10 | Number of top-level comments shown per page (1 – 100) |
| Gravatar mirror URL | https://www.gravatar.com/avatar | Base URL for Gravatar avatar requests — swap for a regional mirror if needed |
| Avatar size | 80 px | Pixel dimensions requested from Gravatar (16 – 512) |
| Comment token TTL | 1800 s | How long a commenter’s verification token remains valid before re-verification is required (60 – 86400 s) |
https://gravatar.loli.net/avatar). The path suffix is appended automatically.