企业官网建设流程全解析

Penpot 如何发布共享库（Shared Library）并在团队其他文件中连接使用

【免费下载链接】penpotPenpot: The open-source design platform for Product teams that need scalable collaboration.项目地址: https://gitcode.com/GitHub_Trending/pe/penpot

在 Penpot 中维护设计系统时，常见的任务是把某个文件整理成组件、颜色和文字样式的集合，让同一个团队里的其他文件直接复用这些资源。这个流程分两步：先把一个普通文件发布为共享库（Shared Library），再在团队的另一个文件里连接（Connect）这个库。前提是这两个文件属于同一个团队——文档明确说明，共享库发布后，该文件的文件库（file library）只对“存在于同一团队中的其他文件”可见并可连接。

先让文件库里有可复用的资产

每个文件都有自己的文件库，用来存放属于该文件的资产。发布之前，文件库里需要已经有内容，否则别的文件连接过来也取不到东西。

打开文件工作区（workspace）后，用两种方式进入文件库（assets 面板）：

• 点击左侧边栏的 assets 标签图标；
• 按Alt/⌥+i。

往文件库里添加资产的方式（详见 Assets 文档）：

• Components：主组件（main component）在创建时会自动存入本地图库；也可以点该分类的 “+” 导入一张图片，它会被作为组件加入。
• Colors：点 “+” 打开取色器添加颜色样式。
• Typographies：从右侧边栏文字属性中创建的每个文字样式都会自动存入库中；也可以点 “+” 从零新建。小技巧：先选中一个已有属性的文本图层再点 “+”，新建的文字样式会带上该文本的字体、字号、行高等属性。

添加完成后，在 assets 面板里确认能看到目标组件、颜色和文字样式，再进入发布步骤。

将文件发布为共享库

文档给出两条发布路径，任选其一：

1. 通过文件主菜单：在文件主菜单（file main menu）中选择将文件发布为共享库。
2. 通过 Libraries 面板：在 assets 标签页（assets tab）上点击 “Libraries” 按钮打开 libraries 面板，在面板内执行发布。

发布成功后，该文件的文件库就可以被同团队的其他文件连接使用。

在团队其他文件中连接共享库

打开同一团队内的另一个文件，进入它的 workspace，同样打开 assets 标签页，点击 “Libraries” 按钮启动 libraries 面板，然后搜索并勾选要使用的可用库。

连接时的一个判断点：如果面板提示 “There are no Shared Libraries available”，说明当前团队里还没有任何文件被发布为共享库——按上面一节先发布，或者从 Penpot 官方提供的 Libraries & templates 中添加库。

验证连接结果并使用共享资产

连接完成后，验证和使用都发生在当前文件的 workspace 中：

1. 库出现在左侧资产面板：已连接的共享库会列在 workspace 左侧边栏的 assets 面板里，可以展开/折叠查看每个库内的资产。这是连接成功的直接标志。
2. 按类型使用资产（操作方式与 Assets 文档 中“Use Assets”一致）：
   • 组件：直接从库中拖拽到视口（viewport）；
   • 颜色：选中图形或文本后，点击库中的颜色将其应用为填充；按住Alt（macOS 为⌥）再点击则应用到描边；
   • 文字样式：选中文本图层后点击库中的 typography 样式即可应用。

如果之后需要修改库内容本身，可以点击共享库名称右侧的箭头图标，直接跳转到库所在的源文件进行编辑。

可选：从已连接的库导入 Design Tokens

这一项独立于“连接库使用组件、颜色、文字样式”：只有当已连接的共享库定义了 design tokens 时，库条目旁边才会出现Import tokens按钮（没有 tokens 的库不显示此控件）。

1. 从 assets 标签页打开Libraries面板；
2. 在Libraries in this file下找到含 tokens 的已连接库，点击Import tokens（该按钮位于 disconnect 控件旁边）；
3. 确认对话框会提示导入会带入该库的完整 token 数据，包括库定义了 sets 和 themes 时的 sets 与 themes；
4. 点击Import tokens应用，或Cancel取消。

注意文档给出的限制：从库导入 tokens 会替换当前文件中的全部 tokens、sets 和 themes。如果需要保留现有 token 配置，文档建议先从 Tokens 标签页的 Tools → Export 导出备份，再执行导入。

限制与日常管理

与“发布/连接”配套的三个操作，均在发布时的同一位置（文件菜单或 libraries 面板）执行：

• 断开连接（Disconnect）：随时可以在 libraries 面板点击 disconnect 按钮断开某个库。
• 取消发布（Unpublish）：随时可以像发布一样取消发布。注意后果：取消发布会使该库从所有已连接它的文件中断开；其他文件里已经使用过的资产会保留，但不再与这个已取消发布的库保持链接关系。
• 库更新（Library updates）：源文件库有更新时，文档展示了在 libraries 面板查看/处理更新的操作（见 Libraries 文档 中 “Library updates” 一节的配图docs/img/libraries/libraries-updates.webp）。

边界说明：共享库的作用域是“同一团队内的其他文件”。团队里没有可用库时，文档给出的路径是发布其他文件或添加官方 Libraries & templates，除此之外文档未描述跨团队共享的方式。

【免费下载链接】penpotPenpot: The open-source design platform for Product teams that need scalable collaboration.项目地址: https://gitcode.com/GitHub_Trending/pe/penpot