netresearch-branding

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Netresearch Brand Guidelines (Strict)

Netresearch品牌指南（严格版）

Apply Netresearch brand identity to web outputs, documentation, and TYPO3 extensions.

将Netresearch品牌标识应用于网页输出、文档及TYPO3扩展中。

Auto-Trigger Conditions

自动触发条件

Apply automatically when any of the following is true:

GitHub org is
```
netresearch
```
or composer vendor is
```
netresearch/
```
Creating/modifying HTML pages, dashboards, reports, docs pages, or component demos
Creating extension icons or branded UI assets
Prompt contains branding terms (e.g. logo, style guide, brand colors)
Another skill generates user-facing visual content

当满足以下任一条件时自动应用：

GitHub组织为
```
netresearch
```
或composer供应商为
```
netresearch/
```
创建/修改HTML页面、仪表盘、报告、文档页面或组件演示
创建扩展图标或品牌化UI资产
提示中包含品牌相关术语（如logo、风格指南、品牌色彩）
其他技能生成面向用户的视觉内容

Hard Validity Rules

严格有效性规则

Output is invalid if any item is missing:

Header logo (

assets/logos/netresearch-symbol-only.svg

, or fallback from

references/logo-svg.md

)

Brand colors:
```
#2F99A4
```
(primary),
```
#FF4D00
```
(accent only),
```
#585961
```
(text)
Typography intent: Raleway for headlines/UI emphasis, Open Sans for body/forms

Footer includes link to

https://www.netresearch.de/

and text

Netresearch DTT GmbH

If user instructions conflict, keep these rules and explain constraints.

若缺少以下任意一项，输出即为无效：

头部logo（

assets/logos/netresearch-symbol-only.svg

，或从

references/logo-svg.md

获取备选方案）

品牌色彩：
```
#2F99A4
```
（主色）、
```
#FF4D00
```
（仅用作强调色）、
```
#585961
```
（文本色）
排版要求：标题/UI强调部分使用Raleway字体，正文/表单使用Open Sans字体

页脚包含链接

https://www.netresearch.de/

及文本

Netresearch DTT GmbH

若用户指令与上述规则冲突，需遵循本规则并说明限制条件。

Mandatory Logo Rendering Behavior

强制Logo渲染规则

Logo source priority:

assets/logos/netresearch-symbol-only.svg

```
references/logo-svg.md
```
(inline SVG fallback)
```
references/logo.md
```
(text fallback for SVG-limited agents)

Rules:

Include logo exactly once in top header/nav for branded pages
Minimum size
```
32x32px
```
; recommended
```
40–56px
```
in headers
Preserve aspect ratio
No recolor, distortion, filters, shadows, outlines, substitutions, or approximations
If clickable, link to
```
https://www.netresearch.de/
```

Logo来源优先级：

assets/logos/netresearch-symbol-only.svg

```
references/logo-svg.md
```
（内嵌SVG备选方案）
```
references/logo.md
```
（针对不支持SVG的工具的文本备选方案）

规则：

品牌页面的顶部页眉/导航栏中需恰好包含一个Logo
最小尺寸为
```
32x32px
```
；页眉中推荐尺寸为
```
40–56px
```
保持宽高比
禁止重新着色、变形、添加滤镜、阴影、轮廓、替换或近似处理
若设置为可点击，需链接至
```
https://www.netresearch.de/
```

Active Reference Workflow

参考文档工作流程

Operationalize references in every branded output:

```
references/colors.md
```
for palette/token mapping
```
references/typography.md
```
for font roles and scale
```
references/web-design.md
```
for layout/components/spacing

references/logo.md

and

references/logo-svg.md

for logo fallback behavior

```
references/typo3-extension-branding.md
```
for TYPO3 context

在所有品牌化输出中需遵循以下参考文档：

```
references/colors.md
```
：调色板/颜色映射
```
references/typography.md
```
：字体角色及字号比例
```
references/web-design.md
```
：布局/组件/间距规范

references/logo.md

和

references/logo-svg.md

：Logo备选方案规则

```
references/typo3-extension-branding.md
```
：TYPO3场景规范

Core Brand System

核心品牌系统

CSS variables preferred:

--nr-primary

--nr-accent

--nr-text

--nr-border

--nr-bg

Accent orange is highlight-only and must not dominate surfaces
Accessibility: WCAG AA minimum contrast and semantic structure
Footer branding is mandatory in user-facing branded pages

优先使用CSS变量：

--nr-primary

、

--nr-accent

、

--nr-text

、

--nr-border

、

--nr-bg

橙色强调色仅用于高亮，不得大面积覆盖页面
无障碍性：满足WCAG AA级最低对比度要求及语义化结构
面向用户的品牌页面中必须包含页脚品牌信息

TYPO3 Extension Requirements

TYPO3扩展要求

Icon path:

Resources/Public/Icons/Extension.svg

(teal

#2F99A4

)

Composer vendor prefix:
```
netresearch/
```
```
author_company
```
:
```
Netresearch DTT GmbH
```
Description suffix:
```
- by Netresearch
```
Contact:
```
typo3@netresearch.de
```

图标路径：

Resources/Public/Icons/Extension.svg

（蓝绿色

#2F99A4

）

Composer供应商前缀：
```
netresearch/
```
```
author_company
```
：
```
Netresearch DTT GmbH
```
描述后缀：
```
- by Netresearch
```
联系方式：
```
typo3@netresearch.de
```

Brand Assets

品牌资产

```
assets/markdown-pdf.css
```
— branded stylesheet for
```
markdown-to-pdf-skill
```
; apply via
```
--css
```
. Its
```
.page-header
```
/
```
.page-footer
```
running elements aren't emitted by
```
convert.py
```
; the caller must supply HTML containing them (see that skill's
```
SKILL.md
```
).
```
assets/markdown-pdf-logo.svg
```
— standalone Netresearch logo (brand-teal/grey) for general use.
```
assets/markdown-pdf-logo-white.svg
```
— white-fill variant for the
```
.page-header
```
running header, where the teal/grey logo has no contrast on the teal background (
```
--nr-primary
```
). The sanctioned exception to "no recoloring" — do not use elsewhere.

```
assets/markdown-pdf.css
```
— 用于
```
markdown-to-pdf-skill
```
的品牌化样式表；通过
```
--css
```
参数应用。其
```
.page-header
```
/
```
.page-footer
```
运行元素不会由
```
convert.py
```
生成，调用者需提供包含这些元素的HTML（详见该技能的
```
SKILL.md
```
）。
```
assets/markdown-pdf-logo.svg
```
— 独立的Netresearch Logo（品牌蓝绿色/灰色），用于通用场景。
```
assets/markdown-pdf-logo-white.svg
```
— 白色填充版本，用于
```
.page-header
```
运行页眉（蓝绿色/灰色Logo在蓝绿色背景
```
--nr-primary
```
上无对比度）。这是“禁止重新着色”规则的唯一例外——请勿在其他场景使用。

No editorializing

禁止主观描述

In branded reports, PR/commit text and docs, state what a change or output does, not how good the work is — no narrating expected results ("all tests green") or self-praise ("clean"). Judged by tone, not a wordlist. See

references/no-editorializing.md

在品牌化报告、PR/提交文本及文档中，仅说明变更或输出的功能，不得评价工作质量——不得描述预期结果（如“所有测试通过”）或自我表扬（如“代码整洁”）。判断标准为语气而非特定词汇列表。详见

references/no-editorializing.md

。

References

参考文档

```
references/colors.md
```
```
references/typography.md
```
```
references/web-design.md
```
```
references/logo.md
```
```
references/logo-svg.md
```
```
references/typo3-extension-branding.md
```
```
references/README-branding.md
```
```
references/no-editorializing.md
```

```
references/colors.md
```
```
references/typography.md
```
```
references/web-design.md
```
```
references/logo.md
```
```
references/logo-svg.md
```
```
references/typo3-extension-branding.md
```
```
references/README-branding.md
```
```
references/no-editorializing.md
```