使用推荐的文件格式

每个图表应包含以下格式的文件

• 栅格图，始终使用可移植网络图形 (.png)。文档构建过程会使用这些文件。

• 矢量图，通常使用可缩放矢量图形 (.svg)。大多数绘图工具都支持编辑这些文件。

• 原始文件，通常是工具的本机格式。

至少，每个图表必须包含一个 .png 和 .svg 文件。

此外，添加到图表中的任何外部模板或对象也应为 .svg 文件，以便审阅者可以编辑图表的各个元素。

注意

为单个元素使用 .svg 文件，可能会在使用与原始创建图表的工具不同的工具编辑图表时导致渲染问题。

文件名

贡献者必须创建独特且有意义的文件名，以区分不同的图表。例如，文件名 cg-workflow-digram.png。 cg 表示该图表属于贡献者指南，缩写词是通过取 OpenStack 书籍名称的首字母缩写而创建的。 workflow-diagram.png 提供了关于图表内容的描述，以及文件类型扩展名。

其他文件指南

• 文件必须保存为透明背景。

• 文件必须保存为横向文档样式。

• 图表的宽度和高度不应超过 900pt。