القائمة
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.