PopClip Extensions

开发人员文档已移动！有关最新文档，请参见https://www.popclip.app/dev/。

---

popclip扩展

该存储库包含官方POPCLIP扩展目录中发布的许多扩展名的源文件。

存储库布局

主要文件夹：

• source - 已发布扩展的来源（我维护和支持）
• contrib - 未发布 /用户分配 /实验 /利基 /存档扩展的文件夹（未维护或支持）

贡献

欢迎通过拉动请求进行修复和改进现有扩展。

为了为目录贡献新的扩展名，首选的方法是让您从自己的存储库中直接提交给目录服务器。扩展名的目录页面将链接到您的存储库，您将自己维护和更新扩展名。请通过mailto与我联系：support@pi​​lotmoon.com以获取提交说明。

另外，可以通过拉动请求在此存储夹的contrib文件夹中提交新扩展名。 （如果我发布它，我会自己将其移至source文件夹。）

质量指南

请注意，我不会发布所有提交。要发布的扩展必须具有高质量，并符合以下标准：

• 该扩展名具有清晰，单一的目的，对普通受众很有用。
• 扩展名为“ Just Works”，仅具有用户最小的配置。
• 一个精心挑选的名称，与其他扩展的命名风格保持一致。名字通常是一个或两个单词；例如✅“ Instapaper”，而不是“发送到Instapaper”； ✅“大写”不是“转换为大写”。
• 一个好的图标，显然代表了动作。 （如果您不是设计师，请使用Iconify或SF符号。）
• 在配置中，对扩展程序的作用清晰，简洁，一句description 。这就是扩展名称旁边的网站上出现的内容。
• 除了最简单的扩展名外，还包括一个readme.md文件，简要说明了如何使用扩展名，尤其是提及任何特殊功能和配置选项。在读书文件的底部添加一个更换式的。
• 在需要API键的地方，应清楚地记录在读书中，并带有指令和链接以获取密钥。
• 没有毫无意义的脚本。例如，当您只能使用url操作时，请勿使用bash脚本打开URL。
• 除非特定操作确实需要是Shell脚本或AppleScript，否则偏爱JavaScript操作而不是Shell脚本或AppleScript操作。
• Shell脚本扩展名必须在最新MACOS的默认安装上进行开箱即用。我不会发布要求用户安装其他脚本语言或库的扩展名。
• 使用Readme作为作者表示赞赏，并确认任何其他贡献者，开源库或图标创建者。
• 没有编译的二进制文件。所有提交都必须仅是源代码。
• 与网站或应用相互作用的扩展程序应在配置中具有app字典，以定义name和link字段。该名称将在扩展描述中自动链接。
• 对于与第三方MacOS应用程序一起使用的扩展程序，还应使用带有CheckIndStall的bundleIdentifiers键checkInstalled: true选项也应使用。
• 没有针对版权，击败付费墙等的扩展名。
• 没有与索引索引的洪流 /文件共享站点的链接。
• 没有什么可以“打电话回家”，收集用户数据或以任何方式修改用户的系​​统。
• 没有任何非法或有害的人，也不会向祖母展示。
• 上面的列表并不详尽，我保留出于任何其他原因拒绝提交的权利。

话虽如此...请提交您的扩展名！我期待看到您的想法。

学分

积分包含在单个扩展名读数文件中。

执照

除Extension ReadMe文件中另有说明，否则所有源代码均在MIT许可证（License.txt）下发布。

ChangElog

单个更改程序包含在“扩展名”文件中。