Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Chinese translation for models - Part II #949

Open
wants to merge 5 commits into
base: support/3.0
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions model/Core/Classes/Agent.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,3 +19,11 @@ This is not to be confused with tools that are used to perform tasks.
- name: Agent
- SubclassOf: Element
- Instantiability: Concrete

## Summary @zh-Hans
bact marked this conversation as resolved.
Show resolved Hide resolved

`Agent`代表任何有可能作用于系统的对象。

## Description @zh-Hans

`Agent`类代表任何有可能作用于系统的对象,可以是人、组织、软件代理等,但不能代表用于执行任务的工具。
11 changes: 11 additions & 0 deletions model/Core/Classes/Annotation.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,3 +36,14 @@ The `contentType` property describes the format of the `statement` property.
- type: Element
- minCount: 1
- maxCount: 1

## Summary @zh-Hans

对一个或多个元素断言。

## Description @zh-Hans

`Annotation`是对一个或多个元素的断言。

`contentType`属性描述了`statement`属性的格式。

8 changes: 8 additions & 0 deletions model/Core/Classes/Artifact.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,3 +44,11 @@ such as an electronic file, a software package, a device or an element of data.
- supportLevel
- type: SupportType
- minCount: 0

## Summary @zh-Hans

数字领域内的特定文章或单位。

## Description @zh-Hans

`Artifact`是数字领域中的特定文章或单位,如电子文件、软件包、设备或数据元素。
10 changes: 10 additions & 0 deletions model/Core/Classes/Bom.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,3 +21,13 @@ its composition, licensing information, known quality or security issues, etc.
- name: Bom
- SubclassOf: Bundle
- Instantiability: Concrete

## Summary @zh-Hans

一个用于描述产品特征(来源、组成、许可证等)的SPDX 3.0内容容器。

## Description @zh-Hans

`Bom`是一个用于描述产品特征的SPDX 3.0内容容器。

这个容器可能包括产品内容和组成的详细信息、产品和/或其组成的来源信息、许可证信息、已知质量或安全问题等。
8 changes: 8 additions & 0 deletions model/Core/Classes/Bundle.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,3 +21,11 @@ A bundle is a collection of Elements that have a shared context.
- context
- type: xsd:string
- maxCount: 1

## Summary @zh-Hans

一组共享上下文的`Element`集合。

## Description @zh-Hans

`Bundle`是共享上下文的一组`Element`。
10 changes: 10 additions & 0 deletions model/Core/Classes/CreationInfo.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,3 +40,13 @@ doing so supports reproducible builds.
- createdUsing
- type: Tool
- minCount: 0

## Summary @zh-Hans

提供有关`Element`创建的信息。

## Description @zh-Hans

`CreationInfo`提供有关`Element`的创建者、创建时间和创建方式的信息。

创建的`dateTime`通常是最后一次修改的日期(例如Git提交日期),而不是SPDX数据创建的日期。这样能够支持可重复构建。
12 changes: 12 additions & 0 deletions model/Core/Classes/DictionaryEntry.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,3 +31,15 @@ unique keys.
- value
- type: xsd:string
- maxCount: 1

## Summary @zh-Hans

一个具有关联值的键。

## Description @zh-Hans

用于在SPDX中实现通用字符串映射(也称为关联数组、字典或哈希映射)的类。

每个`DictionaryEntry`包含一个键值对,映射键到其关联值。

要实现字典,这个类应该在一个具有唯一键的集合中使用。
9 changes: 9 additions & 0 deletions model/Core/Classes/Element.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,3 +54,12 @@ and inter-relatable content objects.
- extension
- type: /Extension/Extension
- minCount: 0

## Summary @zh-Hans

派生所有其他SPDX 3.0域类的基础域类。

## Description @zh-Hans

`Element`是一个基本概念的表示,它可以直接与物料清单(BOM)域相关,也可以与BOM域间接相关,是在上下文中表征BOM概念和关系所必需的。
在SPDX 3.0结构中,`Element`是作为所有显式和相互关联的内容对象的一致、统一和互操作基础的基类。
18 changes: 18 additions & 0 deletions model/Core/Classes/ElementCollection.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,3 +40,21 @@ the default.
- minCount: 0
- profileConformance
- type: ProfileIdentifierType

## Summary @zh-Hans

`Element`的集合,不一定具有统一的上下文。

## Description @zh-Hans

`ElementCollection`是`Element`的集合,不一定具有统一的上下文。

需要注意的是,所有`ElementCollection`都必须符合`Core`配置,即使在`profileConformance`属性中未指定`core`配置。

如果未提供`profileConformance`属性,则`core`将作为默认值。

*约束条件*

- 如果`ElementCollection`至少有一个元素,那么它还必须至少有一个`rootElement`。
- `Element`不能是`SpdxDocument`类型。
- `rootElement`不能是`SpdxDocument`类型。
8 changes: 8 additions & 0 deletions model/Core/Classes/ExternalIdentifier.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,3 +38,11 @@ that provides a unique key within an established domain that can uniquely identi
- type: xsd:string
- minCount: 0
- maxCount: 1

## Summary @zh-Hans

SPDX 3.0内容范围之外定义的资源标识符的引用,唯一地标识一个`Element`。

## Description @zh-Hans

`ExternalIdentifier`是一个引用,指向一个在SPDX 3.0内容范围之外定义的资源,提供一个在特定领域内的唯一键,可以唯一标识一个`Element`。
9 changes: 9 additions & 0 deletions model/Core/Classes/ExternalMap.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,3 +34,12 @@ such as its provenance, where to retrieve it, and how to verify its integrity.
- definingArtifact
- type: Artifact
- maxCount: 1

## Summary @zh-Hans

在`SpdxDocument`中使用但在`SpdxDocument`外部定义的`Element`标识符的映射。

## Description @zh-Hans

`ExternalMap`是在`SpdxDocument`中使用但在`SpdxDocument`外部定义的`Element`标识符的映射。
`ExternalMap`提供了关于外部定义的`Element`的详细信息,例如其来源、如何检索它以及如何验证其完整性。
8 changes: 8 additions & 0 deletions model/Core/Classes/ExternalRef.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,3 +30,11 @@ that provides additional context, characteristics or related information about a
- comment
- type: xsd:string
- maxCount: 1

## Summary @zh-Hans

对SPDX 3.0内容范围之外与`Element`相关的资源的引用。

## Description @zh-Hans

`ExternalRef`指向SPDX 3.0内容范围之外的资源,提供关于`Element`的额外上下文、特征或相关信息。
12 changes: 12 additions & 0 deletions model/Core/Classes/Hash.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,3 +33,15 @@ Please note that different profiles may also provide additional methods for veri
- type: xsd:string
- minCount: 1
- maxCount: 1

## Summary @zh-Hans

一组数据的数学计算表示。

## Description @zh-Hans

`Hash`是应用数学算法将任意大小的数据映射到位字符串(哈希值)的过程,是一种不可逆函数。

常用于数据完整性检查。

请注意,其他配置文件可能还会提供额外的方法用于验证特定`Element`子类的完整性。
10 changes: 10 additions & 0 deletions model/Core/Classes/IndividualElement.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,3 +19,13 @@ This class provides the type used by the individuals defined in the Core profile
- name: IndividualElement
- SubclassOf: Element
- Instantiability: Concrete

## Summary @zh-Hans

在核心配置文件中,由个体使用的元素的一个具体子类。

## Description @zh-Hans

个体,如NoneElement和NoAssertionElement,需要引用Element的一个具体子类。

这个类提供了核心配置文件中定义的个体所使用的类型。
11 changes: 11 additions & 0 deletions model/Core/Classes/IntegrityMethod.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,3 +25,14 @@ Please note that different profiles may also provide additional methods for veri
- comment
- type: xsd:string
- maxCount: 1

## Summary @zh-Hans

提供一个独立可复现的机制,允许验证特定的`Element`。

## Description @zh-Hans

`IntegrityMethod`提供一个独立可复现的机制,允许验证与此SPDX文档中数据相关的特定`Element`。这一标识符使接收方能够确定原始`Element`是否有任何更改,并消除对特定`Element`的哪个版本或修改项被引用的困惑。

请注意,其他配置文件可能还会提供额外的方法用于验证特定`Element`子类的完整性。

8 changes: 8 additions & 0 deletions model/Core/Classes/LifecycleScopedRelationship.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,3 +22,11 @@ Certain relationships are sensitive to where they occur in the lifecycle. This
- type: LifecycleScopeType
- minCount: 0
- maxCount: 1

## Summary @zh-Hans

为生命周期中发生的关系提供上下文。

## Description @zh-Hans

某些关系对其在生命周期中的发生位置敏感。该参数通过对关系的上下文信息进行参数化来避免关系泛滥。
24 changes: 24 additions & 0 deletions model/Core/Classes/NamespaceMap.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,3 +63,27 @@ Namespace maps support a variety of relevant use cases such as:
- type: xsd:anyURI
- minCount: 1
- maxCount: 1

## Summary @zh-Hans

前缀和命名空间部分URI之间的映射。

## Description @zh-Hans

`NamespaceMap`允许可序列化`Element`集合的创建者为`Element` ID的特定命名空间部分建议更短的标识符(前缀)。此映射在SPDX内容序列化中使用,提供更易读和更精简的`Element`序列化表示。

有关如何序列化`NamespaceMap`内容的详细信息,请参阅[模型和序列化](../../../serializations.md)以及[spdx-3-model存储库](https://github.com/spdx/spdx-3-model/tree/main/serialization)中各种序列化格式的文件。

`NamespaceMap`支持各种相关的用例,例如:

1. SPDX内容生产者希望使其SPDX 2.X简单样式集合的序列化清晰明确,其中所有内容都是新生成的,并且使用单一前缀-命名空间。SPDX内容消费者希望保留此类生产者提供的`NamespaceMap`。

在这种情况下,消费者可以记录`NamespaceMap`中的前缀,以便后续序列化使用原生序列化格式复现前缀/命名空间。

2. SPDX内容生产者希望在生成内容的多种不同序列化格式中保持前缀使用和理解的一致性。

例如,SBOM生产者希望以JSON-LD和XML格式共享/发布SBOM。该生产者可以使用从单个`NamespaceMap`中获取并在本地可访问的信息,以原生序列化格式指定首选前缀映射。

3. SPDX内容消费者/生产者希望在接收到的SPDX内容经过反序列化、以某种方式修改/扩展并以相同的序列化形式重新序列化的过程中,保持前缀使用的一致性。

在这种情况下,内容中使用的前缀-命名空间映射从原始的原生命名空间/前缀格式转化为内存中的`NamespaceMap`,然后再从`NamespaceMap`转化为生成后的序列化原生命名空间/前缀格式。
8 changes: 8 additions & 0 deletions model/Core/Classes/Organization.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,3 +15,11 @@ An Organization is a group of people who work together in an organized way for a
- name: Organization
- SubclassOf: Agent
- Instantiability: Concrete

## Summary @zh-Hans

为了共同目标而以有组织的方式一起工作的一群人。

## Description @zh-Hans

`Organization`是为了共同目标而以有组织的方式一起工作的一群人。
39 changes: 39 additions & 0 deletions model/Core/Classes/PackageVerificationCode.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,3 +58,42 @@ Required sort order: '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'a', 'b',
- maxCount: 1
- packageVerificationCodeExcludedFile
- type: xsd:string

## Summary @zh-Hans

SPDX 2.X版本兼容的软件包校验方法。

## Description @zh-Hans

此验证方法是为兼容SPDX 2.X而提供的。

除非`Artifact`中的`contentIdentifier`属性无法使用,否则不建议使用此校验码方法。

此校验方法提供了一种独立可复现的机制,根据构成每个软件包且与此SPDX文档中的数据相关联的实际文件(如果SPDX文档包含在软件包中,则排除SPDX文档本身)来识别软件包的特定内容。

此标识符使接收者能够确定原始软件包(进行分析的软件包)中的任何文件是否已更改,并允许将SPDX文档作为软件包的一部分包含在内。

算法:

templist = ""

对于软件包中的所有文件 {
如果文件是 packageVerificationCodeExcludedFile
跳过文件 /* 排除 SPDX 分析文件 */
否则
将"algorithm(file)/n"追加到templist
}

按值升序排列templist

/* 从有序序列中删除分隔符 */
valueslist = 从templist中删除"/n"

如果valueslist为空
hashValue = 0
否则
hashValue = algorithm(valueslist)

其中`algorithm(string)`将哈希算法应用于字符串,并以小写十六进制数字返回结果。

所需排序顺序:'0','1','2','3','4','5','6','7','8','9','a','b','c','d','e','f'(ASCII顺序)
8 changes: 8 additions & 0 deletions model/Core/Classes/Person.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,3 +15,11 @@ A Person is an individual human being.
- name: Person
- SubclassOf: Agent
- Instantiability: Concrete

## Summary @zh-Hans

独立的人类个体。

## Description @zh-Hans

`Person`是独立的人类个体。
9 changes: 9 additions & 0 deletions model/Core/Classes/PositiveIntegerRange.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,3 +27,12 @@ PositiveIntegerRange is a tuple of two positive integers that define a range.
- type: xsd:positiveInteger
- minCount: 1
- maxCount: 1

## Summary @zh-Hans

由两个正整数构成的定义范围的元组。

## Description @zh-Hans

`PositiveIntegerRange`是由两个正整数构成的定义范围的元组。
`beginIntegerRange`必须小于或等于`endIntegerRange`。
14 changes: 14 additions & 0 deletions model/Core/Classes/Relationship.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,3 +52,17 @@ NoAssertionElement individual.
- type: DateTime
- minCount: 0
- maxCount: 1

## Summary @zh-Hans

描述一个或多个元素之间的关系。

## Description @zh-Hans

`Relationship`是一组特征,独特地断言一个`Element`以某种方式与一个或多个其他`Element`相关。

若要明确断言不存在这种关系,`to`属性应包含'NONE'个体而不包含其他元素。

在`to`属性中包含'NONE'和其他元素的`Relationship`是无效的。

若要明确断言不对这种关系的存在进行任何断言,则`to`属性应包含'NOASSERTION'个体。
8 changes: 8 additions & 0 deletions model/Core/Classes/SoftwareAgent.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,3 +16,11 @@ user's authority) to act on a system.
- name: SoftwareAgent
- SubclassOf: Agent
- Instantiability: Concrete

## Summary @zh-Hans

软件代理。

## Description @zh-Hans

`SoftwareAgent`是一个软件程序,它被赋予在系统上执行操作的权限(类似于用户的权限)。
14 changes: 14 additions & 0 deletions model/Core/Classes/SpdxDocument.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,3 +37,17 @@ SpdxDocument element definition.
- dataLicense
- type: /SimpleLicensing/AnyLicenseInfo
- maxCount: 1

## Summary @zh-Hans

可序列化的SPDX `Element`的集合。

## Description @zh-Hans

`SpdxDocument`提供了一种便捷的方式来表达SPDX `Element`集合的信息,这些集合可以作为完整单元被序列化(例如,单个JSON-LD文件中的所有范围内的SPDX数据)。

`SpdxDocument`与任何特定的序列化格式或实例无关。

希望保留的关于该SPDX内容的特定序列化实例的信息不通过`SpdxDocument`表达,而是通过一个表示特定SPDX数据物理序列化实例的关联`Artifact`来表达。

任何SPDX数据的序列化实例都不得包含多个`SpdxDocument`元素定义。
8 changes: 8 additions & 0 deletions model/Core/Classes/Tool.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,3 +15,11 @@ A Tool is an element of hardware and/or software utilized to carry out a particu
- name: Tool
- SubclassOf: Element
- Instantiability: Concrete

## Summary @zh-Hans

用于执行特定功能的硬件和/或软件元素。

## Description @zh-Hans

`Tool`是用于执行特定功能的硬件和/或软件元素。
Loading
Loading