欧洲语言网格贡献者指南

### 欧洲语言网格贡献者指南 在欧洲语言网格（ELG）中，作为提供者为平台贡献服务和资源是一个涉及多个步骤和要求的过程。以下将详细介绍从编辑元数据到上传数据文件，再到服务集成的整个流程。 #### 1. 元数据编辑 元数据编辑是贡献资源的重要第一步。编辑器会引导用户使用适当的值填写所有必需元素。对于元数据元素，提供了帮助提示和示例，并且根据元素的数据类型使用不同的编辑控件。 - **下拉列表与动态建议**：对于受控词汇表元素，使用下拉列表显示。对于具有许多值的词汇表（如语言、服务功能等），采用下拉列表与用户输入文本时的建议值相结合的方式。这种下拉列表和动态建议值的组合也用于提高规范化程度。例如，关键字等元素允许自由文本输入，但当用户输入时，会弹出建议匹配值，这些值是其他记录中同一元素之前使用过的值，“推动”用户选择相同的值而非略有不同的变体。 - **减少重复实体**：同样的查找机制用于减少相关实体（如代理、项目、文档、许可证和其他资源）的重复机会。ELG 模式要求这些实体提供一组最少信息，包括名称/标题，以及可选的标识符和元数据元素，这些元素可以唯一地区分它与类似实体（例如，人员的电子邮件、组织的网站、许可证的带文本的 URL 等）。因此，当通过编辑器添加相关实体时，用户输入名称/标题，会显示匹配的条目（如果有）供其选择；如果没有，则会提示用户填写上述所需元素。同样的元数据元素集也用于导入元数据记录时唯一标识相关实体。 - **保存草稿与验证**：通过编辑器，提供者可以选择保存不完整的元数据记录（“草稿”），此时仅验证元数据元素的数据类型（例如，验证输入的是否为有效 URL）。当决定正式保存元数据记录时，使用 yup 库进行验证，至少实现与导入元数据文件时相同的规则。如果出现错误，会显示描述错误及其发生位置的消息，点击错误消息，用户会被转到错误发生的位置。 #### 2. 上传和管理数据文件 数据文件，即包含资源内容的物理文件，必须以 ZIP 文件的形式上传。提供者可以在上传 XML 文件时作为第一步上传数据文件，也可以在使用编辑器进行编辑的过程中上传。编辑器包含一个名为“数据”的选项卡，用户可以通过该选项卡管理文件（上传、替换和删除）。 - **关联数据文件与分发形式**：资源可能有多种可分发形式（“分发”），例如不同的文件格式（如 PDF、XML 或 TXT 文件）。ELG 支持为同一资源上传多个数据文件。因此，当用户上传多个数据文件包时，会提示将每个包与相应的分发形式关联起来（即包含描述特定文件集大小和格式的元数据的分发形式）。此操作通过在“分发”选项卡上选择特定包来完成。 #### 3. 管理目录条目 ELG 平台为具有“提供者”角色的用户提供了一个“网格”（仪表盘），通过该仪表盘，用户可以访问和管理他们创建的目录项，还可以创建新项。提供者的仪表盘是消费者仪表盘的扩展，增加了该用户创建的记录数量计数器以及指向编辑器、XML 上传和 XML 验证工具的链接。 - **“我的项目”页面操作**：用户可以通过专门的页面（“我的项目”）管理他们创建的元数据记录，并根据其用户权限和记录的发布状态执行以下操作：编辑元数据记录、提交记录以供发布、为已发布的记录创建新版本、复制元数据记录（以便用作模型创建类似记录）、删除尚未发布的元数据记录，以及请求取消发布他们的一条记录。“我的项目”页面是目录的聚焦版本，根据每个用户的角色过滤记录，并且也实现了与主目录页面类似的浏览和搜索功能。 #### 4. 验证和发布元数据记录 个人添加的元数据记录在发布到目录之前，需要按照 ELG 发布生命周期进行验证过程。对于与 ELG 兼容的服务和带有上传数据文件的资源，进行技术/元数据和法律验证；对于所有其他元数据记录，仅进行元数据级别的验证。与 ELG 兼容的服务还需要完成在 ELG 平台上注册服务所需的一系列操作。 - **验证流程**：验证者可以通过“验证者网格”，特别是“我的验证”页面访问分配给他们的元数据记录。验证表单包含验证者可以添加内部注释的字段（仅对其他验证者可见），对于被拒绝的记录，还有一个字段用于记录原因和建议的更改，这些信息会传达给提供者进行更正。提供者可以查看更改并重新提交记录，这将启动新一轮的验证，直到最终批准。当元数据记录得到负责验证者的批准后，会自动在公共目录中可见。 #### 5. ELG 兼容服务的技术要求 ##### 5.1 内部 LT API 规范 ELG 内部 LT API 与公共 API 密切相关，公共 API 是内部 API 的简化衍生版本。虽然内部和公共 API 都使用相同的 JSON 消息进行输入和输出，但内部 API 严格围绕每个处理任务的单个 HTTP 请求