PopClip Extensions

¡La documentación del desarrollador se ha movido! Vea https://www.popclip.app/dev/ para obtener los últimos documentos.

---

Extensiones de poplip

Este repositorio contiene los archivos de origen para muchas de las extensiones publicadas en el directorio oficial de extensiones de popclip.

Diseño de repositorio

Las carpetas principales:

• source : fuentes de las extensiones publicadas (mantenidas y respaldadas por mí)
• contrib - Carpeta para extensiones no publicadas / tratadas con usuarios / experimentales / nicho / archivados (no mantenidos o admitidos)

Que contribuye

Las correcciones y mejoras en las extensiones existentes son bienvenidas a través de la solicitud de extracción.

Para contribuir con nuevas extensiones al directorio, la forma preferida es que lo envíe directamente al servidor de directorio desde su propio repositorio. La página de directorio de la extensión estará vinculada a su repositorio y usted mantendrá y actualizará la extensión usted mismo. Póngase en contacto conmigo en Mailto: [email protected] para obtener las instrucciones de envío.

Alternativamente, se pueden presentar nuevas extensiones mediante solicitud de extracción en la carpeta contrib de este repositorio. (Si lo publico, lo moveré a la carpeta source ).

Pautas de calidad

Tenga en cuenta que no publicaré todas las presentaciones. Las extensiones a publicar deben ser de alta calidad y cumplir con los siguientes criterios:

• La extensión tiene un propósito claro y único para una audiencia general.
• La extensión "simplemente funciona", con una configuración mínima solo por parte del usuario.
• Un nombre bien elegido, de acuerdo con el estilo de nombres de otras extensiones. Los nombres suelen ser una o dos palabras; por ejemplo ✅ "Instapaper", no "Enviar a Instapaper"; ✅ "upcase" no "convertir a mayúsculas".
• Un buen ícono, que representa claramente la acción. (Use los símbolos Iconify o SF si no es un diseñador).
• En la configuración, una description clara, concisa y de una oración de lo que hace la extensión. Esto es lo que aparece en el sitio web junto al nombre de la extensión.
• Además de las extensiones más simples, incluya un archivo readme.md que explique brevemente cómo usar la extensión, particularmente mencionando cualquier característica especial y opción de configuración. Agregue un CangeLog en la parte inferior del Readme.
• Cuando se necesitan claves API, esto debe documentarse claramente en el ReadMe con instrucciones y un enlace para obtener la clave.
• No hay guiones sin sentido. Por ejemplo, no use un script bash para abrir una URL cuando puede usar la acción url .
• Favorecer las acciones de JavaScript sobre las acciones de shell script o AppleScript a menos que la acción particular realmente necesite ser un script o applecript de shell.
• Las extensiones de script de Shell deben funcionar fuera de la caja en una instalación predeterminada de los últimos macOS. No publicaré extensiones que requieran que el usuario instale idiomas o bibliotecas de secuencias de comandos adicionales.
• Use el ReadMe para darse crédito a usted mismo como autor y reconocer a cualquier otro contribuyente, bibliotecas de código abierto o creadores de iconos.
• No hay binarios compilados. Todas las presentaciones deben ser solo código fuente.
• Las extensiones que interactúan con un sitio web o aplicación deben tener un diccionario app en la configuración, definiendo los campos name y link . El nombre se vinculará automáticamente en la descripción de la extensión.
• Para las extensiones que funcionan con una aplicación MacOS de terceros, la tecla bundleIdentifiers con la opción checkInstalled: true también debe usarse también.
• No hay extensiones destinadas a eludir los derechos de autor, derrotar a los paredes de pago, etc.
• No hay enlaces a los sitios de torrent / archivo de archivo que indexan predominantemente contenido con derechos de autor.
• Nada que "llama a casa", recopila datos del usuario o modifica el sistema del usuario de ninguna manera.
• Nada ilegal o dañino o que no le mostrarías a tu abuela.
• La lista anterior no es exhaustiva y me reservo el derecho de rechazar una presentación por cualquier otro motivo.

Con todo lo dicho ... ¡por favor envíe su extensión! Espero ver lo que se te ocurre.

Créditos

Los créditos se incluyen en los archivos ReadMe de extensión individual.

Licencia

Todo el código fuente se publica bajo la licencia MIT (License.txt) a menos que se indique lo contrario en los archivos ReadMe de extensión.

Colegio de cambios

Los coladores de cambios individuales se incluyen en los archivos ReadMe de extensión.