PopClip Extensions Download - PopClip Extensions Quellcode Download

PopClip Extensions

Anderer Quellcode

1.0.0

Herunterladen

Entwicklerdokumentation hat sich bewegt! Weitere Informationen finden Sie unter https://www.popclip.app/dev/.

Popclip -Erweiterungen

Dieses Repository enthält die Quelldateien für viele der im offiziellen Popclip -Erweiterungsverzeichnis veröffentlichten Erweiterungen.

Repository -Layout

Die Hauptordner:

source - Quellen für die veröffentlichten Erweiterungen (von mir gepflegt und unterstützt)
contrib - Ordner für unveröffentlichte / benutzerkontributierte / experimentelle / nische / archivierte Erweiterungen (nicht gewartet oder unterstützt)

Beitragen

Korrekturen und Verbesserungen der vorhandenen Erweiterungen sind durch Pull -Anfrage willkommen.

Um neue Erweiterungen in das Verzeichnis beizutragen, besteht die bevorzugte Möglichkeit darin, es direkt an den Verzeichnisserver von Ihrem eigenen Repo zu senden. Die Verzeichnisseite der Erweiterung wird mit Ihrem Repo verknüpft und Sie werden die Erweiterung selbst unterhalten und aktualisieren. Kontaktieren Sie mich unter Mailto: [email protected] für die Einreichungsanweisungen.

Alternativ können neue Erweiterungen per Pull -Anfrage im contrib -Ordner dieses Repo eingereicht werden. (Wenn ich es veröffentliche, werde ich es selbst in den source verschieben.)

Qualitätsrichtlinien

Bitte beachten Sie, dass ich nicht alle Einreichungen veröffentlichen werde. Zu veröffentlichte Erweiterungen müssen von hoher Qualität sein und die folgenden Kriterien erfüllen:

Die Erweiterung hat einen klaren Zweck und ist für ein allgemeines Publikum nützlich.
Die Erweiterung "funktioniert nur", mit nur minimaler Konfiguration durch den Benutzer.
Ein gut ausgewählter Name, entspricht dem Namensnamen anderer Erweiterungen. Namen sind normalerweise ein oder zwei Wörter; Zum Beispiel ✅ "Instapaper", nicht "an Instapaper" senden; ✅ "Großbuchstaben" nicht "in Großbuchstaben konvertieren".
Ein gutes Ikone, das die Aktion deutlich darstellt. (Verwenden Sie Symbole oder SF -Symbole, wenn Sie kein Designer sind.)
In der Konfiguration eine klare, prägnante description der Ein- und Ein-Versicherung der Erweiterung. Dies erscheint auf der Website neben dem Erweiterungsnamen.
Fügen Sie abgesehen von den einfachsten Erweiterungen eine readme.md -Datei hinzu, in der kurz erläutert wird, wie die Erweiterung verwendet wird, insbesondere in Bezug auf spezielle Funktionen und Konfigurationsoptionen. Fügen Sie am unteren Rand des Readme einen Changelog hinzu.
Wenn API -Schlüssel benötigt werden, sollte dies im Readme mit Anweisungen und einem Link, um den Schlüssel zu erhalten, deutlich dokumentiert werden.
Keine sinnlosen Skripte. Verwenden Sie beispielsweise kein Bash -Skript, um eine URL zu öffnen, wenn Sie nur die url -Aktion verwenden können.
Bevorzugt JavaScript -Aktionen gegenüber Shell -Skript- oder AppleScript -Aktionen, es sei denn, die jeweilige Aktion muss wirklich ein Shell -Skript oder ein AppleScript sein.
Shell-Skript-Erweiterungen müssen bei einer Standardinstallation der neuesten MacOS out-of-the-Box funktionieren. Ich werde keine Erweiterungen veröffentlichen, bei denen der Benutzer zusätzliche Skriptsprachen oder Bibliotheken installieren muss.
Verwenden Sie das Readme, um sich selbst als Autor zu Kredit zu geben und alle anderen Mitwirkenden, Open -Source -Bibliotheken oder Icon -Schöpfer zu bestätigen.
Keine zusammengestellten Binärdateien. Alle Einsendungen dürfen nur Quellcode sein.
Erweiterungen, die mit einer Website oder App interagieren, sollten über ein app -Wörterbuch in der Konfiguration verfügen und die name und link definieren. Der Name wird automatisch in der Erweiterungsbeschreibung verknüpft.
Für Erweiterungen, die mit einer MacOS -App von Drittanbietern funktionieren, sollte auch der Schlüsselbund bundleIdentifiers mit dem checkInstalled: true Option verwendet werden.
Keine Erweiterungen, die darauf abzielen, das Urheberrecht zu umgehen, Paywalls usw. zu besiegen, usw.
Keine Links zu Torrent- / Filesharing -Websites, die vorwiegend urheberrechtlich geschützte Inhalte indexieren.
Nichts, was "Telefone zu Hause" sammelt, Benutzerdaten sammelt oder das System des Benutzers in irgendeiner Weise verändert.
Nichts Illegales oder Schädliches oder das würden Sie Ihrer Großmutter nicht zeigen.
Die obige Liste ist nicht erschöpfend und ich behalte das Recht, eine Einreichung aus einem anderen Grund abzulehnen.

Mit all dem gesagt ... bitte senden Sie Ihre Erweiterung! Ich freue mich darauf zu sehen, was Sie sich einfallen lassen.

Credits

Credits sind in den individuellen Erweiterungs -Readme -Dateien enthalten.

Lizenz

Der gesamte Quellcode wird unter der MIT -Lizenz (lizenz.txt) veröffentlicht, sofern in den Erweiterungs -ReadMe -Dateien nichts anderes angegeben ist.