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

Named icons and logo styles

UI icons are small inline SVGs, not fetched image files, icon fonts or a client framework. Select a semantic key in native menu params.icon, section params.icon, tag_icons, social entries or the link shortcode. Parent color/size controls them. Identity artwork, collection logos, avatars, content images and QR data remain separate.

Four Sidera Parallax derivatives

KeyStyle
sidera-boldSolid paired crescents
sidera-bold-duotoneSolid with one crescent at 40% opacity
sidera-linearOutlined paired crescents
sidera-line-duotoneOutlined with one crescent at 40% opacity

These are original Sidera derivatives in Solar-like styles, not upstream Solar icons. They preserve the opposed crescents/negative-space identity without changing the fixed-color circle/square brand assets. Use Bold Duotone for a normal menu:

toml
[[menus.primary]]
name = 'Manual'
pageRef = '/manual'
[menus.primary.params]
icon = 'sidera-bold-duotone'

This page’s comparison links below render the actual four named registry entries.

Brand icons

The following keys use Font Awesome Free 7.3.1 artwork from svgs/brands/:

github, facebook, linkedin, slack, instagram, tiktok, wordpress, whatsapp, telegram, skype, bilibili, x-twitter, weixin, weibo.

Use the exact name, such as github, not github-bold or github-linear. Brand icons do not have Solar-style variants; separately named upstream designs are separate icons, not variants selected by a style setting. Only the listed icons are bundled, not the entire Font Awesome catalog. Non-brand UI icons use Solar.

text
{{< link href="https://github.com/" text="GitHub" icon="github" >}}

Brand icons use the same menu, social-entry and shortcode keys as other icons. Their original paths are fitted proportionally and centered in the existing 24 × 24 icon space. They inherit parent color and size, without hardcoded brand colors, Font Awesome CSS, fonts or JavaScript. Use them to represent the named company, product or service; the artwork license does not grant trademark rights.

Built-ins and site overrides

Common keys include home, about, blog, notebook, docs, page, tag, category, authors, series, star, planet, link, code, email, color-mode, search and download. The authoritative full registry/provenance lives in repository data/sidera/icons.yaml and icon_sources.yaml, including Solar and Font Awesome source names/revisions/licenses. Unknown nonempty keys diagnose; '' means none.

Add or replace one whole entry in site data/icons.yaml:

yaml
# Site-owned example geometry, not a Solar source claim.
custom-example: |
  <svg viewBox="0 0 24 24" fill="none">
    <circle cx="12" cy="12" r="8" stroke="currentColor" stroke-width="1.5"/>
  </svg>

All other built-ins remain. Site replacements do not inherit the replaced artwork’s provenance: retain your own author/source/license record and use authorized artwork. Definitions validate even if unused or icons are off.

Only one balanced svg, viewBox="0 0 24 24", and bounded geometry are accepted: g, path, circle, ellipse, rect, line, polyline, polygon. Attributes must be double-quoted, paint currentColor/none, with numeric geometry, opacity, strokes, transforms, fill rules and cap/join settings. No intrinsic root size, style/color, IDs/classes, text/title, defs/masks, links/use/images, events, scripts, foreignObject, entities, external resources or bitmaps. Maximum 50,000 characters. This is trusted maintainer data with format guards, not an untrusted SVG importer.

Icons in interactive JSX

The optional Icon component from sidera/ui uses this same registry and renderer. Declare a whitespace-separated icons list on the JSX fence/shortcode, then choose one of those names in the component. Only selected artwork is bundled; site data and renderer overrides participate in preview rebuilds. See the JSX icon guide for complete examples, decorative versus labelled usage and sandbox behavior. Explicit JSX icons, like authored icon shortcodes, are independent of the shell’s params.icons setting.

Color, size and accessibility

The renderer adds .icon, aria-hidden="true" and focusable="false". Parents provide accessible text and hit areas. With no override, SVG is 1em and inherits color; a trusted site stylesheet may set --icon-size or --icon-color on the containing control. Main-menu icons use the existing 1.5rem treatment. Do not put colors/sizes into the registry to customize one menu.

params.icons: false hides optional UI decoration but keeps localized visible text for icon-only actions. Empty selection removes one icon. A supported instance’s icons: true can intentionally override inherited false. Brand/content images and alt text remain; nearby collection titles allow decorative logo alt="".

See credits for retained Solar/Font Awesome CC BY attribution and original Sidera MIT terms. No trademark clearance is claimed.