Footer Configuration Details

Published: 2025-05-10 15:00:00Updated: 2026-01-26 12:00:00

🕒 Reading time: 1 min📝 Words: 274👀 Views: Loading...

Overview

Footer fields come from the footer section of config.yml. The default values are as follows and do not depend on relative links within the project after publishing:

1
footer:
2
    buildtime: "2025-05-01T10:00:00"
3
    copyright:
4
        enabled: true
5
        startYear: 2024
6
        customText: ""
7
    theme:
8
        showPoweredBy: true
9
        showThemeInfo: true
10
    beian:
11
        icp:
12
            enabled: false
13
            number: "ICP备XXXXXXXX号"
14
        security:
15
            enabled: false
16
            text: "Public Security Filing XXXXXXXXXXXX"
17
            number: "XXXXXXXXXXXX"
18
    badges:
19
        - {
20
              label: "Powered by",
21
              message: "Astro",
22
              color: "orange",
23
              style: "flat-square",
24
              alt: "Powered by Astro",
25
              href: "https://astro.build/",
26
          }
27
        - {
28
              label: "Theme",
29
              message: "Stalux",
30
              color: "blueviolet",
31
              alt: "Theme: Stalux",
32
              href: "https://github.com/xingwangzhe/stalux",
33
          }
34
        - {
35
              label: "Built with",
36
              message: "❤",
37
              color: "red",
38
              style: "for-the-badge",
39
              alt: "Built with Love",
40
              href: "https://github.com/xingwangzhe",
41
          }
42
        - {
43
              label: "license",
44
              message: "MIT",
45
              color: "blue",
46
              alt: "License: MIT",
47
              href: "https://github.com/xingwangzhe/stalux/blob/main/LICENSE",
48
          }
49
        - {
50
              label: "Software Copyright",
51
              message: "Reg# 2025SR2258474",
52
              color: "yellowgreen",
53
              alt: "Software Copyright Registration No. 2025SR2258474",
54
              href: "/软著证明.pdf",
55
          }
56
        - {
57
              label: "Alibaba ESA",
58
              message: "Powered",
59
              color: "brightgreen",
60
              alt: "Alibaba Cloud ESA",
61
              href: "https://www.aliyun.com/product/esa",
62
          }
63
        - {
64
              label: "Sitemap",
65
              message: "XML",
66
              color: "orange",
67
              alt: "Sitemap XML",
68
              href: "/sitemap-index.xml",
69
          }
70
        - { label: "RSS", message: "Feed", color: "orange", alt: "RSS Feed", href: "/rss.xml" }
71
        - { label: "Atom", message: "Feed", color: "orange", alt: "Atom Feed", href: "/atom.xml" }
72
        - {
73
              label: "LLMs",
74
              message: "Dataset",
75
              color: "blue",
76
              alt: "LLM Dataset",
77
              href: "/llms.txt",
78
          }
79
        # ── 可折叠分组（v1.1+）──
80
        - title: "博客社区"
81
          collapsed: true
82
          items:
83
              - label: "示例社区A"
84
                message: "社区"
85
                color: "green"
86
                alt: "示例社区 A"
87
                href: "https://example.com"
88
              - label: "示例社区B"
89
                message: "导航"
90
                color: "yellow"
91
                alt: "示例社区 B"
92
                href: "https://example.org"
93
    custom: |
94
        <!-- Example custom footer slot, can hold analytics, widgets, etc. -->
95
        <div id="custom-footer-hook"></div>
96
        <script>console.log('Custom footer loaded');</script>

Field Descriptions

buildtime: Build time string, used for displaying site uptime on the frontend; it is recommended to fill in the actual deployment time.
copyright: Copyright section toggle, start year, and custom text; when enabled is off, copyright info is not displayed.
theme: Whether to show Powered by / Theme info.
beian: Toggle and numbers for ICP and public security filing; only displayed when enabled is true.
badges: Badge array. Each item can be either a flat badge (with label, message, color, style, alt, href) or a badge group (with title, collapsed, and items — where items is an array of flat badges). Groups render as a collapsible <details> section with localStorage-based state persistence — users’ collapsed/expanded preference is remembered across visits.
custom: Custom HTML snippet inserted into the footer, can be used for analytics or widgets.

Common Operations

Update filing numbers: Enable the corresponding enabled flag and fill in the number/text.
Simplify badges: Remove unnecessary items, keeping only those relevant to your site.
Customize copyright text: Fill in customText or adjust startYear to match the current year.
Add scripts: Place analytics/verification code in custom; note that only trusted scripts should be inserted to avoid cross-origin security risks.
Create badge groups: Replace a set of related flat badges with a group object (title + collapsed: true + items: […]). The group renders as a clickable row that expands to reveal its badges; the collapsed state is saved to localStorage so it persists across page refreshes and navigations.

Footer Configuration Details

Author: xingwangzhe

Article link: https://stalux.needhelp.icu/posts/dd30cf92/

This article is licensed under Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.