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

單個更改程序包含在“擴展名”文件中。