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 = truesetting. - 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.