daploader 0.0.9

结构

• <package_name>-<version>/

  • assistants/

    • {crt,mod,prep,task}/

      • <package_name>.yaml和可选的<package_name>/*.yaml

  • files/

    • {crt,mod,prep,task,snippets}/

      • <package_name>/

        • 您的助手(s)所需的其他文件（脚本、模板等）

  • icons/

    • {crt,mod,prep,task,snippets}/

      • <package_name>.{svg,png…}

  • snippets/

    • <package_name>.yaml和可选的<package_name>/*.yaml

  • doc/

    • <package_name>/

      • LICENSE或COPYING文件

      • README

      • 其他文档

  • meta.yaml

    • 元数据

基本上，只有 meta.yaml 是必需的，但仅有 meta.yaml 的 dap 没有意义。所有内容都封装在 tar.gz 归档文件中，并重命名为 <package_name>-<version>.dap。.yaml 和图标文件扩展名（目前只有 .svg 和 .png）必须是小写。归档应包含一个名为 <package_name>-<version> 的顶级目录。

meta.yaml

package_name: foo # required
version: 1.0.0 # required
license: GPLv2 # required
authors: [Bohuslav Kabrda <bkabrda@mailserver.com>, ...] # required
homepage: https://github.com/bkabrda/assistant-foo # optional
summary: Some brief one line text # required
bugreports: <a single URL or email address> # optional
description: |
    Some not-so-brief optional text.
    It can be split to multiple lines.

• 包名 可以包含小写字母（仅限 ASCII）、数字、下划线和破折号（但只能以字母或数字开头和结尾），必须是唯一的，DevAssitant 本身已保留了一些名称（例如 python, ruby）

• 版本 依照此模式：<num>[.<num>]*[dev|a|b]，其中 1.0.5 < 1.1dev < 1.1a < 1.1b < 1.1

• 许可证 通过 Fedora 中使用的许可证标签指定 https://fedoraproject.org/wiki/Licensing:Main?rd=Licensing#Good_Licenses

• 作者 是作者列表，包括他们的电子邮件地址（_at_ 可以用来代替 @）

• 主页 是指向现有网页的 URL，该网页描述了 dap 或包含代码（例如示例），仅允许 http(s) 或 ftp，不允许 IP 地址

• 摘要 和 描述 在给定的示例中是自我描述的

• 错误报告 定义了用户应向何处报告错误，可以是 URL（问题跟踪器）或电子邮件地址（邮件列表或个人）