Theme Configuration
Info
This documentation is AI-generated. You can help improve it by submitting an Issue.
You can directly modify these configuration items in the backend "Theme Settings" interface.
提示
After your site has installed the latest version of the theme, you can fill in your site link below.
This will enable quick jump links in this documentation, jumping to the corresponding configuration item in the backend with one click.
Site Link
Example
🎯 Purpose
Explains the purpose of the configuration item.
📂 Configuration Item Location
Explains the location in the theme configuration.
⚡ Quick Jump
Click to quickly jump to the corresponding theme configuration item.
🏷️ Type
The value type of this configuration item.
Here are some common types
- String: A sequence of characters, such as
abc123,zh-CN. - Integer: Whole numbers, such as
-1,0,100. - Float: Numbers with decimal points, such as
1.2,0.3,4.5. - Boolean:
trueorfalse. In actual configuration items, it appears as a switch, on istrue, off isfalse. - Option: Fixed options are provided, just select directly.
- Repeater: Can repeat a group of inputs. Can add groups, remove groups, swap order of any groups.
- Code input box (programming language): Provides a multi-line code input box, which will be highlighted according to the specified programming language.
- Attachment: Select uploaded attachments.
- Icon: Use the icon setting box provided by Halo CMS, where you can select any iconify icon.
⭐ Default Value
The default value of this configuration item.
How to reset all configurations to default values?
Go to /console/theme, then click the three dots on the far right of the theme name row, and finally click the reset button.
💡 Example Values
A few more examples for better understanding.
🔒 Internal Constraints
If the configured value does not meet this requirement, the configuration cannot be saved.
⚠️ External Constraints
If the configured value does not meet this requirement, the theme may not work properly.
🧩 Template Variable
Variables provided for template developers to read this configuration value. Can be used via ${template variable} .
ℹ️ Additional Information
Supplementary information.
Global
Default Page Language
🎯 Purpose
Specify the site root tag <html> lang attribute default value, used to assist accessibility, SEO, and browser/plugin language detection (e.g., whether the browser prompts for page translation).
📂 Configuration Item Location
Global -> Default Page Language
🏷️ Type
String
⭐ Default Value
zh
💡 Example Values
zh,zh-CN,zh-Hans,en,en-US
⚠️ External Constraints
The set value must comply with BCP 47, otherwise it will be invalid.
🧩 Template Variable
theme.config?.global?.default_page_language
ℹ️ Additional Information
- Security: The set language value will be automatically escaped, no need to worry about XSS injection attacks.
- Setting priority: Please refer to page language setting priority.
Multilingual Function Prefix Matching Mode
🎯 Purpose
Enable the prefix matching mode for multilingual functionality, allowing the theme to match language settings more flexibly.
📂 Configuration Item Location
Global -> Multilingual Function Prefix Matching Mode
⚡ Quick Jump
/console/theme/settings/global#:~:text=Multilingual%20Function%20Prefix%20Matching%20Mode🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.global?.is_i18n_prefix_match_mode
ℹ️ Additional Information
For specific usage methods, please refer to Prefix Matching Mode Description.
Auto-redirect Based on Browser Language
🎯 Purpose
Automatically redirect to the corresponding language page based on the browser language settings.
📂 Configuration Item Location
Global -> Auto-redirect Based on Browser Language
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.global?.is_auto_redirect_to_browser_language
ℹ️ Additional Information
After enabling this option, if the browser language differs from the Default Page Language and the browser language exists in the Allowed Target Language Code List for Redirects, it will automatically redirect to the corresponding page.
After enabling, please refer to the Auto-redirect Based on Browser Language Guide for configuration.
When enabled, you can configure:
- [Allowed Target Language Code List for Redirects](#Allowed Target Language Code List for Redirects)
Allowed Target Language Code List for Redirects
🎯 Purpose
Set allowed auto-redirect target languages.
📂 Configuration Item Location
([Global -> Auto-redirect Based on Browser Language](#Auto-redirect Based on Browser Language) When enabled, will display)
Global -> Allowed Target Language Code List for Redirects
⚡ Quick Jump
/console/theme/settings/global#:~:text=Allowed%20Target%20Language%20Code%20List%20for%20Redirects🏷️ Type
Repeater
⭐ Default Value
Empty
💡 Example Values
📂 Configuration Item Name
Language Code
🏷️ Type
String
⭐ Default Value
zh
💡 Example Values
zh, zh-CN, zh-Hans, en, en-US
🔒 Internal Constraints
Required field
⚠️ External Constraints
The set value must comply with BCP 47, otherwise it will be invalid.
🧩 Template Variable
theme.config?.global?.auto_redirect_target_language_list
ℹ️ Additional Information
After enabling [Auto-redirect Based on Browser Language](#Auto-redirect Based on Browser Language), if the browser language is different from the Default Page Language and the browser language exists in this option, it will automatically redirect to the corresponding page.
Please refer to the Auto-redirect Based on Browser Language Usage Guide for configuration.
Matching order is from top to bottom.
Multilingual Menu Support
🎯 Purpose
Enable Multilingual Menu Support, allowing the menu to display content in different languages.
📂 Configuration Item Location
Global -> Multilingual Menu Support
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.global?.is_i18n_menu_show
ℹ️ Additional Information
After enabling, please refer to the Multilingual Menu Usage Guide for configuration.
CSP:upgrade-insecure-requests
🎯 Purpose
Automatically upgrade non-redirected insecure resource requests to HTTPS, including the current domain and third-party requests.
📂 Configuration Item Location
Global -> CSP:upgrade-insecure-requests
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.global?.upgrade_insecure_requests
Only Allow Access from Specified Domains
🎯 Purpose
Prevent traffic loss after the site is maliciously mirrored, only allowing access from domains in the whitelist.
📂 Configuration Item Location
Global -> Only Allow Access from Specified Domains
⚡ Quick Jump
/console/theme/settings/global#:~:text=Only%20Allow%20Access%20from%20Specified%20Domains🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.global?.anti_mirror_site
ℹ️ Additional Information
After enabling, please refer to Enable Only Allow Access from Specified Domains for configuration.
When enabled, you can configure:
- [Domain Whitelist](#Domain Whitelist)
- [Target Link](#Target Link)
- Keep Path and Query Parameters After Redirect
Domain Whitelist
🎯 Purpose
Set the Domain Whitelist.
📂 Configuration Item Location
([Global -> Only Allow Access from Specified Domains](#Only Allow Access from Specified Domains) When enabled, will display)
Global -> Domain Whitelist
🏷️ Type
Repeater
⭐ Default Value
Empty
💡 Example Value
📂 Configuration Item Name
Base64-encoded domain name
🏷️ Type
String
💡 Example Values
bG9jYWxob3N0
🔒 Internal Constraints
Required field
🧩 Template Variable
theme.config?.global?.allow_site_whitelist
ℹ️ Additional Information
Please refer to Enable Only Allow Access from Specified Domains for configuration.
Target Link
🎯 Purpose
SetDomain Whitelist.
📂 Configuration Item Location
([Global -> Only Allow Access from Specified Domains](#Only Allow Access from Specified Domains) When enabled, will display)
Global -> Target Link
🏷️ Type
String
⭐ Default Value
bG9jYWxob3N0
💡 Example Values
bG9jYWxob3N0
🧩 Template Variable
theme.config?.global?.target_url
ℹ️ Additional Information
Please refer to Enable Only Allow Access from Specified Domains for configuration.
Keep Path and Query Parameters After Redirect
🎯 Purpose
Set whether to keep path and query parameters after redirect.
📂 Configuration Item Location
([Global -> Only Allow Access from Specified Domains](#Only Allow Access from Specified Domains) When enabled, will display)
Global -> Keep Path and Query Parameters After Redirect
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.global?.is_keep_path_and_query
ℹ️ Additional Information
Please refer to Enable Only Allow Access from Specified Domains for configuration.
Assuming the user accesses the link http://localhost/a/b?a=1, and the [Target Link](#Target Link) is set to (before Base 64 encoding) https://p.com:
- With this option disabled, it will redirect to:
https://p.com - With this option enabled, it will redirect to:
https://p.com/a/b?a=1
Custom Resource Location Address
🎯 Purpose
Specify that resources will use custom resource location addresses instead of the theme's default addresses.
📂 Configuration Item Location
Global -> Custom Resource Location Address
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.global?.is_custom_resource_locations
ℹ️ Additional Information
After enabling this option, if you enable the "instant.page Support" or "Mermaid Support" options below, the corresponding resource location configuration items will be displayed.
instant.page Support
🎯 Purpose
Automatically load the instant.page script to preload links and improve page loading speed.
📂 Configuration Item Location
Global -> instant.page Support
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.global?.is_instant_page_enable
Mermaid Support
🎯 Purpose
Enable Mermaid chart rendering functionality to support drawing flowcharts, sequence diagrams, etc. in posts.
📂 Configuration Item Location
Global -> Mermaid Support
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.global?.is_mermaid_enable
ℹ️ Additional Information
Charts can support light/dark theme switching. For specific usage methods, please see: Mermaid Light/Dark Theme Adaptation
After enabling, you need to configure the following sub-items:
- Mermaid CSS Selector (Default:
.content .mermaid) - Mermaid Config Property (Default:
{ startOnLoad: false })
General Styles
Enable Custom Font Files
🎯 Purpose
Use uploaded custom font files to replace the default fonts.
📂 Configuration Item Location
General Styles -> Enable Custom Font Files
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.styles?.is_custom_font_files_enable
ℹ️ Additional Information
When enabled, you can configure:
Custom Font Files
🎯 Purpose
Used to select uploaded font files to replace the default font files. Supports .woff2/.woff/.ttf/.otf/.eot/.ttc/.otc/.sfnt format font files.
📂 Configuration Item Location
(General Styles -> Enable Custom Font Files When enabled, will display)
General Styles -> Custom Font Files
🏷️ Type
Repeater
🧩 Template Variable
theme.config?.styles?.custom_font_configs
Font Name (Full Name/PostScript Name)
🎯 Purpose
After correctly filling in this option, if the user has this font installed locally, the local version will be used.
If this option is left empty, even if the user has this font installed locally, the local version will not be used, and the font file will be downloaded from the network.
📂 Configuration Item Location
(General Styles -> Enable Custom Font Files When enabled, will display)
General Styles -> Font Name (Full Name/PostScript Name)
🏷️ Type
String
⭐ Default Value
Empty
💡 Example Values
My Custom Font Regular,MyCustomFont-Regular
External Constraints
Corresponds to the "Full font name (nameID=4)" or "PostScript name (nameID=6)" declared inside the font file.
🧩 Template Variable
theme.config?.styles?.custom_font_name
Enable Custom Cursor Files
🎯 Purpose
Replace the default cursor set with uploaded custom cursor files.
📂 Configuration Item Location
Style -> Enable Custom Cursor Files
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.styles?.is_custom_cursor_files_enable
Color Scheme
🎯 Purpose
Set the overall color scheme of the website, supporting multiple built-in themes and custom colors.
📂 Configuration Item Location
General Styles -> Color Scheme
🏷️ Type
Option
⭐ Default Value
Dark - Green(internal value dark)
💡 Other Options
Follow System - Green(internal valueauto)Light - Green(internal valuelight)Follow System - Blue(internal valueauto-blue)Light - Blue(internal valuelight-blue)Dark - Blue(internal valuedark-blue)Light - Gray Pink(internal valuegray)Custom Color Scheme(internal valuecustom)
🧩 Template Variable
theme.config?.styles?.color_schema
ℹ️ Additional Information
- For cases where Light/Dark Mode Toggle Button is enabled, this determines the default color scheme when the website first loads.
- When selecting "Custom Color Scheme", it needs to be used with Custom Color Scheme.
Custom Color Scheme
🎯 Purpose
Set custom color scheme.
📂 Configuration Item Location
General Styles -> Custom Color Scheme
🏷️ Type
Repeater
ℹ️ Additional Information
For usage, please refer to the Tutorial: Custom Color Scheme
⭐ Default Value
📂 Configuration Item Name
Custom Color Scheme Identifier
🏷️ Type
Number
⭐ Default Value
1
ℹ️ Additional Information
Unique identifier, do not duplicate.
📂 Configuration Item Name
Theme Color Mode
🏷️ Type
Option
⭐ Default Value
Dark Mode(internal value dark)
💡 Other Options
Light Mode(internal valuelight)Auto Mode(internal valueauto)
📂 Configuration Item Name
CSS Variable Mode
🏷️ Type
Boolean
⭐ Default Value
false
ℹ️ Additional Information
After enabling this option, CSS variables will be used to define the color scheme.
📂 Configuration Item Name
CSS Raw Output Mode
🏷️ Type
Boolean
⭐ Default Value
false
ℹ️ Additional Information
After disabling this option, you only need to fill in the Custom CSS Variables part. The output will be automatically placed in the corresponding CSS selector (selector is html[theme="theme-{identifier}"]).
📂 Configuration Item Name
Custom CSS Variables
🏷️ Type
Code input box (CSS)
⚠️ External Constraints
When CSS Raw Output Mode is enabled, the content you fill in must be valid CSS code. When CSS Raw Output Mode is disabled, the following content must be valid CSS code:
html[theme="theme-{identifier}"] {
/* Your content here */
}ℹ️ Additional Information
Here are some example CSS variables:
--color-accent: #d480aa
--color-accent-content: #212326
--color-base-100: #212326
--color-base-200: #1c1c1c
--color-base-300: #181818
--color-base-content: #d5d7d8
--color-neutral: #1d1f21
--color-neutral-content: #d5d7d8
--color-primary: #2bbc8a
--color-primary-content: #212326
--color-secondary: #ccffb6
--color-secondary-content: #d5d7d8Here is an example of CSS Raw Output Mode:
html[theme="auto"] {
--color-accent: #d480aa;
--color-accent-content: #212326;
--color-base-100: #fafafa;
--color-base-200: #f5f5f5;
--color-base-300: #e4e4e4;
--color-base-content: #333;
--color-neutral: #1d1f21;
--color-neutral-content: #d5d7d8;
--color-primary: #b32959;
--color-primary-content: #212326;
--color-scrollbar: #aaa;
--color-secondary: #2bbc8a;
--color-secondary-content: #dddbd9;
}
@media (prefers-color-scheme: dark) {
html[theme="theme-1"] {
--color-accent: #d480aa;
--color-accent-content: #212326;
--color-base-100: #212326;
--color-base-200: #1c1c1c;
--color-base-300: #181818;
--color-base-content: #d5d7d8;
--color-neutral: #1d1f21;
--color-neutral-content: #d5d7d8;
--color-primary: #2bbc8a;
--color-primary-content: #212326;
--color-secondary: #ccffb6;
--color-secondary-content: #d5d7d8;
}
}Light/Dark Mode Toggle Button
🎯 Purpose
If this option is enabled, a light/dark mode toggle button will be displayed next to the main title.
Toggle logic: Light Mode -> Dark Mode -> Auto Mode -> Light Mode.
📂 Configuration Item Location
General Styles -> Light/Dark Mode Toggle Button
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.styles?.is_show_color_scheme_toggle_button
ℹ️ Additional Information
Selecting the same "Auto Mode Color Scheme" as "Light Mode Color Scheme" will disable auto mode. Toggle logic will become: Light Mode -> Dark Mode -> Light Mode.
When enabled, you can configure:
Related information:
Auto Mode Color Scheme
🎯 Purpose
Set the color scheme for Auto Mode in the Light/Dark Mode Toggle Button.
📂 Configuration Item Location
(When General Styles -> Light/Dark Mode Toggle Button is enabled, will display)
General Styles -> Auto Mode Color Scheme
🏷️ Type
Option
⭐ Default Value
Follow System - Green(internal value auto)
💡 Other Options
Light - Green(internal valuelight)Dark - Green(internal valuedark)Follow System - Blue(internal valueauto-blue)Light - Blue(internal valuelight-blue)Dark - Blue(internal valuedark-blue)Light - Gray Pink(internal valuegray)Custom Color Scheme(internal valuecustom)
🧩 Template Variable
theme.config?.styles?.theme_auto
ℹ️ Additional Information
When "Custom Color Scheme" is selected, you need to use it with Custom Color Scheme and fill in the Custom Color Scheme identifier.
Light Mode Color Scheme
🎯 Purpose
Set the color scheme for Light Mode in the Light/Dark Mode Toggle Button.
📂 Configuration Item Location
(When General Styles -> Light/Dark Mode Toggle Button is enabled, will display)
General Styles -> Light Mode Color Scheme
🏷️ Type
Option
⭐ Default Value
Light - Green(internal value light)
💡 Other Options
Follow System - Green(internal valueauto)Dark - Green(internal valuedark)Follow System - Blue(internal valueauto-blue)Light - Blue(internal valuelight-blue)Dark - Blue(internal valuedark-blue)Light - Gray Pink(internal valuegray)Custom Color Scheme(internal valuecustom)
🧩 Template Variable
theme.config?.styles?.theme_light
ℹ️ Additional Information
When "Custom Color Scheme" is selected, you need to use it with Custom Color Scheme and fill in the Custom Color Scheme identifier.
Dark Mode Color Scheme
🎯 Purpose
Set the color scheme for Dark Mode in the Light/Dark Mode Toggle Button.
📂 Configuration Item Location
(When General Styles -> Light/Dark Mode Toggle Button is enabled, will display)
General Styles -> Dark Mode Color Scheme
🏷️ Type
Option
⭐ Default Value
Dark - Green(internal value dark)
💡 Other Options
Follow System - Green(internal valueauto)Light - Green(internal valuelight)Follow System - Blue(internal valueauto-blue)Light - Blue(internal valuelight-blue)Dark - Blue(internal valuedark-blue)Light - Gray Pink(internal valuegray)Custom Color Scheme(internal valuecustom)
🧩 Template Variable
theme.config?.styles?.theme_dark
ℹ️ Additional Information
When "Custom Color Scheme" is selected, you need to use it with Custom Color Scheme and fill in the Custom Color Scheme identifier.
Font Size
🎯 Purpose
Set the overall font size of the site.
📂 Configuration Item Location
General Styles -> Font Size
🏷️ Type
Option
⭐ Default Value
Small (internal value small)
💡 Other Options
Regular(internal valuenormal)Large(internal valuelarge)
🧩 Template Variable
theme.config?.styles?.text_size
Custom Content Area Maximum Width
🎯 Purpose
Whether to define the Content Area Maximum Width.
📂 Configuration Item Location
General Styles -> Custom Content Area Maximum Width
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.styles?.is_max_width_settings
ℹ️ Additional Information
If you disable this option, the Content Area Maximum Width will change with the page width, but the content may appear to be left-aligned overall. If you want to disable this option, it is recommended to enable "Content Area Minimum Width" and "Custom Content Area Width Property".
When enabled, you can configure:
Content Area Maximum Width
🎯 Purpose
Set the maximum width of the content area.
📂 Configuration Item Location
(General Styles -> Custom Content Area Maximum Width When enabled, will display)
General Styles -> Content Area Maximum Width
🏷️ Type
String
⭐ Default Value
48rem
💡 Example Values
20rem,300px,30vw
⚠️ External Constraints
Valid CSS length unit.
🧩 Template Variable
theme.config?.styles?.max_width
Custom Content Area Minimum Width
🎯 Purpose
Whether to define Content Area Minimum Width.
📂 Configuration Item Location
General Styles -> Custom Content Area Minimum Width
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.styles?.is_min_width_settings
ℹ️ Additional Information
When the window width is less than the set width, the actual window width will be used to avoid horizontal scrollbars.
When enabled, you can configure:
Content Area Minimum Width
🎯 Purpose
Set the minimum width of the content area.
📂 Configuration Item Location
([General Styles -> Custom Content Area Minimum Width](#custom-Content Area Minimum Width) When enabled, will display)
General Styles -> Content Area Minimum Width
🏷️ Type
String
⭐ Default Value
48rem
💡 Example Values
20rem,300px,30vw
⚠️ External Constraints
Valid CSS length unit.
🧩 Template Variable
theme.config?.styles?.min_width
Force Apply Content Area Minimum Width
🎯 Purpose
Controls whether to force apply Content Area Minimum Width.
📂 Configuration Item Location
([General Styles -> Custom Content Area Minimum Width](#custom-Content Area Minimum Width) When enabled, will display)
General Styles -> Force Apply Content Area Minimum Width
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.styles?.is_force_min_width_settings
ℹ️ Additional Information
- When disabled: When the window width is less than the set minimum width, the actual window width will be used to avoid horizontal scrollbars.
- When enabled: Forces the content display area to be no less than the set minimum width, even if it causes horizontal scrollbars.
Custom Content Area Width Property
🎯 Purpose
Whether to define Content Area Width Property.
📂 Configuration Item Location
General Styles -> Custom Content Area Width Property
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.styles?.is_content_width_style_settings
Content Area Width Style
🎯 Purpose
Determines the content area width style.
📂 Configuration Item Location
([General Styles -> Custom Content Area Width Property](/guide/theme-configuration#CustomContent Area Width Property) When enabled, will display)
General Styles -> Content Area Width Style
🏷️ Type
String
⭐ Default Value
fit-content
💡 Example Values
max-content,min-content
⚠️ External Constraints
Must conform to the requirements specified in the documentation.
🧩 Template Variable
theme.config?.styles?.content_width_style
ℹ️ Additional Information
Default Value effect: Makes the content area width equal to the width of the widest content. (This option actually sets the style value for the width property of the content area)
Header Avatar Display
🎯 Purpose
Controls whether to display avatar in the header.
📂 Configuration Item Location
General Styles -> Header Avatar Display
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.styles?.is_show_header_icon
ℹ️ Additional Information
When enabled, you can configure:
Custom Header Avatar
🎯 Purpose
Used to select an uploaded image as the header avatar. If not set, the default avatar /themes/howiehz-higan/images/logo.{avif,webp,png} will be used.
📂 Configuration Item Location
(Global -> Header Avatar Display When enabled, will display)
General Styles -> Custom Header Avatar
🏷️ Type
Attachment
🧩 Template Variable
theme.config?.styles?.icon
Circular Avatar
🎯 Purpose
Controls whether to force crop the avatar into a circle.
📂 Configuration Item Location
(Global -> Header Avatar Display When enabled, will display)
General Styles -> Circular Avatar
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.styles?.avatar_circle
Grayscale Avatar
🎯 Purpose
Controls whether to force grayscale processing of the avatar.
📂 Configuration Item Location
(Global -> Header Avatar Display When enabled, will display)
General Styles -> Grayscale Avatar
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.styles?.avatar_grayout
Additional Menu Items
🎯 Purpose
Controls whether to display additional menu items in the menu.
📂 Configuration Item Location
General Styles -> Additional Menu Items
🏷️ Type
Repeater
⭐ Default Value
Includes one preset: Search (requires Search Component Plugin).
💡 Example Value
📂 Configuration Item Name
Menu Item Type
🏷️ Type
Option
⭐ Default Value
Search (requires Search Component Plugin) (internal value search)
💡 Other Options
- Random post (internal value
random) - User Account (internal value
user)
🔒 Internal Constraints
Required field
ℹ️ Additional Information
For User Account type:
- When not logged in, the menu displays
Login, and clicking it redirects to/loginpage. - When logged in, the menu displays the username, and clicking it redirects to
/ucpage.
🧩 Template Variable
theme.config?.styles?.extra_menu_items
Display Header Menu
🎯 Purpose
Controls whether to display the header menu.
📂 Configuration Item Location
General Styles -> Display Header Menu
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.styles?.is_show_header_menu
Display Page Numbers
🎯 Purpose
Controls whether to display page numbers.
📂 Configuration Item Location
General Styles -> Display Page Numbers
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.styles?.is_show_page_number
Site Statistics at Page Bottom
🎯 Purpose
Controls whether to display site statistics at the page footer.
📂 Configuration Item Location
General Styles -> Site Statistics at Page Bottom
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.styles?.is_footer_site_stats_show
Statistics Item Settings
🎯 Purpose
Set statistics items.
📂 Configuration Item Location
(Home Page Style -> Site Statistics at Page Bottom When enabled, will display)
General Styles -> Statistics Item Settings
🏷️ Type
Repeater
⭐ Default Value
Includes multiple preset share buttons: Total Views, Total Posts, Total Likes, Total Comments, Total Categories, Total Words (requires API Extension Plugin).
💡 Example Value
📂 Configuration Item Name
Statistics Item
🏷️ Type
Option
⭐ Default Value
Total Views (internal value visit)
💡 Other Options
- Total Posts (internal value
post) - Total Likes (internal value
upvote) - Total Comments (internal value
comment) - Total Categories (internal value
category) - Total Words (internal value
wordcount)
🔒 Internal Constraints
Required field
📂 Configuration Item Name
Multilingual text wrapping number
🏷️ Type
Boolean
⭐ Default Value
true
📂 Configuration Item Name
Icon to the left of text
🏷️ Type
Icon
⭐ Default Value
Empty
Theme Information at Page Bottom
🎯 Purpose
Controls whether to display theme information at the page footer.
📂 Configuration Item Location
General Styles -> Theme Information at Page Bottom
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.styles?.is_footer_theme_info_show
ℹ️ Additional Information
When enabled, you can configure:
Theme Name Displayed in Theme Information at Page Bottom
🎯 Purpose
Set the theme name displayed in the page footer theme information.
📂 Configuration Item Location
(General Styles -> Theme Information at Page Bottom When enabled, will display)
General Styles -> Custom Attribution in Copyright Information
🏷️ Type
Option
⭐ Default Value
Higan Haozi (internal value Higan Haozi)
💡 Other Options
- Higan (internal value
Higan) - 彼岸 (internal value
彼岸)
🧩 Template Variable
theme.config?.styles?.footer_theme_info_theme_name
Halo Version Displayed in Theme Information at Page Bottom
🎯 Purpose
Set the Halo version displayed in the page footer theme information.
📂 Configuration Item Location
(General Styles -> Theme Information at Page Bottom When enabled, will display)
General Styles -> Halo Version Displayed in Theme Information at Page Bottom
🏷️ Type
Option
⭐ Default Value
Halo (internal value Halo)
💡 Other Options
- Halo Pro (internal value
Halo Pro) - Halo Professional Edition (internal value
Halo Professional Edition)
🧩 Template Variable
theme.config?.styles?.footer_theme_info_halo_version_name
Copyright Information at Page Bottom
🎯 Purpose
Controls whether to display copyright information at the page footer.
📂 Configuration Item Location
General Styles -> Copyright Information at Page Bottom
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.styles?.is_footer_copyright_show
ℹ️ Additional Information
When enabled, you can configure:
Custom Attribution in Copyright Information
🎯 Purpose
Set the attribution for copyright information at the page footer.
📂 Configuration Item Location
(General Styles -> Copyright Information at Page Bottom When enabled, will display)
General Styles -> Custom Attribution in Copyright Information
⚡ Quick Jump
/console/theme/settings/styles#:~:text=Custom%20Attribution%20in%20Copyright%20Information🏷️ Type
String
⭐ Default Value
Empty
💡 Example Values
HowieHz
🧩 Template Variable
theme.config?.styles?.footer_copyright_custom_name
Force Footer and Page Numbers at Page Bottom
🎯 Purpose
Controls whether to force the footer and page numbers to the bottom of the page.
📂 Configuration Item Location
General Styles -> Force Footer and Page Numbers at Page Bottom
⚡ Quick Jump
/console/theme/settings/styles#:~:text=Force%20Footer%20and%20Page%20Numbers%20at%20Page%20Bottom🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.styles?.is_footer_force_bottom
Menu at Page Bottom
🎯 Purpose
Controls whether to display the footer menu.
📂 Configuration Item Location
General Styles -> Menu at Page Bottom
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.styles?.is_footer_menu_show
Add Content to Bottom of Page
🎯 Purpose
Controls adding content to the very bottom of the page.
📂 Configuration Item Location
General Styles -> Add Content to Bottom of Page
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.styles?.is_footer_content_show
ℹ️ Additional Information
In Halo CMS backend (Quick Jump), the footer content set there will be displayed above "Theme Information", "Copyright Information", and "Menu at Page Bottom". The footer content filled in here will be displayed below "Menu at Page Bottom", at the very bottom of the page.
When enabled, you can configure:
Content at Bottom of Page
🎯 Purpose
Set the content for the very bottom of the page.
📂 Configuration Item Location
(Home Page Style -> Content at Bottom of Page When enabled, will display)
Home Page Style -> Content at Bottom of Page
🏷️ Type
Code input box (HTML)
⭐ Default Value
Empty
💡 Example Values
That's all!HTML code is also allowed:
<code>Nothing below</code>⚠️ External Constraints
Valid HTML code.
🧩 Template Variable
theme.config?.styles?.footer_content
Multi-language Support for Content at Bottom of Page
🎯 Purpose
Controls whether to enable multilingual support for page bottom content.
📂 Configuration Item Location
(Home Page Style -> Content at Bottom of Page When enabled, will display)
Home Page Style -> Multi-language Support for Content at Bottom of Page
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.styles?.is_18n_footer_content_show
ℹ️ Additional Information
After enabling, please refer to the Multilingual Page Bottom Content Usage Guide for configuration
Custom Multi-language Content at Bottom of Page
🎯 Purpose
Set the multilingual page bottom content.
📂 Configuration Item Location
(Home Page Style -> Content at Bottom of Page When enabled, will display)
Home Page Style -> Custom Multi-language Content at Bottom of Page
⚡ Quick Jump
/console/theme/settings/index_styles#:~:text=Custom%20Multi-language%20Content%20at%20Bottom%20of%20Page🏷️ Type
Repeater
⭐ Default Value
📂 Configuration Item Name
Language Code
🏷️ Type
String
⭐ Default Value
zh
💡 Example Values
zh,zh-CN,zh-Hans,en,en-US
🔒 Internal Constraints
Required field
⚠️ External Constraints
The set value must comply with BCP 47, otherwise it will be invalid.
📂 Configuration Item Name
Page Bottom Content
🏷️ Type
Code input box (HTML)
⭐ Default Value
Empty
💡 Example Values
That's all!HTML code is also allowed:
<code>Nothing below</code>⚠️ External Constraints
Valid HTML code.
🧩 Template Variable
theme.config?.styles?.i18n_footer_content
Add Underline to H3 Headings
🎯 Purpose
When enabled, display underline decoration below third-level headings (h3) to make the headings more prominent.
📂 Configuration Item Location
General Styles -> Add Underline to H3 Headings
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.styles?.is_h3_underline
Preserve Empty Lines in Block Quotes
🎯 Purpose
Preserve empty lines in block quotes; otherwise, empty lines in block quotes will be automatically removed.
📂 Configuration Item Location
General Styles -> Preserve Empty Lines in Block Quotes
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.styles?.is_preserve_empty_lines_in_blockquote
ℹ️ Additional Information
For blockquote syntax, please refer to Writing Style.
Add Quotation Mark Before Block Quote
🎯 Purpose
Add quotation mark before block quote.
📂 Configuration Item Location
General Styles -> Add Quotation Mark Before Block Quote
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.styles?.is_show_the_quote_before_blockquote
Add Quotation Mark After Block Quote
🎯 Purpose
Add quotation mark after block quote.
📂 Configuration Item Location
General Styles -> Add Quotation Mark After Block Quote
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.styles?.is_show_the_quote_after_blockquote
Table Row Lines (Excluding Header)
🎯 Purpose
Whether to add table lines at the bottom of each table row (except header).
📂 Configuration Item Location
General Styles -> Table Row Lines (Excluding Header)
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.styles?.is_show_the_table_bottom_border
Table Row Line Width (Excluding Header)
🎯 Purpose
Set the width of table lines added at the bottom of each table row (except header).
📂 Configuration Item Location
(General Styles -> Table Row Lines (Except Header) When enabled, will display)
General Styles -> Table Row Line Width (Excluding Header)
🏷️ Type
String
⭐ Default Value
8px
💡 Example Values
0px,5px,10%,1rem
⚠️ External Constraints
Valid CSS length unit.
🧩 Template Variable
theme.config?.styles?.table_bottom_border_width
Heading Top Margin Multiplier
🎯 Purpose
Set the top margin (margin-top) multiplier for headings.
📂 Configuration Item Location
General Styles -> Heading Top Margin Multiplier
🏷️ Type
Float/Integer
⭐ Default Value
1
💡 Example Values
0.5,1,1.5,2
🔒 Internal Constraints
Value range is 0-5
🧩 Template Variable
theme.config?.styles?.heading_margin_top_multiplier
ℹ️ Additional Information
A value of 1 means use default margin, less than 1 reduces margin, greater than 1 increases margin.
Heading Bottom Margin Multiplier
🎯 Purpose
Set the bottom margin (margin-bottom) multiplier for headings.
📂 Configuration Item Location
General Styles -> Heading Bottom Margin Multiplier
🏷️ Type
Float/Integer
⭐ Default Value
1
💡 Example Values
0.5,1,1.5,2
🔒 Internal Constraints
Value range is 0-5
🧩 Template Variable
theme.config?.styles?.heading_margin_bottom_multiplier
Paragraph Top Margin Multiplier
🎯 Purpose
Set the top margin multiplier for paragraphs.
📂 Configuration Item Location
General Styles -> Paragraph Top Margin Multiplier
🏷️ Type
Float/Integer
⭐ Default Value
1
💡 Example Values
0.5,1,1.5,2
🔒 Internal Constraints
Value range is 0-5
🧩 Template Variable
theme.config?.styles?.paragraph_margin_top_multiplier
Paragraph Bottom Margin Multiplier
🎯 Purpose
Set the bottom margin multiplier for paragraphs.
📂 Configuration Item Location
General Styles -> Paragraph Bottom Margin Multiplier
🏷️ Type
Float/Integer
⭐ Default Value
1
💡 Example Values
0.5,1,1.5,2
🔒 Internal Constraints
Value range is 0-5
🧩 Template Variable
theme.config?.styles?.paragraph_margin_bottom_multiplier
Home Page Style
Application Range: /(page/{page}).
Homepage HTML Title
🎯 Purpose
Customize the HTML title for the homepage (will be displayed in the browser tab).
📂 Configuration Item Location
Home Page Style -> Homepage HTML Title
🏷️ Type
String
⭐ Default Value
Empty
⚠️ External Constraints
If the configuration value is too long, it may affect SEO and page display effects.
🧩 Template Variable
theme.config?.index_styles?.page_html_title
ℹ️ Additional Information
If left empty, the value will be taken from Halo CMS backend (Quick Jump) site title setting.
Hitokoto (One Quote)
🎯 Purpose
Whether to display content from the Hitokoto random sentence service on the homepage.
📂 Configuration Item Location
Home Page Style -> Hitokoto (One Quote)
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.index_styles?.hitokoto
ℹ️ Additional Information
When enabled, you can configure
- Hitokoto service link:
- Default Value:
https://v1.hitokoto.cn/?encode=js - Additional notes: Related information can be obtained by reading the documentation
- Default Value:
Custom Random Display Quote
🎯 Purpose
Whether to randomly display a sentence on the homepage.
📂 Configuration Item Location
Home Page Style -> Custom Random Display Quote
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.index_styles?.is_random_sentence_show
ℹ️ Additional Information
When enabled, you can configure
- Custom sentence content
Personal Profile/Announcement
🎯 Purpose
Display personal profile or announcement content on the homepage.
📂 Configuration Item Location
Home Page Style -> Personal Profile/Announcement
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.index_styles?.is_resume_show
ℹ️ Additional Information
When enabled, you can configure
- Personal Profile/Announcement Content
- Multilingual Personal Profile/Announcement Support
- Custom multilingual announcement content
Multi-language Personal Profile/Announcement Support
🎯 Purpose
Controls whether to enable multilingual personal profile/announcement support.
📂 Configuration Item Location
(Home Page Style -> Personal Profile/Announcement When enabled, will display)
Home Page Style -> Multi-language Personal Profile/Announcement Support
⚡ Quick Jump
/console/theme/settings/index_styles#:~:text=Multi-language%20personal%20profile/announcement%20support🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.index_styles?.is_i18n_resume_show
ℹ️ Additional Information
After enabling, please refer to the Multilingual Personal Profile/Announcement Usage Guide for configuration
Custom Multi-language Announcement Content
🎯 Purpose
Set multilingual announcement content.
📂 Configuration Item Location
(Home Page Style -> Personal Profile/Announcement When enabled, will display)
Home Page Style -> Custom Multi-language Announcement Content
🏷️ Type
Repeater
⭐ Default Value
📂 Configuration Item Name
Language Code
🏷️ Type
String
⭐ Default Value
zh
💡 Example Values
zh,zh-CN,zh-Hans,en,en-US
🔒 Internal Constraints
Required field
⚠️ External Constraints
The set value must comply with BCP 47, otherwise it will be invalid.
📂 Configuration Item Name
Personal Profile/Announcement Content
🏷️ Type
Code input box (HTML)
⭐ Default Value
Empty
💡 Example Values
Welcome everyone to visit this site!HTML code is also allowed:
<code>Supports HTML code</code>⚠️ External Constraints
Valid HTML code.
🧩 Template Variable
theme.config?.index_styles?.i18n_resume
Display Text on the Left Side of Social Media Icons
🎯 Purpose
Controls whether to display text to the left of social profile icons on the homepage.
📂 Configuration Item Location
Home Page Style -> Display Text on the Left Side of Social Media Icons
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.index_styles?.is_show_find_me_left_text
Home Page Post List Title
🎯 Purpose
Controls whether to display the title of the homepage post list.
📂 Configuration Item Location
Home Page Style -> Home Page Post List Title
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.index_styles?.is_show_index_post_list_title
Home Page List Layout
🎯 Purpose
Select the display style for the homepage post list.
📂 Configuration Item Location
Home Page Style -> Home Page List Layout
🏷️ Type
Option
⭐ Default Value
Simple Post List (internal value simple-post-list)
💡 Other Options
Multi-element Post List(internal valuepost-list-summary)Moments List(internal valuemoment-list-summary)Friends List(internal valuefriends-list-summary)
🧩 Template Variable
theme.config?.index_styles?.list_layout
ℹ️ Additional Information
- "Moments List" requires the Moments plugin to be enabled.
- "Friends List" requires the Friends plugin to be enabled.
Different configuration options will be displayed based on the selected layout type.
When Simple List is enabled, you can configure
When Multi-element List is enabled, you can configure
- Display Publish Date in Post List Summary
- Display Post Categories in Post List Summary
- Display Post Tags in Post List Summary
- Display Post Views in Post List Summary
- Display Post Estimated Reading Time in Post List Summary
- Display Post Word Count in Post List Summary
- Display Post Excerpt in Post List Summary
- Maximum Lines for Post Excerpt in Post List Summary
- Link Text for Post List Summary
- Display Post Cover in Post List Summary
When Moments List is enabled, you can configure
- Number of Moments Per Page
- Show Author Avatar in Moment List
- Show Author Nickname in Moment List
- Show Post Publication Date in Moment List
- Show Estimated Reading Time in Moment List
- Show Word Count in Moment List
- Enable Upvote Button in Moment List
- Enable Comment Section in Moment List
When Friends List is enabled, you can configure
Display Publish Date in Simple List
🎯 Purpose
Controls whether to display the publication date of posts in the simple list.
📂 Configuration Item Location
(Home Page Style -> Home Page List Layout Displayed when set to "Simple Post List")
Home Page Style -> Display Publish Date in Simple List
⚡ Quick Jump
/console/theme/settings/index_styles#:~:text=Display%20publish%20date%20in%20simple%20post%20list🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.index_styles?.is_show_post_pubdate_in_simple_post_list
Display Post Views in Simple List
🎯 Purpose
Controls whether to display post view count in the simple list.
📂 Configuration Item Location
(Home Page Style -> Home Page List Layout Displayed when set to "Simple Post List")
Home Page Style -> Display Post Views in Simple List
⚡ Quick Jump
/console/theme/settings/index_styles#:~:text=Display%20Post%20Views%20in%20Simple%20List🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.index_styles?.is_show_post_views_in_simple_post_list
Display Publish Date in Post List Summary
🎯 Purpose
Controls whether to display the publication date of posts in the post list summary.
📂 Configuration Item Location
(Home Page Style -> Home Page List Layout Displayed when set to "Rich Post List")
Home Page Style -> Display Publish Date in Post List Summary
⚡ Quick Jump
/console/theme/settings/index_styles#:~:text=Display%20publish%20date%20in%20post%20list%20summary🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.index_styles?.is_show_post_pubdate_in_post_list_summary
Display Post Categories in Post List Summary
🎯 Purpose
Controls whether to display post categories in the multi-element list.
📂 Configuration Item Location
(Home Page Style -> Home Page List Layout Displayed when set to "Multi-element Post List")
Home Page Style -> Display Post Categories in Post List Summary
⚡ Quick Jump
/console/theme/settings/index_styles#:~:text=Display%20Post%20Categories%20in%20Post%20List%20Summary🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.index_styles?.is_show_post_categories_in_post_list_summary
Display Post Tags in Post List Summary
🎯 Purpose
Controls whether to display post tags in the multi-element list.
📂 Configuration Item Location
(Home Page Style -> Home Page List Layout Displayed when set to "Multi-element Post List")
Home Page Style -> Display Post Tags in Post List Summary
⚡ Quick Jump
/console/theme/settings/index_styles#:~:text=Display%20Post%20Tags%20in%20Post%20List%20Summary🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.index_styles?.is_show_post_tags_in_post_list_summary
Display Post Views in Post List Summary
🎯 Purpose
Controls whether to display post view count in the multi-element list.
📂 Configuration Item Location
(Home Page Style -> Home Page List Layout Displayed when set to "Multi-element Post List")
Home Page Style -> Display Post Views in Post List Summary
⚡ Quick Jump
/console/theme/settings/index_styles#:~:text=Display%20Post%20Views%20in%20Post%20List%20Summary🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.index_styles?.is_show_post_views_in_post_list_summary
Display Post Estimated Reading Time in Post List Summary
🎯 Purpose
Controls whether to display estimated reading time in the multi-element list.
📂 Configuration Item Location
(Home Page Style -> Home Page List Layout Displayed when set to "Multi-element Post List")
Home Page Style -> Display Post Estimated Reading Time in Post List Summary
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.index_styles?.is_show_post_estimated_reading_time_in_post_list_summary
ℹ️ Additional Information
After enabling the API Extension plugin, a more accurate measurement method will be automatically enabled.
Display Post Word Count in Post List Summary
🎯 Purpose
Controls whether to display post word count in the multi-element list.
📂 Configuration Item Location
(Home Page Style -> Home Page List Layout Displayed when set to "Multi-element Post List")
Home Page Style -> Display Post Word Count in Post List Summary
⚡ Quick Jump
/console/theme/settings/index_styles#:~:text=Display%20post%20word%20count%20in%20post%20list%20summary🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.index_styles?.is_show_post_word_count_in_post_list_summary
ℹ️ Additional Information
After enabling the API Extension plugin, a more accurate measurement method will be automatically enabled.
Display Post Excerpt in Post List Summary
🎯 Purpose
Controls whether to display post excerpt in the multi-element list.
📂 Configuration Item Location
(Home Page Style -> Home Page List Layout Displayed when set to "Multi-element Post List")
Home Page Style -> Display Post Excerpt in Post List Summary
⚡ Quick Jump
/console/theme/settings/index_styles#:~:text=Display%20post%20excerpt%20in%20post%20list%20summary🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.index_styles?.is_show_post_excerpt_in_post_list_summary
Maximum Lines for Post Excerpt in Post List Summary
🎯 Purpose
Set the maximum number of lines for post excerpt in the multi-element list.
📂 Configuration Item Location
(Home Page Style -> Home Page List Layout Displayed when set to "Multi-element Post List")
Home Page Style -> Maximum Lines for Post Excerpt in Post List Summary
🏷️ Type
Integer
⭐ Default Value
3
🔒 Internal Constraints
Range 1-5
🧩 Template Variable
theme.config?.index_styles?.post_excerpt_max_lines
Link Text for Post List Summary
🎯 Purpose
Controls whether to display the prompt text for the post link in the multi-element list.
📂 Configuration Item Location
(Home Page Style -> Home Page List Layout Displayed when set to "Multi-element Post List")
Home Page Style -> Link Text for Post List Summary
⚡ Quick Jump
/console/theme/settings/index_styles#:~:text=Display%20the%20text%20of%20the%20post%20list%20permalink🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.index_styles?.is_show_index_post_list_permalink_text
ℹ️ Additional Information
If this option is disabled, the post items in the homepage post list will not display the link text
Display Post Cover in Post List Summary
🎯 Purpose
Controls whether to display post cover in the multi-element list.
📂 Configuration Item Location
(Home Page Style -> Home Page List Layout Displayed when set to "Multi-element Post List")
Home Page Style -> Display Post Cover in Post List Summary
⚡ Quick Jump
/console/theme/settings/index_styles#:~:text=Display%20Post%20Cover%20in%20Post%20List%20Summary🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.index_styles?.is_show_post_cover_in_post_list_summary
Number of Moments Per Page
🎯 Purpose
Set the number of items displayed in the moments list.
📂 Configuration Item Location
(Home Page Style -> Home Page List Layout Displayed when set to "Moments List")
Home Page Style -> Number of Moments Per Page
🏷️ Type
Integer
⭐ Default Value
10
🧩 Template Variable
theme.config?.index_styles?.moment_list_page_size
Show Author Avatar in Moment List
🎯 Purpose
Controls whether to display the author avatar in the moments list.
📂 Configuration Item Location
(Home Page Style -> Home Page List Layout Displayed when set to "Moments List")
Home Page Style -> Show Author Avatar in Moment List
⚡ Quick Jump
/console/theme/settings/index_styles#:~:text=Show%20Author%20Avatar%20in%20Moment%20List🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.index_styles?.is_show_moment_avatar
Show Author Nickname in Moment List
🎯 Purpose
Controls whether to display the author nickname in the moments list.
📂 Configuration Item Location
(Home Page Style -> Home Page List Layout Displayed when set to "Moments List")
Home Page Style -> Show Author Nickname in Moment List
⚡ Quick Jump
/console/theme/settings/index_styles#:~:text=Show%20Author%20Nickname%20in%20Moment%20List🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.index_styles?.is_show_moment_nickname
Show Post Publication Date in Moment List
🎯 Purpose
Control whether to display the post publication date in the moment list.
📂 Configuration Item Location
(Displayed when Home Page Style -> Home Page List Layout is set to "Moment List")
Home Page Style -> Show Post Publication Date in Moment List
⚡ Quick Jump
/console/theme/settings/index_styles#:~:text=Show%20Post%20Publication%20Date%20in%20Moment%20List🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.index_styles?.is_show_moment_pubdate
Show Estimated Reading Time in Moment List
🎯 Purpose
Control whether to display the estimated reading time in the moment list.
📂 Configuration Item Location
(Displayed when Home Page Style -> Home Page List Layout is set to "Moment List")
Home Page Style -> Show Estimated Reading Time in Moment List
⚡ Quick Jump
/console/theme/settings/index_styles#:~:text=Show%20Estimated%20Reading%20Time%20in%20Moment%20List🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.index_styles?.is_show_moment_estimated_reading_time
ℹ️ Additional Information
After enabling the API Extension plugin, a more accurate measurement method will be automatically enabled.
Show Word Count in Moment List
🎯 Purpose
Control whether to display the word count in the moment list.
📂 Configuration Item Location
(Displayed when Home Page Style -> Home Page List Layout is set to "Moment List")
Home Page Style -> Show Word Count in Moment List
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.index_styles?.is_show_moment_word_count
ℹ️ Additional Information
After enabling the API Extension plugin, a more accurate measurement method will be automatically enabled.
Enable Upvote Button in Moment List
🎯 Purpose
Control whether to enable the upvote button in the moment list.
📂 Configuration Item Location
(Displayed when Home Page Style -> Home Page List Layout is set to "Moment List")
Home Page Style -> Enable Upvote Button in Moment List
⚡ Quick Jump
/console/theme/settings/index_styles#:~:text=Enable%20Upvote%20Button%20in%20Moment%20List🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.index_styles?.is_moment_upvote_button_show
Enable Comment Section in Moment List
🎯 Purpose
Control whether to enable the comment section in the moment list.
📂 Configuration Item Location
(Displayed when Home Page Style -> Home Page List Layout is set to "Moment List")
Home Page Style -> Enable Comment Section in Moment List
⚡ Quick Jump
/console/theme/settings/index_styles#:~:text=Enable%20Comment%20Section%20in%20Moment%20List🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.index_styles?.is_moment_comment_section_show
Number of Friends Per Page
🎯 Purpose
Set the number of friends posts to display per page on the homepage.
📂 Configuration Item Location
(Shown when Home Page Style -> Home Page List Layout is set to "Friends List")
Home Page Style -> Number of items to display in friends list
⚡ Quick Jump
/console/theme/settings/index_styles#:~:text=Number%20of%20items%20to%20display%20in%20friends%20list🏷️ Type
Number
⭐ Default Value
10
🧩 Template Variable
theme.config?.index_styles?.friends_list_page_size
Show Publish Date in Friends List
🎯 Purpose
Controls whether to display the publication date of posts in the friends list.
📂 Configuration Item Location
(Shown when Home Page Style -> Home Page List Layout is set to "Friends List")
Home Page Style -> Show publish date in friends list
⚡ Quick Jump
/console/theme/settings/index_styles#:~:text=Show%20publish%20date%20in%20friends%20list🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.index_styles?.is_show_friend_pubdate
Show Author Information in Friends List
🎯 Purpose
Controls whether to display author information (including avatar and name) in the friends list.
📂 Configuration Item Location
(Shown when Home Page Style -> Home Page List Layout is set to "Friends List")
Home Page Style -> Show author information in friends list
⚡ Quick Jump
/console/theme/settings/index_styles#:~:text=Show%20author%20information%20in%20friends%20list🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.index_styles?.is_show_friend_author
Show Author Avatar in Friends List
🎯 Purpose
Controls whether to display the author avatar in the friends list.
📂 Configuration Item Location
(Shown when Home Page Style -> Home Page List Layout is set to "Friends List" and Show Author Information in Friends List is enabled)
Home Page Style -> Show author avatar in friends list
⚡ Quick Jump
/console/theme/settings/index_styles#:~:text=Show%20author%20avatar%20in%20friends%20list🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.index_styles?.is_show_friend_author_avatar
Show Author Name in Friends List
🎯 Purpose
Controls whether to display the author name in the friends list.
📂 Configuration Item Location
(Shown when Home Page Style -> Home Page List Layout is set to "Friends List" and Show Author Information in Friends List is enabled)
Home Page Style -> Show author name in friends list
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.index_styles?.is_show_friend_author_name
Show Post Description in Friends List
🎯 Purpose
Controls whether to display post descriptions in the friends list.
📂 Configuration Item Location
(Shown when Home Page Style -> Home Page List Layout is set to "Friends List")
Home Page Style -> Show post description in friends list
⚡ Quick Jump
/console/theme/settings/index_styles#:~:text=Show%20post%20description%20in%20friends%20list🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.index_styles?.is_show_friend_description
Maximum Lines for Post Description in Friends List
🎯 Purpose
Set the maximum number of lines for post descriptions in the friends list.
📂 Configuration Item Location
(Shown when Home Page Style -> Home Page List Layout is set to "Friends List" and Show Post Description in Friends List is enabled)
Home Page Style -> Maximum lines for post description in friends list
🏷️ Type
Number (1-5)
⭐ Default Value
3
🧩 Template Variable
theme.config?.index_styles?.friend_description_max_lines
Show Link Text in Friends List
🎯 Purpose
Controls whether to display the link text in friends list posts.
📂 Configuration Item Location
(Shown when Home Page Style -> Home Page List Layout is set to "Friends List")
Home Page Style -> Show link text in friends list
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.index_styles?.is_show_friend_permalink_text
Top Icon Display on Post List
🎯 Purpose
Display a special icon for pinned posts in the post list.
📂 Configuration Item Location
Home Page Style -> Top Icon Display on Post List
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.index_styles?.is_pin_icon_show
ℹ️ Additional Information
When enabled, you can configure
- Position of the pinned icon (left or right of the title), default is right.
Post Page Style
Application Range: /archives/{slug}.
Optimize Post Paragraph Spacing Display
🎯 Purpose
Add minimum height to post content paragraphs to display empty lines.
📂 Configuration Item Location
Post Page Style -> Optimize Post Paragraph Empty Line Display
⚡ Quick Jump
/console/theme/settings/post_styles#:~:text=Optimize%20Post%20Paragraph%20Spacing%20Display🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.post_styles?.is_optimize_content_paragraph_spacing
ℹ️ Additional Information
Different Markdown editors use different parsers, so this configuration item may have different effects on the final rendering result. Related link: babelmark3 is a website that compares the parsing results of different Markdown parsers.
Document Paragraph First-line Indent
🎯 Purpose
Add indentation style to the first line of post content paragraphs.
📂 Configuration Item Location
Post Page Style -> Paragraph First-line Indent
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.post_styles?.is_enable_paragraph_first_line_indent
ℹ️ Additional Information
When enabled, you can configure
- First line indentation value
- Type: String
- Default Value:
2em(2 character width) - External constraints: CSS length units. Such as: 20rem, 300px, 30vw.
Post Title Uppercase
🎯 Purpose
Convert characters in post titles to uppercase.
Such as: a converts to A.
📂 Configuration Item Location
Post Page Style -> Post Title Uppercase
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.post_styles?.post_title_uppper
Post Publish Time
🎯 Purpose
Display the post publication time at the top of the post page.
📂 Configuration Item Location
Post Page Style -> Post Publication Time
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.post_styles?.is_show_post_publish_time
ℹ️ Additional Information
When enabled, you can configure
- Text to the left of post publication time
Post Update Time
🎯 Purpose
Display the post last update time at the top of the post page.
📂 Configuration Item Location
Post Page Style -> Post Update Time
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.post_styles?.is_show_post_updated_time
ℹ️ Additional Information
When enabled, you can configure
- Text to the left of post update time
Show Post Views
🎯 Purpose
Display post view count statistics on the post page.
📂 Configuration Item Location
Post Page Style -> Post View Count
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.post_styles?.is_show_post_views
Show Estimated Reading Time of Post
🎯 Purpose
Display estimated reading time based on post word count on the post page.
📂 Configuration Item Location
Post Page Style -> Post Estimated Reading Time
⚡ Quick Jump
/console/theme/settings/post_styles#:~:text=Show%20Estimated%20Reading%20Time%20of%20Post🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.post_styles?.is_show_post_estimated_reading_time
ℹ️ Additional Information
After enabling the API Extension plugin, a more accurate measurement method will be automatically enabled.
Show Post Word Count
🎯 Purpose
Display the total word count of the post on the post page.
📂 Configuration Item Location
Post Page Style -> Post Word Count
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.post_styles?.is_show_post_word_count
ℹ️ Additional Information
After enabling the API Extension plugin, a more accurate measurement method will be automatically enabled.
Share Button in Desktop Menu
🎯 Purpose
Controls whether to display the share button in the menu on the desktop post page.
📂 Configuration Item Location
Post Page Style -> Share Button in Desktop Menu
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.post_styles?.is_show_post_nav_share_button
Custom Sidebar Table of Contents Maximum Width
🎯 Purpose
When enabled, you can configure
- Maximum width of the sidebar table of contents on the post page.
📂 Configuration Item Location
Post Page Style -> Custom Sidebar Table of Contents Maximum Width
⚡ Quick Jump
/console/theme/settings/post_styles#:~:text=Custom%20Sidebar%20Table%20of%20Contents%20Maximum%20Width🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.post_styles?.is_custom_toc_max_width
ℹ️ Additional Information
When enabled, you can configure
- Sidebar Table of Contents Maximum Width
- Type: String
- Default Value:
20rem - External constraints: CSS length units. Such as: 20rem, 300px, 30vw.
Enable Dividing Line at End of Post
🎯 Purpose
Controls whether to display the separator at the end of the post.
📂 Configuration Item Location
Post Page Style -> Post End Separator
⚡ Quick Jump
/console/theme/settings/post_styles#:~:text=Enable%20dividing%20line%20at%20the%20end%20of%20the%20post🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.post_styles?.is_dividing_line_at_the_end_of_post_show
Upvote Button at Bottom of Post
🎯 Purpose
Controls whether to display the like button at the bottom of the post.
📂 Configuration Item Location
Post Page Style -> Post Bottom Like Button
⚡ Quick Jump
/console/theme/settings/post_styles#:~:text=Upvote%20button%20at%20the%20bottom%20of%20the%20post🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.post_styles?.is_post_upvote_button_show
ℹ️ Additional Information
When enabled, you can configure
- Like button width
- Type: String
- Default Value:
1rem - External constraints: CSS length units. Such as: 20rem, 300px, 30vw.
- Like button height
- Type: String
- Default Value:
1rem - External constraints: CSS length units. Such as: 20rem, 300px, 30vw.
- Display post like count
- Like button position
Recommended Articles at Bottom of Post
🎯 Purpose
Controls whether to display recommended post list at the bottom of the post.
Principle: Reads the first category of the current post and randomly outputs some posts from it.
📂 Configuration Item Location
Post Page Style -> Recommended Posts at Post Bottom
⚡ Quick Jump
/console/theme/settings/post_styles#:~:text=Recommended%20articles%20at%20the%20bottom%20of%20the%20post🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.post_styles?.is_post_recommended_articles_show
ℹ️ Additional Information
If the current post is in the random list it will be excluded, so the actual number of recommended posts may be less than the set "Recommended Post Count".
If the current post has no category set, this feature will be disabled.
If the category has only one post, this feature will be disabled.
When enabled, you can configure
- Recommended post count
Adjacent Article Navigation at Bottom of Post
🎯 Purpose
When enabled, navigation links to the previous and next posts will be displayed at the bottom of the post.
📂 Configuration Item Location
Post Page Style -> Adjacent Post Navigation at Post Bottom
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.post_styles?.is_post_prev_next_navigation_show
Post Comment Section
🎯 Purpose
Controls whether to display the comment section on the post page.
📂 Configuration Item Location
Post Page Style -> Post Comment Section
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.post_styles?.is_post_comment_section_show
Mobile Bottom Navigation Bar
🎯 Purpose
Controls whether to display the navigation bar at the bottom of the mobile post page.
📂 Configuration Item Location
Post Page Style -> Mobile Bottom Navigation Bar
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.post_styles?.is_show_footer_nav
ℹ️ Additional Information
When enabled, you can configure
- Share buttons in mobile bottom navigation bar
Categories Page Style
Application Range: /categories.
Category Page Description
🎯 Purpose
Used to customize the HTML <meta name="description"> content for this page, convenient for setting SEO descriptions.
📂 Configuration Item Location
Categories Page Style -> Page Description
⚡ Quick Jump
/console/theme/settings/categories_page_styles#:~:text=Page%20description%20(meta%20description)🏷️ Type
String
⭐ Default Value
Empty
🧩 Template Variable
theme.config?.categories_page_styles?.description
ℹ️ Additional Information
If left empty, will fall back to site description (Quick Jump: /console/settings?tab=seo#:~:text=Site%20description)
Display Number of Posts Per Category
🎯 Purpose
Controls whether to display the number of posts in each category in the category list.
📂 Configuration Item Location
Categories Page Style -> Display Number of Posts Per Category
⚡ Quick Jump
/console/theme/settings/categories_page_styles#:~:text=Display%20Number%20of%20Posts%20Per%20Category🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.categories_page_styles?.is_show_the_number_of_articles_per_category
ℹ️ Additional Information
When enabled, you can configure
- Character to the left of post count
- Type: String
- Default Value:
(
- Character to the right of post count
- Type: String
- Default Value:
)
Display Multi-layer Categories
🎯 Purpose
Controls whether to display subcategories on the category page.
📂 Configuration Item Location
Categories Page Style -> Display Multi-layer Categories
⚡ Quick Jump
/console/theme/settings/categories_page_styles#:~:text=Display%20multi-layer%20categories🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.categories_page_styles?.is_show_multi_layer_categories
Category Detail Page Style
Application Range: /categories/{slug}.
Show Category RSS Subscription Button
🎯 Purpose
Display RSS subscription button on the category detail page.
📂 Configuration Item Location
Category Detail Page Style -> Category RSS Subscription Button
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.category_page_styles?.is_show_rss_button
⚠️ External Constraints
Requires the RSS Subscription Plugin to be enabled.
Display Post Publish Date in Category Details Page Post List
🎯 Purpose
Display the post publish date in the post list on the category detail page.
📂 Configuration Item Location
Category Detail Page Style -> Display Post Publish Date in Post List
⚡ Quick Jump
/console/theme/settings/category_page_styles#:~:text=Display%20post%20publish%20date%20in%20post%20list🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.category_page_styles?.is_show_post_pubdate_in_post_list
Display Post Views in Category Details Page Post List
🎯 Purpose
Display post view count on the category detail page.
📂 Configuration Item Location
Category Detail Page Style -> Display Post View Count in Post List
⚡ Quick Jump
/console/theme/settings/category_page_styles#:~:text=Display%20post%20views%20in%20post%20list🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.category_page_styles?.is_show_post_views_in_post_list
Tags Page Style
Application Range: /tags.
Tag Collection Page Description
🎯 Purpose
Used to customize the HTML <meta name="description"> content for this page, convenient for setting SEO descriptions.
📂 Configuration Item Location
Tags Page Style -> Page Description
⚡ Quick Jump
/console/theme/settings/tags_page_styles#:~:text=Page%20description%20(meta%20description)🏷️ Type
String
⭐ Default Value
Empty
🧩 Template Variable
theme.config?.tags_page_styles?.description
ℹ️ Additional Information
If left empty, will fall back to site description (Quick Jump: /console/settings?tab=seo#:~:text=Site%20description)
Display Number of Posts Per Tag
🎯 Purpose
Controls whether to display the number of posts in each tag in the tag list.
📂 Configuration Item Location
Tags Page Style -> Display Number of Posts Per Tag
⚡ Quick Jump
/console/theme/settings/tags_page_styles#:~:text=Display%20Number%20of%20Posts%20Per%20Tag🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.tags_page_styles?.is_show_the_number_of_posts_per_tag
ℹ️ Additional Information
When enabled, you can configure
- Character to the left of post count
- Type: String
- Default Value:
(
- Character to the right of post count
- Type: String
- Default Value:
):::
Tag Sort Order
🎯 Purpose
Set the sorting method for tags on the tag collection page.
📂 Configuration Item Location
Tags Page Style -> Tag Sort Order
🏷️ Type
Option
⭐ Default Value
Default (internal value default)
💡 Other Options
- By post count descending (internal value
count_desc) - By post count ascending (internal value
count_asc) - By name ascending (internal value
name_asc) - By name descending (internal value
name_desc)
🧩 Template Variable
theme.config?.tags_page_styles?.tags_sort_order
Tag Detail Page Style
Application Range: /tags/{slug}.
Show Tag RSS Subscription Button
🎯 Purpose
Display RSS subscription button on the tag detail page.
📂 Configuration Item Location
Tag Detail Page Style -> Display Tag RSS Subscription Button
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.tag_page_styles?.is_show_rss_button
⚠️ External Constraints
Requires the RSS Subscription Plugin to be enabled.
Display Post Publish Date in Tag Details Page Post List
🎯 Purpose
Display post publication date in the post list on the tag detail page.
📂 Configuration Item Location
Tag Detail Page Style -> Display post publish date in post list
⚡ Quick Jump
/console/theme/settings/tag_page_styles#:~:text=Display%20post%20publish%20date%20in%20post%20list🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.tag_page_styles?.is_show_post_pubdate_in_post_list
Display Post Views in Tag Details Page Post List
🎯 Purpose
Display post view count on the tag detail page.
📂 Configuration Item Location
Tag Detail Page Style -> Display Post View Count in Post List
⚡ Quick Jump
/console/theme/settings/tag_page_styles#:~:text=Display%20post%20views%20in%20post%20list🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.tag_page_styles?.is_show_post_views_in_post_list
Author Detail Page Style
Application Range: /authors/{name}.
Author Details Page Description
🎯 Purpose
Used to customize the HTML <meta name="description"> content for this page, convenient for setting SEO descriptions.
📂 Configuration Item Location
Author Detail Page Style -> Page Description
⚡ Quick Jump
/console/theme/settings/author_page_styles#:~:text=Page%20description%20(meta%20description)🏷️ Type
String
⭐ Default Value
Empty
🧩 Template Variable
theme.config?.author_page_styles?.description
ℹ️ Additional Information
If left empty, will fall back to site description (Quick Jump: /console/settings?tab=seo#:~:text=Site%20description)
Show Author RSS Subscription Button
🎯 Purpose
Display RSS subscription button on the author detail page.
📂 Configuration Item Location
Author Detail Page Style -> Show Author RSS Subscription Button
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.author_page_styles?.is_show_rss_button
⚠️ External Constraints
Requires the RSS Subscription Plugin to be enabled.
Display Post Publish Date in Author Detail Page Post List
🎯 Purpose
Display post publish date in the post list on the author detail page.
📂 Configuration Item Location
Author Detail Page Style -> Display post publish date in post list
⚡ Quick Jump
/console/theme/settings/author_page_styles#:~:text=Display%20post%20publish%20date%20in%20post%20list🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.author_page_styles?.is_show_post_pubdate_in_post_list
Archives Page Style
Application Range: /archives(/{year}(/{month})).
Archives Page Description
🎯 Purpose
Used to customize the HTML <meta name="description"> content for this page, convenient for setting SEO descriptions.
📂 Configuration Item Location
Archives Page Style -> Page Description
⚡ Quick Jump
/console/theme/settings/archives_page_styles#:~:text=Page%20description%20(meta%20description)🏷️ Type
String
⭐ Default Value
Empty
🧩 Template Variable
theme.config?.archives_page_styles?.description
ℹ️ Additional Information
If left empty, will fall back to site description (Quick Jump: /console/settings?tab=seo#:~:text=Site%20description)
Display Post Publish Date in Archives Page Post List
🎯 Purpose
Display the post publish date in the post list on the archives page.
📂 Configuration Item Location
Archives Page Style -> Display Post Publish Date in Post List
⚡ Quick Jump
/console/theme/settings/archives_page_styles#:~:text=Display%20post%20publish%20date%20in%20post%20list🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.archives_page_styles?.is_show_post_pubdate_in_post_list
Collapse Post List by Publication Year and Month
🎯 Purpose
In the archive page, collapse and display the post list by year and month of post publication.
📂 Configuration Item Location
Archives Page Style -> Collapse Post List by Publication Year and Month
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.archives_page_styles?.is_collapse_post_list_by_publication_year_and_month
ℹ️ Additional Information
When enabled, you can configure
- Expand/collapse animation duration (Unit: milliseconds)
- Type: Float/Integer
- Default Value:
200
Custom Page Style
Application Range: /{slug}.
Optimize Paragraph Spacing Display
🎯 Purpose
Add minimum height to custom page content paragraphs to display empty lines.
📂 Configuration Item Location
Custom Page Style -> Optimize Paragraph Empty Line Display
⚡ Quick Jump
/console/theme/settings/custom_page_styles#:~:text=Optimize%20Paragraph%20Spacing%20Display🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.custom_page_styles?.is_optimize_content_paragraph_spacing
ℹ️ Additional Information
Different Markdown editors use different parsers, so this configuration item may have different effects on the final rendering result. Related link: babelmark3 is a website that compares the parsing results of different Markdown parsers.
Enable Paragraph First-line Indent
🎯 Purpose
Add indentation style to the first line of content paragraphs.
📂 Configuration Item Location
Custom Page Style -> Paragraph First-line Indent
⚡ Quick Jump
/console/theme/settings/custom_page_styles#:~:text=Enable%20paragraph%20first-line%20indent🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.custom_page_styles?.is_enable_paragraph_first_line_indent
ℹ️ Additional Information
When enabled, you can configure
- First line indentation value
- Type: String
- Default Value:
2em(2 character width) - External constraints: CSS length units. Such as: 20rem, 300px, 30vw.
Show Estimated Reading Time of Page
🎯 Purpose
Display estimated reading time based on post word count on the page.
📂 Configuration Item Location
Custom Page Style -> Page Estimated Reading Time
⚡ Quick Jump
/console/theme/settings/custom_page_styles#:~:text=Show%20Estimated%20Reading%20Time%20of%20Page🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.custom_page_styles?.is_show_post_estimated_reading_time
ℹ️ Additional Information
After enabling the API Extension plugin, a more accurate measurement method will be automatically enabled.
Show Word Count of Page
🎯 Purpose
Display the total word count of the post on the page.
📂 Configuration Item Location
Custom Page Style -> Page Word Count
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.custom_page_styles?.is_show_post_word_count
ℹ️ Additional Information
After enabling the API Extension plugin, a more accurate measurement method will be automatically enabled.
Enable Dividing Line at End of Page Content
🎯 Purpose
Controls whether to display the separator at the end of the page content.
📂 Configuration Item Location
Custom Page Style -> Page Content End Separator
⚡ Quick Jump
/console/theme/settings/post_styles#:~:text=Enable%20Dividing%20Line%20at%20End%20of%20Page%20Content🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.custom_page_styles?.is_dividing_line_at_the_end_of_content_show
Enable Comment Section
🎯 Purpose
Controls whether to display the comment section on the page.
📂 Configuration Item Location
Custom Page Style -> Page Comment Section
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.custom_page_styles?.is_custom_page_comment_section_show
Error Page Style
Page Auto-redirect
🎯 Purpose
Automatically redirect to a specified page on error pages (such as 404).
📂 Configuration Item Location
Error Page Style -> Page Auto Redirect
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.error_page_styles?.is_auto_redirect
ℹ️ Additional Information
When enabled, you can configure
- Redirect target link
- Type: String
- Default Value:
/ - External constraints: Valid relative/absolute link
- Redirect wait time (Unit: seconds)
- Type: Integer
- Default Value:
5
Social Profile/RSS
Home Page Social Profile Display
🎯 Purpose
Display social media links and RSS subscription information on the homepage.
📂 Configuration Item Location
Social Profile/RSS -> Homepage Social Profile Display
🏷️ Type
Array (can repeatedly add multiple social profiles)
⭐ Default Value
Empty array []
🧩 Template Variable
theme.config?.sns?.index_sns
ℹ️ Additional Information
- Supports multiple preset social platforms: RSS, BiliBili, Dribbble, Email, Facebook, GitHub, Instagram, QQ, Reddit, Stack Overflow, Telegram, X(Twitter), YouTube, Douban, NetEase Cloud Music, Weibo, Zhihu, etc.
- Supports custom social profiles
- Supports plain text display
- Can configure your own social platform through "Set Custom Profile"
Social Media Settings
🎯 Purpose
Define your own social profile to be used in the homepage social profile display.
📂 Configuration Item Location
Social Profile/RSS -> Set Custom Profile
🏷️ Type
Repeater
⭐ Default Value
Empty
🧩 Template Variable
theme.config?.sns?.custom_sns
ℹ️ Additional Information
Provides preset values for mainstream platforms, only requires filling in the corresponding platform identifier to add.
In addition, you can also add custom profiles.
Each custom profile requires configuration:
- identifier: Any combination of letters, numbers, and underscores (e.g.,
myBlog) - Link: Complete URL (e.g.,
https://example.com) - Icon
- aria-label: Accessibility label (e.g.,
Find me on my blog)
Custom Share Buttons
Share Button Settings
🎯 Purpose
Configure the share button list for post pages, supports multiple sharing methods.
📂 Configuration Item Location
Custom Share Buttons -> Share Button Configuration
🏷️ Type
Repeater
⭐ Default Value
Includes multiple preset share buttons: E-mail, QRCode, Native, Facebook, X, LinkedIn, Pinterest, Telegram, QQ, Weibo, WeChat, Qzone, Douban
🧩 Template Variable
theme.config?.share?.button_config
ℹ️ Additional Information
@URLand@TITLEare placeholders that will be replaced with the actual page address and title when used- Each share button has four configurable items: name, link, Icon (setting will override the default icon),
aria-label(accessibility label) - Can freely adjust order, delete or add share buttons
Links Page Style
Requires the Links Management Plugin to be enabled.
Avatar-First Style
🎯 Purpose
When enabled, the links page will use a grid layout that emphasizes avatars, displaying up to three links per row, suitable for scenarios that require highlighting link site avatars.
📂 Configuration Item Location
Links Page Style -> Avatar-First Style
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.links_page_styles?.is_head_first_style
ℹ️ Additional Information
- Default Style: When disabled, uses traditional horizontal list layout with smaller avatars and information arranged to the right of the avatar
- Avatar-First Style: When enabled, uses grid card layout
- Uses responsive three-column grid (automatically selects number of columns based on page width, maximum three columns)
- Avatar centered display with larger size
- Link information arranged vertically below the avatar
- Card floats up with shadow effect on mouse hover
- Avatar enlarges and changes border color on mouse hover
Link Description Maximum Lines
🎯 Purpose
Set the maximum number of lines for link descriptions.
📂 Configuration Item Location
(Links Page Style -> Avatar-First Style When enabled, will display)
Links Page Style -> Link Description Line Limit
🏷️ Type
Integer
⭐ Default Value
3
🔒 Internal Constraints
Range 1-5
🧩 Template Variable
theme.config?.links_page_styles?.link_description_max_lines
Photo Gallery Page Style
Requires the Gallery Management Plugin to be enabled.
Image Border Radius
🎯 Purpose
Set the border radius width of images in the gallery page.
📂 Configuration Item Location
Gallery Page Style -> Image Border Radius Width
🏷️ Type
String
⭐ Default Value
8px
💡 Example Values
0px,5px,10%,1rem
⚠️ External Constraints
Valid CSS length unit.
🧩 Template Variable
theme.config?.photos_styles?.img_border_radius
Image Fade-in Animation Duration
🎯 Purpose
Set the fade-in animation duration for images in the gallery page.
📂 Configuration Item Location
Gallery Page Style -> Image Fade-In Animation Duration
🏷️ Type
Integer/Float (Unit: seconds)
⭐ Default Value
0.2
💡 Example Values
1,0
🧩 Template Variable
theme.config?.photos_styles?.img_transition_duration_after_load
Display Group Titles
🎯 Purpose
Control whether to display group titles on the gallery page.
📂 Configuration Item Location
Gallery Page Style -> Display Group Titles
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.photos_styles?.is_show_photo_group_name
ℹ️ Additional Information
- When the masonry layout is enabled:
- Enabling this option creates a separate masonry layout for each group.
- Disabling this option merges all groups into a single masonry layout.
Enable Masonry Layout
🎯 Purpose
Use waterfall layout to display images in the gallery page.
📂 Configuration Item Location
Gallery Page Style -> Enable Waterfall Layout
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.photos_styles?.is_enable_masonry_layout
ℹ️ Additional Information
When enabled, you can configure
- Waterfall layout maximum columns
- Waterfall layout minimum columns
- Waterfall layout minimum image width
- Waterfall layout gap width
- Advanced configuration options
- Custom image onmouseover attribute
- Custom image onmouseout attribute
Moments Page Style
Requires the Moments Management Plugin to be enabled.
Show Post Publication Date
🎯 Purpose
Control whether to display the post publication date in the moment list on the moments page.
📂 Configuration Item Location
Moments Page Style -> Show Post Publication Date
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.moments_styles?.is_show_post_pubdate
Show Estimated Reading Time of Moment
🎯 Purpose
Display estimated reading time based on word count at the beginning of the moment.
📂 Configuration Item Location
Moments Page Style -> Show Estimated Reading Time of Moment
⚡ Quick Jump
/console/theme/settings/moments_styles#:~:text=Show%20Estimated%20Reading%20Time%20of%20Moment🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.moments_styles?.is_show_post_estimated_reading_time
ℹ️ Additional Information
After enabling the API Extension plugin, a more accurate measurement method will be automatically enabled.
Show Word Count of Moment
🎯 Purpose
Display the total word count of the post at the beginning of the moment.
📂 Configuration Item Location
Moments Page Style -> Show Word Count of Moment
🏷️ Type
Boolean
⭐ Default Value
false
🧩 Template Variable
theme.config?.moments_styles?.is_show_post_word_count
ℹ️ Additional Information
After enabling the API Extension plugin, a more accurate measurement method will be automatically enabled.
Moment Page Upvote Button
🎯 Purpose
Display the like button on the moments page.
📂 Configuration Item Location
Moments Page Style -> Enable Upvote Button
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.moments_styles?.is_moment_upvote_button_show
Moment Page Comment Section
🎯 Purpose
Controls whether to display the comment section on the moments page.
📂 Configuration Item Location
Moments Page Style -> Enable Comment Section
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.moments_styles?.is_moment_comment_section_show
Friends Page Style
Requires the Friends Plugin to be enabled for use.
Show Publish Date
🎯 Purpose
Display the publication date of posts in the friends list.
📂 Configuration Item Location
Friends Page Style -> Show Publish Date
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.friends_page_styles?.is_show_friend_pubdate
Show Author Information
🎯 Purpose
Display the author's avatar and name in the friends list.
📂 Configuration Item Location
Friends Page Style -> Show Author Information
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.friends_page_styles?.is_show_friend_author
Show Author Avatar
🎯 Purpose
Display the author's avatar in the friends list. Clicking the avatar will navigate to the author's website.
📂 Configuration Item Location
Friends Page Style -> Show Author Avatar
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.friends_page_styles?.is_show_friend_author_avatar
ℹ️ Additional Information
Only takes effect when "Show Author Information" option is enabled.
Show Author Name
🎯 Purpose
Display the author's name in the friends list. Clicking the name will navigate to the author's website.
📂 Configuration Item Location
Friends Page Style -> Show Author Name
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.friends_page_styles?.is_show_friend_author_name
ℹ️ Additional Information
Only takes effect when "Show Author Information" option is enabled.
Show Post Description
🎯 Purpose
Display the post description/excerpt in the friends list.
📂 Configuration Item Location
Friends Page Style -> Show Post Description
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.friends_page_styles?.is_show_friend_description
Maximum Lines for Post Description
🎯 Purpose
Control the maximum number of lines displayed for post descriptions in the friends list.
📂 Configuration Item Location
Friends Page Style -> Maximum Lines for Post Description
⚡ Quick Jump
/console/theme/settings/friends_page_styles#:~:text=Maximum%20lines%20for%20post%20description🏷️ Type
Number (1-5)
⭐ Default Value
3
🧩 Template Variable
theme.config?.friends_page_styles?.friend_description_max_lines
ℹ️ Additional Information
Only takes effect when "Show Post Description" option is enabled.
Show Link Text
🎯 Purpose
Display link text (such as "Read original") in friends list items.
📂 Configuration Item Location
Friends Page Style -> Show Link Text
🏷️ Type
Boolean
⭐ Default Value
true
🧩 Template Variable
theme.config?.friends_page_styles?.is_show_friend_permalink_text
Next Steps
You can learn more about: