设计系统【免费下载链接】catppuccin Soothing pastel theme for the high-spirited!项目地址https://gitcode.com/gh_mirrors/ca/catppuccin点击查看免费下载Catppuccin 是一个社区驱动的柔和粉彩主题以 4 种风味Flavor各 26 种颜色的调色板为核心。要让某个应用、编辑器或网站也拥有 Catppuccin 的配色就需要创建Port——把官方调色板翻译成目标程序自己的颜色方案。本文基于 Catppuccin 主仓库的 Port Creation 文档完整讲解 Port 的定义、提交工作流、模板克隆、仓库规范、维护与许可并结合本仓库的实际资源调色板资产、代码样例、文档体系给出可落地的操作指引。读完本文你将掌握从零创建并提交一个 Catppuccin Port 的全过程以及如何在被组织收录前后保持仓库质量与一致性。什么是 PortPort 是 Catppuccin 调色板针对某个应用所做的适配。你可以把它理解成一种颜色方案colorscheme它为目标程序中的每一个 UI 组件——背景、面板、文字、按钮、高亮、光标——都定义好应使用的颜色使整个界面呈现出 Catppuccin 统一的柔和风格。Catppuccin 的调色板本身由四个风味构成Latte亮色、Frappé、Macchiato 和 Mocha暗色。因此一个完整的 Port 通常需要覆盖全部四种风味而不是只做其中一个。这既是 Port 价值所在也是工作量所在——官方为此专门提供了批量工具链见后文辅助工具一节。Port 与 Userstyle 的边界在 Catppuccin 生态里有一个容易混淆的概念Userstyle。Port任意应用/程序对 Catppuccin 调色板的适配Userstyle特指对网站的适配且通过浏览器扩展 Stylus 注入样式实现。官方文档用一句话划清了边界所有 Userstyle 都是 Port但并非所有 Port 都是 Userstyle。这句话的含义是Userstyle 只是 Port 的一个子集。当你计划为一个网站而非本地程序做适配时正确的做法是走 Userstyle 路线将成果提交到独立的 userstyles 集合仓库而为编辑器、终端、桌面应用等做适配时则按普通 Port 流程提交。两者在提交流程和审查路径上也有明显区别详见下一节。提交前的两条须知在动手之前官方文档明确了两条规则必须遵守行为准则所有 Port 都应符合 Catppuccin 组织的行为准则要求组织保留选择权staff 团队有权决定哪些 Port 会被纳入组织名下。也就是说提交不等于收录最终是否进入组织由团队评审决定。此外不接受的贡献类型作为社区驱动项目Catppuccin 希望保持对所有用户的中立环境因此不接受带有宗教或政治背景的贡献。但官方也明确指出并不反对其他场景如个人项目使用其调色板。完整的 Port 提交流程官方文档用一张状态图描述了从想法到组织收录的完整工作流核心流程如下用文字拆解这一流程可以分成三个关键分支还没有草稿先在主仓库下发起一个Port Request 讨论discussion由社区或你自己认领并完成一个草稿已有草稿且目标是 Userstyle直接向 userstyles 集合仓库提交 Pull Request走 Userstyle 审查流程已有草稿且目标是普通 Port创建一个Port Review 议题issue进入组织审查环节。无论走哪条路最终都会汇聚到审查期Review这一阶段依赖社区反馈由 staff 团队评估后决定是否收录Port adoption。FAQ 部分会进一步细化每种情况的具体操作入口。常见问题解答FAQ官方文档针对四个典型场景给出了明确答复Q. 我已经完成了一个已主题化的 Port可以接受审查了A. 直接在主仓库通过 Port Review 议题模板提交审查请求即可。因为 Port 已经完成主题化可以直接进入 staff 团队的评审。Q. 我已经完成了一个 Userstyle可以接受审查了A. 通过 Pull Request 提交到 userstyles 集合仓库而不是走 Port Review 议题。Userstyle 有独立的贡献说明应遵循其专门的创作指南。Q. 我想请求收录某个 Port或者已经开始动手了A. 在主仓库的Port Requests分类下发起讨论。staff 团队会评估一旦认为该 Port 已具备评审条件会把讨论转成正式的议题。官方也欢迎社区成员在 Discord 服务器上分享自己的进展。Q. 哪些类型的 Port 不会被接受A. 带宗教或政治背景的贡献不被接受但在这些场景中使用调色板本身没有问题。使用官方模板创建 Port官方提供了一个公开的模板仓库template作为 Port 项目的蓝图创建步骤如下克隆模板仓库以你的 Port 名称命名目录git clone catppuccin/template 模板仓库地址 name_of_your_port进入克隆下来的目录cd name_of_your_port重置 Git 历史删除仓库根目录下的.git文件夹然后重新执行git init。这一步非常关键——它能确保模板仓库作者的提交记录不会出现在你的新 Port 中避免模板作者被误列为贡献者。完善你的 Port 并推送到自己的用户仓库填充主题实现、补齐四种风味然后推送到你自己的仓库为后续提交审查做准备。这套流程的核心思想是站在模板的肩膀上起步仓库结构、CI 配置、README 骨架都由模板提供你只需专注于把调色板真正翻译到目标应用中。仓库与样式规范在模板基础上创建完仓库后必须按照官方规范进行样式化处理以保证组织内所有 Port 的一致性。这些规范是本仓库 README.md 所维护的生态体系的直接体现具体包括仓库元信息命名仓库名必须是应用名的小写短横线形式lower-kebab-case例如unreal-engine而不是Unreal Engine默认分支必须设置为main与组织内其他 Port 保持一致描述格式emoji Soothing pastel theme for app name其中emoji选一个你认为最能代表该应用的 emojiapp name使用正确的首字母大写Topics至少添加catppuccin、theme以及应用名称如unreal-engine三个标签便于检索发现。资源与图片图片统一放在assets/目录下优先使用.webp而非.png.webp体积更小、更高效且已被所有主流浏览器支持。这一点在本仓库中有直接佐证——assets/previews/ 下的风味预览图正是以.webp格式存放的如 latte.webp、mocha.webp同时保留了对应的.svg源文件。README.md 要求更新模板自带的 shields.io 徽章使它们指向你的 Port 仓库而不是模板仓库主预览图必须使用 catwalk 生成的图片catwalk 是官方工具能把四个风味合成一张分层截图详见下文预览图的路径要改用相对链接保证仓库在镜像、fork 等场景下依然可解析在Thanks to致谢部分加上你自己的名字。文件组织确保README.md等元文件使用大写命名不要添加健康文件如CODE_OF_CONDUCT.md、SUPPORT.md这些是组织级文件统一存放在组织仓库中各 Port 无需重复维护。移交后的共同维护机制官方文档特别安抚了新手贡献者提交 Port 可能让人感到压力但组织并不要求你在 Port 移交后持续维护。如果你愿意继续参与当然欢迎无法持续维护也完全可以理解。当你提交 Port 申请移交时可以把它理解为提出共同维护的邀约你与 staff 团队将一起维护这个 Port。组织侧的重点是维持所有 Port 的质量与**可访问性accessibility**标准的一致性提供改进建议反馈如何优化你的 Port帮助修复技术问题。也就是说移交不是交钥匙走人而是进入一个协作维护模式——质量兜底由组织负责你按自身精力参与即可。许可协议LicensingCatppuccin 项目本身以MIT 许可发布可参见仓库根目录的 LICENSE 文件因此任何贡献都默认在同样的 MIT 条款下发布。但存在例外情况如果你所主题化的应用本身有许可限制或者你的工作是更严格许可的衍生作品例如光标主题这类衍生资产则需要提前联系 staff 团队沟通处理。简单说默认 MIT有特殊许可背景时先沟通再提交。辅助工具让四种风味不再重复劳动由于 Catppuccin 有 4 种风味为一个应用手动维护 4 套颜色版本是相当繁琐的。为此官方在toolbox 工具集仓库中汇集了一系列辅助工具均附带使用说明。其中最关键的是catwalk用于生成分层截图layered screenshot能将你的 Port 在四个风味下的效果合成为一张图片是 Port README 主预览图的推荐生成方式参见上文 README 规范。使用这些工具可以把四风味 × 全组件的重复劳动压缩成近乎自动化的流程让贡献者把精力集中在配色与细节的打磨上。仓库中的实践参考资源除了规范文档本仓库还提供了几类可直接复用的资源帮助你在开发 Port 时对齐官方效果调色板资产assets/palette/ 下存放了四种风味的全部色卡圆点图如 mocha_base.png、语义色semantic/与 ANSI 色ansi/开发终端类 Port 时可与 style-guide.md 中的 ANSI 颜色映射表对照代码样例samples/ 目录收录了 40 余种编程语言/标记语言/配置文件的代码片段如 python.py、rust.rs、json.json可用于检验你的主题在真实语法高亮下的观感文档体系docs/README.md 汇总了规格说明docs/specs.md介绍四个风味的构成与子调色板设计、使用规范docs/style-guide.md介绍背景色/文字色/语义色的标准映射以及本文所依据的 Port 创建指南主仓库 README.md 的Ports and more区块则汇总了组织现有 Port 的完整清单可作为参考案例。综合来看Port 创建并非从零开始的艺术创作而是一套有模板、有工具、有规范、有审查的标准流程用模板起步、用 catwalk 出图、按规范命名与归档、走讨论与审查通道最终与组织共同维护。这套流程保证了上百个 Port 之间视觉与工程上的高度一致性——这也是 Catppuccin 生态得以规模化扩展的关键所在。赞分享设计系统【免费下载链接】catppuccin Soothing pastel theme for the high-spirited!项目地址https://gitcode.com/gh_mirrors/ca/catppuccin点击查看免费下载相关推荐QMK Configurator 分步实战指南从选板到烧录固件的完整工作流qmk_firmwareQMK Configurator 分步实战指南从选板到烧录固件的完整工作流qmk_firmware 本文基于 qmk_firmware 官方文档 conf嵌入式固件驱动开发硬件开发CVAT项目完整组织工作流指南从入门到高效标注CVAT项目完整组织工作流指南从入门到高效标注 前言 计算机视觉标注工具 CVAT 作为当前最先进的图像和视频标注平台之一为组织提供了完整的标注工作流解决方数据标注计算机视觉数据集AI 应用后端前端Blockbench零基础实战从创意到作品的完整建模工作流Blockbench零基础实战从创意到作品的完整建模工作流 你是否曾想过要创作自己的3D模型却因为复杂的软件界面而望而却步或者你已经在建模软件中迷失了方向桌面应用3D建模图形学游戏开发创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/20 22:35:57 · 阅读 1.2k Catppuccin Port 创建指南：从模板起步到组织收录的完整工作流
设计系统【免费下载链接】catppuccin Soothing pastel theme for the high-spirited!项目地址https://gitcode.com/gh_mirrors/ca/catppuccin点击查看免费下载Catppuccin 是一个社区驱动的柔和粉彩主题以 4 种风味Flavor各 26 种颜色的调色板为核心。要让某个应用、编辑器或网站也拥有 Catppuccin 的配色就需要创建Port——把官方调色板翻译成目标程序自己的颜色方案。本文基于 Catppuccin 主仓库的 Port Creation 文档完整讲解 Port 的定义、提交工作流、模板克隆、仓库规范、维护与许可并结合本仓库的实际资源调色板资产、代码样例、文档体系给出可落地的操作指引。读完本文你将掌握从零创建并提交一个 Catppuccin Port 的全过程以及如何在被组织收录前后保持仓库质量与一致性。什么是 PortPort 是 Catppuccin 调色板针对某个应用所做的适配。你可以把它理解成一种颜色方案colorscheme它为目标程序中的每一个 UI 组件——背景、面板、文字、按钮、高亮、光标——都定义好应使用的颜色使整个界面呈现出 Catppuccin 统一的柔和风格。Catppuccin 的调色板本身由四个风味构成Latte亮色、Frappé、Macchiato 和 Mocha暗色。因此一个完整的 Port 通常需要覆盖全部四种风味而不是只做其中一个。这既是 Port 价值所在也是工作量所在——官方为此专门提供了批量工具链见后文辅助工具一节。Port 与 Userstyle 的边界在 Catppuccin 生态里有一个容易混淆的概念Userstyle。Port任意应用/程序对 Catppuccin 调色板的适配Userstyle特指对网站的适配且通过浏览器扩展 Stylus 注入样式实现。官方文档用一句话划清了边界所有 Userstyle 都是 Port但并非所有 Port 都是 Userstyle。这句话的含义是Userstyle 只是 Port 的一个子集。当你计划为一个网站而非本地程序做适配时正确的做法是走 Userstyle 路线将成果提交到独立的 userstyles 集合仓库而为编辑器、终端、桌面应用等做适配时则按普通 Port 流程提交。两者在提交流程和审查路径上也有明显区别详见下一节。提交前的两条须知在动手之前官方文档明确了两条规则必须遵守行为准则所有 Port 都应符合 Catppuccin 组织的行为准则要求组织保留选择权staff 团队有权决定哪些 Port 会被纳入组织名下。也就是说提交不等于收录最终是否进入组织由团队评审决定。此外不接受的贡献类型作为社区驱动项目Catppuccin 希望保持对所有用户的中立环境因此不接受带有宗教或政治背景的贡献。但官方也明确指出并不反对其他场景如个人项目使用其调色板。完整的 Port 提交流程官方文档用一张状态图描述了从想法到组织收录的完整工作流核心流程如下用文字拆解这一流程可以分成三个关键分支还没有草稿先在主仓库下发起一个Port Request 讨论discussion由社区或你自己认领并完成一个草稿已有草稿且目标是 Userstyle直接向 userstyles 集合仓库提交 Pull Request走 Userstyle 审查流程已有草稿且目标是普通 Port创建一个Port Review 议题issue进入组织审查环节。无论走哪条路最终都会汇聚到审查期Review这一阶段依赖社区反馈由 staff 团队评估后决定是否收录Port adoption。FAQ 部分会进一步细化每种情况的具体操作入口。常见问题解答FAQ官方文档针对四个典型场景给出了明确答复Q. 我已经完成了一个已主题化的 Port可以接受审查了A. 直接在主仓库通过 Port Review 议题模板提交审查请求即可。因为 Port 已经完成主题化可以直接进入 staff 团队的评审。Q. 我已经完成了一个 Userstyle可以接受审查了A. 通过 Pull Request 提交到 userstyles 集合仓库而不是走 Port Review 议题。Userstyle 有独立的贡献说明应遵循其专门的创作指南。Q. 我想请求收录某个 Port或者已经开始动手了A. 在主仓库的Port Requests分类下发起讨论。staff 团队会评估一旦认为该 Port 已具备评审条件会把讨论转成正式的议题。官方也欢迎社区成员在 Discord 服务器上分享自己的进展。Q. 哪些类型的 Port 不会被接受A. 带宗教或政治背景的贡献不被接受但在这些场景中使用调色板本身没有问题。使用官方模板创建 Port官方提供了一个公开的模板仓库template作为 Port 项目的蓝图创建步骤如下克隆模板仓库以你的 Port 名称命名目录git clone catppuccin/template 模板仓库地址 name_of_your_port进入克隆下来的目录cd name_of_your_port重置 Git 历史删除仓库根目录下的.git文件夹然后重新执行git init。这一步非常关键——它能确保模板仓库作者的提交记录不会出现在你的新 Port 中避免模板作者被误列为贡献者。完善你的 Port 并推送到自己的用户仓库填充主题实现、补齐四种风味然后推送到你自己的仓库为后续提交审查做准备。这套流程的核心思想是站在模板的肩膀上起步仓库结构、CI 配置、README 骨架都由模板提供你只需专注于把调色板真正翻译到目标应用中。仓库与样式规范在模板基础上创建完仓库后必须按照官方规范进行样式化处理以保证组织内所有 Port 的一致性。这些规范是本仓库 README.md 所维护的生态体系的直接体现具体包括仓库元信息命名仓库名必须是应用名的小写短横线形式lower-kebab-case例如unreal-engine而不是Unreal Engine默认分支必须设置为main与组织内其他 Port 保持一致描述格式emoji Soothing pastel theme for app name其中emoji选一个你认为最能代表该应用的 emojiapp name使用正确的首字母大写Topics至少添加catppuccin、theme以及应用名称如unreal-engine三个标签便于检索发现。资源与图片图片统一放在assets/目录下优先使用.webp而非.png.webp体积更小、更高效且已被所有主流浏览器支持。这一点在本仓库中有直接佐证——assets/previews/ 下的风味预览图正是以.webp格式存放的如 latte.webp、mocha.webp同时保留了对应的.svg源文件。README.md 要求更新模板自带的 shields.io 徽章使它们指向你的 Port 仓库而不是模板仓库主预览图必须使用 catwalk 生成的图片catwalk 是官方工具能把四个风味合成一张分层截图详见下文预览图的路径要改用相对链接保证仓库在镜像、fork 等场景下依然可解析在Thanks to致谢部分加上你自己的名字。文件组织确保README.md等元文件使用大写命名不要添加健康文件如CODE_OF_CONDUCT.md、SUPPORT.md这些是组织级文件统一存放在组织仓库中各 Port 无需重复维护。移交后的共同维护机制官方文档特别安抚了新手贡献者提交 Port 可能让人感到压力但组织并不要求你在 Port 移交后持续维护。如果你愿意继续参与当然欢迎无法持续维护也完全可以理解。当你提交 Port 申请移交时可以把它理解为提出共同维护的邀约你与 staff 团队将一起维护这个 Port。组织侧的重点是维持所有 Port 的质量与**可访问性accessibility**标准的一致性提供改进建议反馈如何优化你的 Port帮助修复技术问题。也就是说移交不是交钥匙走人而是进入一个协作维护模式——质量兜底由组织负责你按自身精力参与即可。许可协议LicensingCatppuccin 项目本身以MIT 许可发布可参见仓库根目录的 LICENSE 文件因此任何贡献都默认在同样的 MIT 条款下发布。但存在例外情况如果你所主题化的应用本身有许可限制或者你的工作是更严格许可的衍生作品例如光标主题这类衍生资产则需要提前联系 staff 团队沟通处理。简单说默认 MIT有特殊许可背景时先沟通再提交。辅助工具让四种风味不再重复劳动由于 Catppuccin 有 4 种风味为一个应用手动维护 4 套颜色版本是相当繁琐的。为此官方在toolbox 工具集仓库中汇集了一系列辅助工具均附带使用说明。其中最关键的是catwalk用于生成分层截图layered screenshot能将你的 Port 在四个风味下的效果合成为一张图片是 Port README 主预览图的推荐生成方式参见上文 README 规范。使用这些工具可以把四风味 × 全组件的重复劳动压缩成近乎自动化的流程让贡献者把精力集中在配色与细节的打磨上。仓库中的实践参考资源除了规范文档本仓库还提供了几类可直接复用的资源帮助你在开发 Port 时对齐官方效果调色板资产assets/palette/ 下存放了四种风味的全部色卡圆点图如 mocha_base.png、语义色semantic/与 ANSI 色ansi/开发终端类 Port 时可与 style-guide.md 中的 ANSI 颜色映射表对照代码样例samples/ 目录收录了 40 余种编程语言/标记语言/配置文件的代码片段如 python.py、rust.rs、json.json可用于检验你的主题在真实语法高亮下的观感文档体系docs/README.md 汇总了规格说明docs/specs.md介绍四个风味的构成与子调色板设计、使用规范docs/style-guide.md介绍背景色/文字色/语义色的标准映射以及本文所依据的 Port 创建指南主仓库 README.md 的Ports and more区块则汇总了组织现有 Port 的完整清单可作为参考案例。综合来看Port 创建并非从零开始的艺术创作而是一套有模板、有工具、有规范、有审查的标准流程用模板起步、用 catwalk 出图、按规范命名与归档、走讨论与审查通道最终与组织共同维护。这套流程保证了上百个 Port 之间视觉与工程上的高度一致性——这也是 Catppuccin 生态得以规模化扩展的关键所在。赞分享设计系统【免费下载链接】catppuccin Soothing pastel theme for the high-spirited!项目地址https://gitcode.com/gh_mirrors/ca/catppuccin点击查看免费下载相关推荐QMK Configurator 分步实战指南从选板到烧录固件的完整工作流qmk_firmwareQMK Configurator 分步实战指南从选板到烧录固件的完整工作流qmk_firmware 本文基于 qmk_firmware 官方文档 conf嵌入式固件驱动开发硬件开发CVAT项目完整组织工作流指南从入门到高效标注CVAT项目完整组织工作流指南从入门到高效标注 前言 计算机视觉标注工具 CVAT 作为当前最先进的图像和视频标注平台之一为组织提供了完整的标注工作流解决方数据标注计算机视觉数据集AI 应用后端前端Blockbench零基础实战从创意到作品的完整建模工作流Blockbench零基础实战从创意到作品的完整建模工作流 你是否曾想过要创作自己的3D模型却因为复杂的软件界面而望而却步或者你已经在建模软件中迷失了方向桌面应用3D建模图形学游戏开发创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考