PopClip Extensions

개발자 문서가 이동했습니다! 최신 문서는 https://www.popclip.app/dev/를 참조하십시오.

---

팝 클립 확장

이 저장소에는 공식 Popclip Extensions 디렉토리에 게시 된 많은 확장자에 대한 소스 파일이 포함되어 있습니다.

저장소 레이아웃

기본 폴더 :

• source - 출판 된 확장의 소스 (ME에 의해 유지되고 지원됨)
• contrib 미공개 / 사용자 조정 / 실험 / 틈새 / 보관 된 확장을위한 폴더 (유지 보수 또는 지원되지 않음)

기여

풀 요청을 통해 기존 확장에 대한 수정 및 개선을 환영합니다.

디렉토리에 새로운 확장을 기여하려면 선호하는 방법은 자신의 리포지토리에서 디렉토리 서버에 직접 제출하는 것입니다. Extension의 디렉토리 페이지는 Repo에 연결되며 확장자를 직접 유지하고 업데이트합니다. 제출 지침은 mailto : [email protected]으로 저에게 연락하십시오.

또는이 리포지토리의 contrib 폴더의 PULL 요청으로 새로운 확장을 제출할 수 있습니다. (내가 게시하면 source 폴더로 직접 옮길 것입니다.)

품질 지침

모든 제출물을 게시하지는 않을 것입니다. 게시 할 확장은 고품질이어야하며 다음 기준을 충족해야합니다.

• 확장은 명확하고 단일 목적을 가지고 있으며 일반 청중에게 유용합니다.
• 사용자의 최소 구성만으로도 "Just Work"확장.
• 다른 확장의 명명 스타일에 맞는 잘 선택된 이름. 이름은 일반적으로 하나 또는 두 단어입니다. 예를 들어 "instapaper로 보내기"가 아닌 "instapaper"; "대문자"가 아닌 "대문자"가 아닙니다.
• 행동을 명확하게 나타내는 좋은 아이콘. (디자이너가 아닌 경우 iconify 또는 sf 기호를 사용하십시오.)
• 구성에서 확장이 무엇을하는지에 대한 명확하고 간결한 일회용 description . 이것이 확장 이름 옆에있는 웹 사이트에 나타납니다.
• 가장 간단한 확장 기능 외에도 확장자 사용 방법을 간략하게 설명하는 readme.md 파일, 특히 특수 기능 및 구성 옵션을 언급하는 것입니다. readme의 맨 아래에 Changelog를 추가하십시오.
• API 키가 필요한 경우, 지침과 키를 얻기위한 링크와 함께 Readme에 명확하게 문서화해야합니다.
• 무의미한 스크립트가 없습니다. 예를 들어, Bash 스크립트를 사용하여 url 작업 만 사용할 수있을 때 URL을 열지 마십시오.
• 특정 동작이 실제로 쉘 스크립트 또는 사과 스크립트 여야하지 않는 한 쉘 스크립트 또는 사과 스크립트 작업보다 JavaScript 액션을 선호합니다.
• 쉘 스크립트 확장자는 최신 MACOS의 기본 설치에서 상자 밖으로 작동해야합니다. 사용자가 추가 스크립팅 언어 나 라이브러리를 설치 해야하는 확장 기능을 게시하지 않습니다.
• README를 사용하여 저자로서 자신에게 신용을주고 다른 기고자, 오픈 소스 라이브러리 또는 아이콘 제작자를 인정하십시오.
• 편집 된 바이너리가 없습니다. 모든 제출물은 소스 코드 전용이어야합니다.
• 웹 사이트 또는 앱과 상호 작용하는 확장자는 구성에 app 사전이 있어야하며 name 및 link 필드를 정의해야합니다. 이름은 확장자 설명에 자동으로 연결됩니다.
• 타사 MACOS 앱과 함께 작동하는 확장의 경우, bundleIdentifiers 키가 checkInstalled: true 옵션도 사용해야합니다.
• 저작권을 우회하거나 월급 벽을 물리 치기를 목표로하는 확장은 없습니다.
• 주로 저작권이있는 콘텐츠를 색인화하는 급류 / 파일 링 사이트에 대한 링크가 없습니다.
• "전화 집"은 사용자 데이터를 수집하거나 사용자 시스템을 어떤 식 으로든 수정하는 것은 없습니다.
• 불법적이거나 유해하거나 할머니에게 보여주지 않을 것입니다.
• 위의 목록은 철저하지 않으며 다른 이유로 제출을 거부 할 권리가 있습니다.

모든 말로 ... 연장을 제출하십시오! 나는 당신이 무엇을 생각해 내는지 기대하고 있습니다.

크레딧

크레딧은 개별 Extension ReadMe 파일에 포함됩니다.

특허

모든 소스 코드는 Extension ReadMe 파일에 달리 명시되지 않는 한 MIT 라이센스 (License.txt)에 게시됩니다.

changelog

개별 changelogs는 확장자 readme 파일에 포함됩니다.