PopClip Extensions

開発者のドキュメントが移動しました！最新のドキュメントについては、https：//www.popclip.app/dev/を参照してください。

---

PopClip拡張機能

このリポジトリには、公式のPopClip Extensionsディレクトリに公開されている多くの拡張機能のソースファイルが含まれています。

リポジトリレイアウト

メインフォルダー：

• source - 公開された拡張機能のソース（私によって維持およびサポートされています）
• contrib未発表 /ユーザーコントリビュー済み /実験 /ニッチ /アーカイブエクステンション用のフォルダー（維持またはサポートされていません）

貢献

既存の拡張機能の修正と改善は、プルリクエストを介して大歓迎です。

新しい拡張機能をディレクトリに提供するために、お好みの方法は、独自のリポジトリからディレクトリサーバーに直接送信することです。拡張機能のディレクトリページはリポジトリにリンクされ、拡張機能を自分で維持および更新します。送信手順については、mailto：support@pi​​lotmoon.comで私に連絡してください。

または、このリポジトリのcontribフォルダーのプルリクエストで新しい拡張機能を提出することもできます。 （私がそれを公開した場合、私はそれを自分でsourceフォルダーに移動します。）

品質ガイドライン

すべての提出物を公開するわけではありません。公開される拡張機能は高品質であり、次の基準を満たす必要があります。

• 拡張機能には明確で単一の目的があり、一般的な視聴者にとって有用です。
• 拡張機能は「Just Works」で、ユーザーによる最小限の構成のみを備えています。
• 他の拡張機能の命名スタイルに合わせて、よく選択された名前。通常、名前は1つか2つの単語です。たとえば、「Instapaper」、「Instapaperに送信」ではなく "。 「「大文字」ではない「大文字」ではありません。
• アクションを明確に表す優れたアイコン。 （あなたがデザイナーでない場合は、ICONIFYまたはSFシンボルを使用してください。）
• 構成では、拡張機能の明確で簡潔な1文のdescription 。これは、拡張機能名の横にあるWebサイトに表示されるものです。
• 最も単純な拡張機能とは別に、拡張機能の使用方法、特に特別な機能と構成オプションに言及する方法を簡単に説明するreadme.mdファイルを含めます。 readmeの下部に変更ログを追加します。
• APIキーが必要な場合は、これをreadmeに明確に文書化する必要があります。指示とキーを取得するためのリンクがあります。
• 無意味なスクリプトはありません。たとえば、 urlアクションを使用できる場合は、BASHスクリプトを使用してURLを開きません。
• 特定のアクションが実際にシェルスクリプトまたはApplescriptである必要がない限り、シェルスクリプトまたはApplescriptアクションに対するJavaScriptアクションを支持します。
• シェルスクリプト拡張機能は、最新のMacOSのデフォルトインストールですぐに動作する必要があります。ユーザーが追加のスクリプト言語またはライブラリをインストールする必要がある拡張機能を公開しません。
• readmeを使用して、著者として自分自身に信用を与え、他の貢献者、オープンソースライブラリ、またはアイコンクリエイターを認めます。
• コンパイルされたバイナリはありません。すべての提出物はソースコードのみでなければなりません。
• Webサイトまたはアプリと対話する拡張機能には、 nameとlinkフィールドを定義するapp辞書が設定に辞書がある必要があります。名前は、拡張機能の説明で自動的にリンクされます。
• サードパーティのMacOSアプリで動作する拡張機能の場合、 checkInstalled: trueオプションを使用したbundleIdentifiersキーも同様に使用する必要があります。
• 著作権を回避したり、ペイウォールを破ったりすることを目的とした拡張機能はありません。
• 主に著作権で保護されたコンテンツをインデックスするトレント /ファイルシェアリングサイトへのリンクはありません。
• 「携帯電話」、ユーザーデータを収集したり、ユーザーのシステムを変更したりすることはありません。
• 違法または有害なことや、祖母に見せないものは何もありません。
• 上記のリストは網羅的ではなく、私は他の理由で提出を拒否する権利を留保します。

とは言っても...拡張機能を提出してください！私はあなたが思いついたものを見るのを楽しみにしています。

クレジット

クレジットは、個々の拡張機能readmeファイルに含まれています。

ライセンス

すべてのソースコードは、拡張機能readmeファイルで別段の記載されていない限り、MITライセンス（License.txt）に基づいて公開されます。

Changelog

個々の変更ログは、拡張機能readmeファイルに含まれています。