菜单
Configure the site-wide announcement banner shown above the header — text, link, colours, dismissibility, and version id. This is a neko.yml setting, not a Markdown component.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Author the YAML frontmatter block of a Neko Markdown page — label, icon, order, tags, visibility, permalink, redirect, redirectSlug, layout, meta, nav, toc, backlinks, password. Use when configuring an individual page.
Author the project-level `neko.yml` — input/output paths, URL, branding, theme, meta tags, top navigation, banner, footer, snippets. Use when configuring or editing a Neko site at the project level.
Render a Mermaid diagram (flowchart, sequence, class, ER, state, gantt, journey, mindmap, sankey, XY, architecture) from a fenced ```mermaid``` block. Use for any structured diagram in docs.
Workflow for updating Neko documentation — base every page on the real source code, never invent APIs, warn loudly when the source isn't available, and check that the page (and any changed `tesserae` sample) renders correctly with Playwright / snapframe / a visual check. Use whenever you add or edit docs that describe code, APIs, components, or live samples.
Render a live Tesserae C# UI block — Neko compiles and executes the C# at build time and shows both the code and a working preview side-by-side. Use only when the project documents Tesserae or runs live C# samples.
Render C# API docs from a code block with XML doc comments (`/// <summary>`, `<param>`, `<returns>`, etc.). Use to embed API reference inline without a separate generator.
| name | banner |
| description | Configure the site-wide announcement banner shown above the header — text, link, colours, dismissibility, and version id. This is a neko.yml setting, not a Markdown component. |
The banner is a strip displayed at the top of every page, above the navigation
header. It is configured in neko.yml and not placed inline in Markdown.
banner:
text: "Welcome to Neko! Check out the new release."
link: /changelog
linkText: "Read the changelog"
visible: true
background: bg-indigo-600 # any Tailwind bg-* utility
color: text-white # any Tailwind text-* utility
id: announcement-v2 # version key for dismissal
dismissible: true
| Attribute | Type | Notes |
|---|---|---|
text | string | Banner copy. |
link | string | Optional URL/path; the whole banner becomes clickable if set. |
linkText | string | Custom call-to-action label appended to the text. |
visible | boolean | Master switch; default true. |
background | string | Tailwind bg utility, e.g. bg-indigo-600, bg-gradient-to-r .... |
color | string | Tailwind text colour, e.g. text-white. |
id | string | Unique version key. Changing it re-shows the banner to users who dismissed an earlier one. |
dismissible | boolean | When true, shows an "x" button; user choice persists in localStorage keyed by id. |
id whenever the banner content changes so previously dismissed users
see the new message.text short — long banners wrap awkwardly on mobile.background/color pair (e.g. bg-indigo-600 +
text-white).neko.yml banner is inherited by sub-sites
unless they override it.