GoCalf Calf 的自留地 · 昙花一现
由 AI 生成

Releases and upgrades

Git tags are Sidera’s version source of truth. Check the published releases before selecting a version; notes in this manual do not by themselves publish a tag. The GitHub Release uses the corresponding section below, not a second changelog.

Choose an update channel

Use a published stable tag for a normal site. Fetch tags, check out your selected tag in themes/sidera, build and test your site, then commit that exact gitlink. Keep the previous site commit for an ordinary dependency rollback.

Owners may instead update from origin/main deliberately, using a clean checkout and a fast-forward-only theme update. Test before committing the new consumer pin. Main can contain unreleased changes. Clone/submodule-update/build restores the committed pin; it does not automatically select the newest main commit or release. See the repository README for both command sequences, and troubleshooting for checks.

v1.1.0

Interactive authoring, richer navigation and a unified adaptive palette, with backward-compatible support for the v1 author footer.

New capabilities

  • Interactive ECharts: local JSON fences or shortcodes, bundle options/data, line/bar/pie/scatter charts, sandboxed rendering, source viewing and JSON downloads. Adaptive spacing keeps supported Cartesian charts readable without resize jitter.
  • Opt-in JSX islands: bundled React, native Hugo compilation, inline or bundle modules, local CSS, Stack/Row helpers and plain/card presentation. Page mode runs with page privileges; optional sandbox mode uses an isolated iframe. Enable only trusted content through the explicit site/language params.jsx = true setting.
  • Content components: accessible nested tabs, palette icons, hashtags, annotations, inline code highlighting, native attachment downloads and text decorations.
  • Structured tables: YAML/JSON data, Markdown cells, merged cells and multirow headers, accessible header associations, optional sticky headers/first columns, bounded scrolling, captions and opt-in grid borders.
  • Authors and discovery: linked {page.authors} configured-Markdown values, native inherited author assignments with declared profiles, and a random-article action that skips the current page and respects publication/language boundaries.
  • Source-edit links: explicit source-directory mappings, native mount/translation paths, longest-prefix selection and per-page/component overrides. Literal URLs remain supported; generated adapter pages do not receive mapped source links.

Appearance, performance and fixes

  • Nine adaptive content color families and coordinated interface, comment and JSX roles; improved secondary text/control contrast, links and sidebar interaction states.
  • Optional invert-soft, preserving full inversion by default and matching expanded image/diagram views; improved folding corners, table overflow and drawer controls.
  • Fourteen selected Font Awesome brand icons with retained provenance and licenses; updated manual, showcase links and Sidera pronunciation.
  • Faster settings, icons, menus and relationship lookup; more efficient content parsing and native minification of deferred HTML and renderer frames. No new package-install step is required for normal site builds.

Compatibility and deprecation

The optional article-footer authors component is deprecated but still supported. Existing names/avatars, show/edit_url options, named widgets and repeated instances continue to work. Deprecation is documentation-only: no warning affects strict builds. The component remains absent from the default footer; its historical partial entry points remain available.

A selected legacy authors footer owns editing, including hidden/empty states, so the TOC does not add a duplicate edit action. For new configurations, prefer header attribution and the TOC edit link. To switch, remove the legacy footer entry and move any component-level config.edit_url to toc; site/page URLs need not move. See the author-footer compatibility guide.

The random-article action follows the menu in default sidebars; explicit custom compositions stay unchanged. Review site-specific CSS/template overrides against the updated visual roles. Existing site-owned shortcodes keep native precedence over new theme shortcodes with the same names. Blur/concealment is cosmetic, not secrecy.

Requirements: Git and Hugo 0.166.0 extended, unchanged from v1.0.0. Preserve bundled third-party notices; theme licensing does not license a consuming site’s content.

v1.0.0

First Sidera release: an independent Hugo theme for blogs, notebooks and documentation, inspired by Hexo Stellar 1.44.0.

  • Native sections and page bundles, optional blog/notes/docs presets, tags and categories, authors, chronological series and ordered documentation trees.
  • English/Simplified Chinese UI; light, dark and automatic appearance; native menus, configurable sidebars and footers, local icons and a localized custom 404 page.
  • Source-relative Markdown links and local resources; local full-text/heading search, outgoing links and backlinks; code inclusion/downloads, math and safe content components.
  • Locally bundled Mermaid/drawio rendering, optional images/video/badges and Giscus comments; progressive page-entry motion with reduced-motion and no-JS fallbacks.
  • Optional, shallow user manual with visible AI-generated disclosure. Activating the theme alone publishes neither the manual nor comments.

Requirements: Git and Hugo 0.166.0 extended, the verified engine version. Bundled KaTeX 0.18.4 assets match that renderer. Normal builds need no Node, Python or package installer; no wider Hugo compatibility range is asserted.

Limits: comments and other external providers require their own setup/network; body translations are author-owned; search hiding is not a privacy boundary. Use native publication/exclusion rules for private content. Existing AI-label colors are intentional and do not all meet AA text contrast in light mode.

Rights: original Sidera material is MIT, copyright 2026 Calf. Stellar, Solar and bundled renderer/font notices retain their respective terms; site content is not relicensed. See credits and licenses.