Gitlab SVGs (英语)
这个软件包管理了 GitLab 的全部 SVG 资产,方法是从图标中创建 SVG 示意图,并优化 SVG 插图.
预览 SVG 库
浏览、参考和搜索 GitLab 设计系统 网站:
或者,看看他们 当地例如, http://localhost:2018/product-foundations/iconography-directory (中文(中国大陆) )。 。 。 .
所需资源
- 您将需要 线条 财务报告和审定财务报表 节点 已安装。 在Mac上,你可以安装线条
brew install yarn。 。 。 . - 第一次,或从
main分支, 使用yarn install以安装最新的依赖. - 确保你在
packages/gitlab-svgs子目录.
图标
yarn run svg - 构建SVG图案并优化插图.
所有输出保存到 dist 我们主要应用程序中引用的文件夹 。 这个 dist 文件夹已生成, 但没有被承诺 .
添加图标或插图
-
添加第三方标志或商标的,参见: 本节。 。 。 .
-
审查下列文件:
-
有最新消息吗
main在本地副本中的分支 设计. gitlab.com ,然后创建一个新的本地分支.# Retrieve the latest updates git pull # Create a new local branch git checkout -b new-branch-name -
通过运行确定您的依赖关系是否更新
yarn install。 。 。 . -
导出图标或插图为
.svg文档中 :- 图标放在
sprite_icons文件夹. 在导出图标时阅读下面的指令。 。 。 . - 说明放在
illustrations/文件夹。 插图类有子文件夹,如空状态或标志.
- 图标放在
-
替换十六进制
fill, (中文(简体) ),stroke,以及stroke-width示例中的数值--gl-illustration-*设计标志,因此适应了暗模式. 跟着 插图导出指南。 。 。 . -
如果您在导出时没有压缩 SVG, 您可以使用 塞尔维亚 在导出后优化它.
# Optimize our `huge_test.svg` file yarn run svgo ./path/to/huge_test.svg -
对于图标,添加或更新图标的条目
sprite_icons/icons.meta.json(以字母顺序排列),使用来自Figma组件的关键词和描述. -
添加一个 更改列表 联 合 国
@gitlab/svgs包件带有小起伏. -
添加新 SVG 后运行
yarn run svg用于重建dist文件夹,然后 预览 他们. -
如果您对新/已修改的 SVG 满意, 请承诺并推进您的更改并创建合并请求 .
# After committing your changes, use this to create a remote branch. A link will then be available to create the merge request. git push -u origin new-branch-name -
将合并请求指定给维护者 GitLab 服务器 项目. 您可以在 GitLab项目概况页。 。 。 .
添加第三方标志或商标
- 见 gitLab 添加第三方商标的程序 在手册中.
- 将核定资产置入
/illustrations/third-party-logos目录.
从 Figma 导出图标
图标只有在合并为 GitLab 产品图标 在 Figma 中存档。 这保证了被导出的是图标的最终版本,如果有需要,导出设置会被保留给开发者交接.
- 确认图标跟随 图标设计准则。 。 。 .
- 确保图标周围的父框架没有背景填充.
- 选择图标并在右侧属性面板中添加 SVG 作为导出选项。 无论您是否使用高级 SVG 导出插件, 都应该这样做 。 如果您想在导出时优化图标,则使用以下进程,否则通过属性面板导出图标并跳到下一步 .
- 在文本编辑器中打开所产生的 SVG 文件并 :
- 删除
fill="none"从主窗口<svg>键. - 添加一个
viewBox匹配图标框架的属性,或者viewBox="0 0 16 16"或者说viewBox="0 0 12 12"如果不见了 法格玛出口通常不包括在内. - 删除任何
<desc>或者说<clipPath>要素.
- 删除
- 添加新 SVG 后运行
yarn run svg用于重建dist文件夹.
公司或产品的品牌图标可能具有具体的颜色要求,应从 brand-例如, brand-slack.svg。这些图标可能与 fill="#000" 防止色彩被覆盖.
Figma 代码连接中的映射图标
每个图标有一个 代码连接 条目,以便在 Figma Dev Mode 中选择它 <gl-icon name="…" /> 片断.
-
在图标的法格玛分支合并为 GitLab 产品图标 文件,为图标添加条目
icon.figma.batch.json,使用图标node-id从合并文件。 节点ID合并后会改变分行,所以不要使用分行的分行. 添加一个"size"非 16px 图标的字段"size": 12。 。 。 . -
合并请求合并后,设计系统小组的一名成员将出版地图
packages/gitlab-ui文件夹。 这个figma:connect脚本无法从寄存器根获取 。 出版需要.figma.env文件夹中的文件FIGMA_ACCESS_TOKEN拥有file_content:read财务报告和审定财务报表file_code_connect:write瞄准镜。 见.figma.env.exampleA级403 Token expired错误表示需要重新生成符号 .# From the repository root cd packages/gitlab-ui # Validate the mappings yarn figma:connect publish --dry-run # Publish the mappings to Figma yarn figma:connect publish --force -
在Figma Dev Mode中,选择图标并验证其片断出现.
文件图标
此软件包还捆绑基于文件图标 PKief/vscode-材料-icon-主题。 。 。 .
在建设CI期间,采取了以下步骤:
- vscode-material-icon-them的下载基于以下版本: 正在构建 scripts/ file icons version。 。 。 .
- 然后使用的所有文件类型 src/ file icon map.js (中文(简体) ) 复制到
file_icons文件夹. - 他们从那里被捆绑在图标上
- 未使用的文件图标被复制到
file_icons_unused
出版新版本
发布新版本的软件包,比如 @gitlab/svgs,我们使用
变化。学习如何 创建
更改和发布软件包。 。 。 .
捐款
GitLab是一个开源项目,我们高兴地接受社区捐款。 请参考 捐款额 详细情况.