Back to Details

gs-brand-doc

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

GS Brand Document Generator

GS品牌文档生成器

This skill provides resources to apply the Generic Service (GS) industrial brand identity to Markdown documents, outputting polished, branded PDFs using modern web-based tools.
Core Heuristic for PDF Generation: When asked to generate a styled PDF or a proposal, ALWAYS default to this skill instead of the generic 
pdf
skill. Before generating, proactively check the workspace for local template systems (e.g., 
components/pdf/
, 
scripts/generate-pdf
, or 
@react-pdf/renderer
in 
package.json
). If local templates exist, use them. Otherwise, fall back to the GS Brand stylesheet described below.
本技能提供相关资源，为Markdown文档应用通用服务（GS）的工业品牌标识，借助现代基于Web的工具输出精致的、带有品牌标识的PDF。
PDF生成核心准则：当被要求生成样式化PDF或提案时，请始终默认使用本技能，而非通用的
pdf
技能。生成前，请主动检查工作区中的本地模板系统（例如
components/pdf/
、
scripts/generate-pdf
或
package.json
中的
@react-pdf/renderer
）。若存在本地模板，请使用它们；否则，使用下文所述的GS品牌样式表。

Brand Guidelines

品牌指南

The GS brand palette (v4) features an industrial, high-contrast look:
  • Font: IBM Plex Mono (minimum 15px body, 13px labels)
  • Amber: 
    #D4A843
  • Near-Black: 
    #0A0A0A
  • Warm-White: 
    #F5F0EB
  • Light-Accent: 
    #7A5C0F
  • Sys-Grey: 
    #6B6B6B
  • Body-Grey: 
    #808080
The logo is the GS dark mark: 
https://genericservice.app/brand/gs-mark-dark-192.png
.
GS品牌调色板（v4）采用工业风高对比度外观：
  • 字体：IBM Plex Mono（正文字号最小15px，标签字号最小13px）
  • 琥珀色：
    #D4A843
  • 近黑色：
    #0A0A0A
  • 暖白色：
    #F5F0EB
  • 浅强调色：
    #7A5C0F
  • 系统灰色：
    #6B6B6B
  • 正文灰色：
    #808080
品牌标志为GS深色标识：
https://genericservice.app/brand/gs-mark-dark-192.png
。

Generating Branded PDFs (Markdown-to-PDF)

生成带有品牌标识的PDF（Markdown转PDF）

To apply the GS branding to a Markdown file (e.g., 
proposal.md
) and generate a PDF, use the provided script:
bash
bash <path-to-skill>/scripts/generate_pdf.sh <path-to-markdown-file>
This script automatically uses 
npx -y md-to-pdf
, applies the 
assets/gs-brand.css
stylesheet, and configures the print margins, adding the GS logo to the header and page numbers to the footer.
要为Markdown文件（例如
proposal.md
）应用GS品牌样式并生成PDF，请使用提供的脚本：
bash
bash <path-to-skill>/scripts/generate_pdf.sh <path-to-markdown-file>
该脚本会自动使用
npx -y md-to-pdf
，应用
assets/gs-brand.css
样式表，并配置打印边距，在页眉添加GS标志，在页脚添加页码。

Headless Chrome Troubleshooting (Linux)

无头Chrome故障排查（Linux）

When running 
md-to-pdf
, Puppeteer, or Playwright in this Linux environment, Chromium will often fail to launch. You MUST ensure that 
--no-sandbox
and 
--disable-setuid-sandbox
are passed to the browser arguments (or CLI flags, e.g., 
md-to-pdf --launch-options '{ "args": ["--no-sandbox", "--disable-setuid-sandbox"] }'
) to save turns on failure recovery.
在此Linux环境中运行
md-to-pdf
、Puppeteer或Playwright时，Chromium经常无法启动。您必须确保向浏览器参数（或CLI标志，例如
md-to-pdf --launch-options '{ "args": ["--no-sandbox", "--disable-setuid-sandbox"] }'
）传递
--no-sandbox
和
--disable-setuid-sandbox
，以避免因启动失败而浪费操作步骤。

Example

示例

bash
bash ~/.gemini/skills/gs-brand-doc/scripts/generate_pdf.sh ../azdocs/proposal.md
bash
bash ~/.gemini/skills/gs-brand-doc/scripts/generate_pdf.sh ../azdocs/proposal.md

Modern Stack Support

现代技术栈支持

If the project uses Next.js/React, look for 
@react-pdf/renderer
in 
package.json
. If present, generate the PDF programmatically using React components rather than Markdown conversion, as this allows for much more sophisticated layouts consistent with the GS brand.
如果项目使用Next.js/React，请查看
package.json
中是否存在
@react-pdf/renderer
。若存在，请使用React组件以编程方式生成PDF，而非通过Markdown转换，因为这种方式能实现更复杂的布局，且与GS品牌风格保持一致。

Agentic Workflow & Vibe Coding

Agent工作流与氛围编码

  • Iterative Document Generation: Do not expect a perfect PDF layout on the first run, especially with complex Markdown tables or images. Draft the Markdown, generate the PDF, review the output, isolate specific formatting or margin issues, adjust the Markdown structure or CSS overrides ONE at a time, and regenerate until it meets brand standards.
  • Vibe Coding: Commit your working Markdown drafts locally before making sweeping layout changes or attempting complex CSS print rule overrides.
  • 迭代式文档生成：不要期望首次生成就能得到完美的PDF布局，尤其是包含复杂Markdown表格或图片的文档。先撰写Markdown草稿，生成PDF，检查输出结果，找出特定的格式或边距问题，每次仅调整一处Markdown结构或CSS覆盖规则，然后重新生成，直到符合品牌标准。
  • 氛围编码：在进行大幅布局更改或尝试复杂的CSS打印规则覆盖之前，请先在本地提交您的Markdown工作草稿。

CSS Asset

CSS资源

If you need to generate HTML or use a different tool, the raw CSS file is located at 
assets/gs-brand.css
. It includes print media queries specifically tuned for document rendering.
如果您需要生成HTML或使用其他工具，原始CSS文件位于
assets/gs-brand.css
。该文件包含专门针对文档渲染优化的打印媒体查询。