Crea tu propia extensión personalizada para PopClip

PopClip es una de nuestras aplicaciones favoritas en Mactuts + y una de las razones por las cuales es su soporte para extensiones. Puede realizar acciones en el texto seleccionado usando PopClip que lo hace extremadamente versátil, ya sea que desee abrir un enlace en otro navegador, buscar el texto seleccionado en Google o agregarlo como una tarea pendiente a las cosas, PopClip ofrece un estilo de iOS Menú emergente que facilita la realización de estas tareas..

En este tutorial, demostraré lo fácil que es crear tu propio Extensión para PopClip para realizar una acción personalizada..


¿Qué es PopClip??


PopClip proporciona un menú de estilo iOS que se puede personalizar aún más con extensiones

PopClip ($ 4.99) es una aplicación para OS X que proporciona un menú emergente similar a iOS al seleccionar texto. Su uso principal es para cortar, copiar y pegar, de nuevo, muy similar a iOS. Donde realmente se pone interesante es la capacidad de instalar extensiones para hacer más que simplemente agregarlas al portapapeles.

Al momento de escribir, había más de 92 extensiones disponibles para descargar de forma gratuita. Estas extensiones van desde abrir un enlace en Google Chrome, publicar texto seleccionado en Facebook, agregar comillas alrededor del texto seleccionado y más.

Propina: Hay muchas extensiones y lo invito a echar un vistazo, todo lo cual se puede encontrar en la página de extensión PopClip.

Uso PopClip regularmente y uso una extensión para agregar texto seleccionado a Things, la aplicación de mi tarea preferida..


Cómo se construyen

PopClip admite extensiones escritas de varias formas diferentes:

  • Servicio Mac OS X
  • AppleScript
  • Shell Script
  • URL
  • Pulsar teclas

Ambos URL y Pulsar teclas No requiere conocimientos de programación para crearlos. Siempre que conozca la URL de un sitio que puede incluir texto o presionar una determinada combinación de teclas, puede crear su propia extensión..

Los tres restantes se crean utilizando scripting idiomas Pueden manipular el texto de una manera más avanzada. Para los fines de este tutorial, crearé una extensión utilizando el URL método.

UNA URL la extensión requiere solo dos archivos, nuestro archivo de configuración de extensión y un icono para mostrar dentro del menú emergente cuando seleccionamos un texto.


Construyendo nuestro propio

Podemos usar una gran selección de extensiones, pero es posible que no haya una que se adapte exactamente a nuestras necesidades. A modo de ejemplo, le mostraré cómo construir una extensión PopClip que pueda buscar el texto seleccionado en Mactuts +.

Para hacer esto, no le mostraré cómo construir uno desde cero, sino que, en cambio, usaremos parte del código de muestra proporcionado por el desarrollador y realizaremos cambios para adaptarlo a nuestras necesidades. Esto le dará una buena idea de cómo funciona la extensión y qué cambios deberíamos hacer para comenzar a crear nuestras propias extensiones..

Consejo: Solo necesitaremos un editor de texto para hacer cambios. TextEdit no es ideal para editar código, así que recomiendo algo como TextWrangler, que no solo es una gran aplicación, sino que también es gratuita!


1. Crea una carpeta


Puede crear esta carpeta en cualquier lugar, ya que solo será un lugar para trabajar desde ahora.

En su escritorio (o donde desee), cree una carpeta llamada mactuts. Aquí es donde almacenaremos nuestros archivos de extensión antes de convertirlos en una extensión PopClip adecuada..


2. Descargar el código fuente

En el sitio del desarrollador de PopClip Extension, podemos descargar algunos ejemplos de código fuente. Bajo el encabezado Visión general, Verás los tipos de acciones que soporta PopClip. Queremos descargar el código de ejemplo para el URL acción, que es el código fuente de la Traductor de google extensión.

Verás dos archivos dentro de la vista, el Config.plist y TranslationIcon.png. Solo estamos interesados ​​en el archivo Config..


Aquí es cómo se ve el código cuando se abre / pega en un editor de texto (en este caso, TextMate)

El archivo de configuración principal de una extensión es lo que se conoce como Lista de propiedades archivo, también conocido como Plist. Es posible que haya oído hablar de ellos antes, ya que es el mismo tipo de archivo que OS X utiliza para almacenar las preferencias de las aplicaciones. Se basa en un formato conocido como XML. Tómate unos minutos para familiarizarte con el formato..

¿Parecer familiar? XML está diseñado para funcionar de manera similar a HTML, El lenguaje de marcado utilizado para construir páginas web..

Propina: Si desea obtener más información sobre las Listas de propiedades, la Biblioteca de desarrolladores de Apple tiene un excelente artículo introductorio que puede leer

Si no está familiarizado con GitHub, puede descargar la extensión directamente. (Haga clic derecho en el enlace y seleccione Descargar archivo como ... , guardándolo en el mactuts carpeta que creamos anteriormente).


3. Vamos a editar!

Por ahora debería haber guardado el Config.plist archiva a tu mactuts carpeta. Vamos a editar ese archivo dentro de un editor de texto..

Como has visto, este archivo tiene varias opciones configurables diferentes. Notarás que una opción se llama Llave. Estos le dicen a PopClip que la extensión puede proporcionar cierta información. No cambiaremos nada llaves, pero en cambio estaremos modificando la información dentro.

Paso 1


Lo primero que cambiaremos es el nombre y la descripción de la extensión.

En primer lugar, tenemos que cambiar nuestra Nombre de la extensión y Descripción de la extensión. Encuentra la línea que tiene la llave para esto y cambie el nombre que se encuentra en la siguiente cadena, actualmente escrito como "Google Translate" en consecuencia. Recuerda, no cambies la llave..

Ahora que ha cambiado el nombre de la extensión, cambiemos la descripción para reflejar mejor lo que hace. Siguiendo los mismos pasos anteriores, cambie la descripción para describir mejor lo que hará nuestra extensión de búsqueda Mactuts +. Te lo dejo a ti para que decidas qué escribir..

Paso 2


También necesitaremos actualizar la versión, ya que esta es la primera extensión de Mactuts.!

Ahora, ya que esta es la primera vez que crearemos esta extensión, hagámosla la versión 1. Ubique el número de versión cerca de la parte superior del archivo y cambie esto desde 2 a 1.

Es posible que haya notado que, a diferencia del nombre de la extensión, esto es algo llamado Entero y no Cuerda. Entero solo significa que solo está especificando un número, por lo que no hay letras ni caracteres especiales.

Paso 3


El identificador debe cambiarse ya que es único para cada extensión y desarrollador

Cada extensión necesita una forma única de ser identificado. En lugar de usar su nombre, usa un identificador especial que se parece a un nombre de dominio escrito al revés. En este código fuente, lo verás escrito de la siguiente manera:

com.pilotmoon.popclip.extension.google-translate

Cambia esto a lo siguiente:

com.mactuts.extension.mactuts-search

Incluso si cambiamos el nombre de la extensión, PopClip aún se confundiría si tuviéramos nuestra extensión y la extensión Google Translate instaladas al mismo tiempo..

Etapa 4

Ahora es el momento de controlar cómo funciona realmente la extensión. Nuestra extensión buscará en Mactuts + el texto que has seleccionado. Para hacer esto, necesitamos saber cuál es nuestra dirección de búsqueda.

Abra una nueva pestaña o ventana con Mactuts + cargado y busque la palabra clave "TEST". Una vez que se complete la búsqueda, eche un vistazo a la barra de direcciones. Deberías ver la siguiente dirección:

http://mac.tutsplus.com/?s=TEST

A partir de esto, podemos ver que la dirección de búsqueda es:

http://mac.tutsplus.com/?s=

Puede probar esto ingresando la dirección anterior y luego cualquier palabra clave que desee en la barra de direcciones de su navegador. Una vez que la página se cargue, verás la búsqueda que querías..

PopClip usa el texto texto del texto emergente como un marcador de posición para el texto que ha seleccionado. Lo que esto significa es que la dirección de búsqueda para nuestra extensión será:

http://mac.tutsplus.com/?s=popclip text


Ahora cambiaremos la URL que abre PopClip (con el texto seleccionado) para buscar en Mactuts+

Esta dirección de búsqueda es lo que impulsará nuestra extensión. En el archivo de configuración, cambie el Cuerda eso está debajo de la sección para URL a lo anterior.

Paso 5


Nuestro icono que utiliza PopClip debe ser un cuadrado de 256px con un fondo transparente y un área sólida en negro

Con la función de búsqueda principal configurada, necesitamos agregar un ícono. El icono debe ser un PNG cuadrado transparente de 256px. Para ahorrar tiempo, he incluido uno con el archivo de origen que puede descargar y usar.

Agrega este (o tu propio) icono a tu mactuts carpeta. He nombrado el icono que he proporcionado MactutsIcon.png.


Una vez que hayamos agregado una nueva imagen, debemos actualizar el archivo de configuración con el nuevo nombre

De vuelta al archivo de configuración, necesitamos cambiar el nombre del Archivo de imagen a la que estamos usando ahora.

Paso 6


Finalmente, cambie el título de la extensión y elimine la "clave" y la "cadena" para "Expresión regular"

Cambie el título de la ventana emergente de "Traducir" a "Mactuts +". Además, quite el Llave y Cuerda relacionado con Expresión regular. Este es un extra opcional que no requerimos.

Paso 7

Nuestra extensión ya está lista para funcionar. Para comenzar a usarlo, necesitamos convertirlo en una extensión PopClip. Todas las extensiones de PopClip son en realidad carpetas especialmente nombradas. No hay ninguna herramienta de conversión o truco de línea de comandos para hacer.


Duplique la carpeta con la que hemos estado trabajando y renómbrela, agregando ".popclipext" al final

En primer lugar duplicar la carpeta. Con la carpeta recién duplicada, renómbrela a mactuts.popclipext. El Finder le pedirá que confirme que desea cambiarle el nombre..


Se le preguntará si está seguro de que desea agregar una extensión de archivo a la carpeta duplicada

4. Instalar y probar la extensión


PopClip advertirá que esta extensión no está firmada, lo que significa que no fue aprobada por el desarrollador. Como es nuevo, está bien.

Una vez convertido, haga doble clic en el archivo de extensión recién creado para instalar. Recibirá una advertencia de PopClip que explica que esta no es una extensión aprobada. No se preocupe, esto solo significa que queremos instalar una extensión que no era del sitio web del desarrollador. Confirme que desea instalarlo y luego se instalará la extensión. Una vez instalado, lo verás en la lista de extensiones que PopClip tiene activas. Al final de la lista estará nuestra extensión Mactuts + recientemente desarrollada!


Una vez instalado, PopClip mostrará nuestra nueva extensión en el menú.

Ahora para probarlo. Resalte un poco de texto en cualquier lugar y cuando aparezca PopClip, ahora debería ver nuestra pantalla Mactuts + botón de búsqueda.


La selección de texto mostrará el menú PopClip ... junto con nuestra nueva extensión!

Al hacer clic en él, se abrirá una nueva pestaña o ventana (o incluso se iniciará) su navegador predeterminado y se abrirá directamente en la página de resultados de búsqueda para lo que seleccionó..


Cuando se selecciona, PopClip abrirá una nueva pestaña con el texto seleccionado buscado en Mactuts+

Terminando

Al final de este tutorial, espero que hayas podido aprender mucho de él y comenzar a construir extensiones más avanzadas. La página del desarrollador de la extensión PopClip en GitHub le proporciona código fuente para todos los tipos de extensiones para que pueda ver exactamente cómo funcionan..

Dado que la creación de una extensión para PopClip puede ser increíblemente fácil, es posible que no tenga que esperar a que alguien desarrolle una extensión que ha estado esperando.!