Unlimited WordPress themes, graphics, videos & courses! Unlimited asset downloads! From $16.50/m
Advertisement
  1. Computer Skills
  2. App Training
Computers

PopClip: Estensioni di script

by
Difficulty:IntermediateLength:LongLanguages:

Italian (Italiano) translation by Mirko Pizii (you can also view the original English article)

PopClip è un programma di grande utilità che, una volta ci si abitua ad esso, è molto difficile vivere senza. Questo tutorial è intenzione di mostrare come scrivere un'estensione script facendo un'estensione di esempio.

In questo tutorial mostrerà come creare un'estensione di PopClip con la costruzione di un'estensione che andrà a cercare un riferimento di Bibbia essere selezionati, ricerca il riferimento in inglese o thailandese usando un Web API e incollare il verse(s) appropriato al posto. Imparerete a creare un'estensione di PopClip che utilizza un script PHP, l'espressione regolare per l'attivazione, impostare le preferenze che l'utente può modificare e utilizzando i tasti di scelta rapida per ignorare le preferenze.


Definire l'estensione

La prima cosa che dovrebbe essere fatto è di decidere che cosa fara ' l'#x27;estensione. È sempre consigliabile creare ogni estensione con una singola funzionalità in mente. Poiché io sono un missionario, scrivo note su versetti biblici tutto il tempo. Mi piacerebbe avere un'estensione che vi porterà un riferimento di Bibbia e incollare quel versetto o versi nel mio documento in tailandese e inglese. Di conseguenza, l'estensione farà proprio questo!

Ma, a volte potrei solo bisogno di una o l'altra lingua. Pertanto, l'estensione deve avere un pannello delle preferenze e tasti di scelta rapida per ignorare le preferenze. Che potrebbe sembrare un sacco di lavoro, ma PopClip lo rende facile.

Ho trovato un grande sito, Efesini 04:14, che permette il download di versi da entrambe le King James Bible in inglese e tailandese Bibbia di re Giacomo. Dato che io lavoro con la lingua Thai, queste sono le Bibbie sola che ho bisogno. Hanno anche molte altre lingue. Di conseguenza, è possibile aggiungere qualsiasi lingua potrebbe interessarti.


Popclip risorse

Se appena installato di recente PopClip, si prega di leggere prima la guida per l'utente PopClip. Il tutorial, creare il tuo proprio Custom Extension per PopClip, dà un'ottima introduzione alla PopClip e come fare le estensioni che non richiedono alcuna programmazione. Questa esercitazione si concentrerà su script estensioni di programmazione per PopClip.

Pilotmoon dà un elenco completo di plist opzioni del file di configurazione. Fare sempre riferimento a questo per la documentazione aggiornata dell'interfaccia estensioni per PopClip.

L'estensione sarà scritto in PHP. Se non sai come programmare in PHP, un eccellente video corso può essere trovato su Tuts+: fondamenti di PHP.


La struttura dei File

Ovunque si dovrà lavorare sul computer, creare una directory denominata popclipBible.popclipext. Tale directory sarà simile a un normale file, ma quando si fare clic con il pulsante destro su di esso e seleziona nel menu a comparsa Mostra contenuto pacchetto, mostrerà il contenuto della directory. È necessario creare i file Config.plist, bible.php e bible.png in questa directory.

Config.plist è il file plist descritto nella sezione successiva. Bible.php conterrà lo script PHP da eseguire. Bible.png è il file grafico per l'estensione. Tutti questi sono nel file di download nella parte superiore.


Il Plist

Tutte le estensioni per PopClip iniziare con un file plist chiamato Config.plist. Questo file indica PopClip come l'estensione si adatta al mondo di PopClip. Il plist completo per questa estensione è:

Come si può vedere, è un file di dati formattati XML. Questo file di dati indica PopClip tutto è necessario conoscere per eseguire l'estensione.

Questo è il plist di ossa nude necessario per questa estensione. Il dizionario principale ha le chiavi, azioni e opzioni. Queste sono le voci principali per fornire la funzionalità dell'estensione. Io li descrivono in dettaglio più avanti. Gli altri tasti sono:

Descrizione estensione
Questa chiave fornisce una descrizione di ciò che farà l'estensione. Questo deve essere breve ma descrittivo.

Identificatore di estensione
Questa chiave fornisce un identificatore univoco per l'estensione. Ho basato esso fuori del mio sito per completa unicità. Può da qualsiasi sequense alfa-numerici, ma qualcosa di leggibile è sempre bello.

Nome dell'estensione
Questa chiave è il nome dell'estensione. Io la chiamo semplicemente Bibbia.

Corsa lunga
Questa chiave è impostata su true poiché esso sarà fare un Web API chiamata che prendere un po' di tempo per finire a causa della velocità della rete. Questo ha semplicemente PopClip visualizzare un'icona di attesa durante l'esecuzione dell'azione.

Se l'estensione non tiene a lungo, dovrebbe essere falsa.

Espressione regolare
Valore di questa chiave è un'espressione regolare che consentirà il lancio dell'estensione solo se essa afferma vero per il testo attualmente selezionato. Scrivendo un'espressione regolare che corrisponderà solo un riferimento di Bibbia, non mostrerà l'estensione della Bibbia su qualsiasi selezione di testo.

Fare buon uso di questa funzionalità. Mostrando con qualsiasi selezione di testo rende più difficile per l'utente dell'estensione. Pensate a come qualcuno vorrebbe utilizzare l'estensione e creare una buona espressione regolare per il caso.

Se sei un po' arrugginito sulla scrittura di espressioni regolari, quindi dovresti leggere questo articolo su Net Tuts+.

Versione Software richiesta
Questa chiave specifica la versione di PopClip che ha bisogno di questa estensione.


Azioni

I tasti di azione sono per definire l'azione che eseguirà l'estensione. Ci sono un sacco di possibilità, ma questo tutorial si concentrerà solo su elementi necessari. Essi sono come segue:

Dopo
Specifica l'azione da intraprendere dopo aver eseguito lo script. Incolla-risultato verrà incollato nella parte superiore l'applicazione qualunque testo gli echi di script fuori.

File di immagine
Questa chiave specifica l'icona utilizzata per questa estensione. Poiché l'icona nella stessa area come l'estensione, è possibile semplicemente fare riferimento al file: bible.png. Se si voleva mantenere le icone in una sottodirectory dell'estensione, si utilizzerà un riferimento relativo a tale file.

Interprete di script
Questa chiave definisce l'interprete verrà utilizzato per elaborare lo script. Poiché sto facendo questo programma in PHP, deve fare riferimento l'interprete PHP di default su tutti i Mac: /usr/bin/php. È possibile inserire il percorso completo a qualsiasi interprete si desidera utilizzare per scrivere estensioni.

File di Script di Shell
Questa chiave definisce il file nella directory di eseguire l'estensione. Il nome del file è: bible.php.

Titolo
Questa chiave è il titolo dell'estensione: Bibbia.


Opzioni

La chiave Options contiene una matrice di dizionari. Un dizionario per ogni opzione nel pannello delle preferenze per l'estensione. Per questa estensione, l'utente dovrebbe avere l'opzione di Incolla dalla Sacra Bibbia o la Bibbia di KJV Thai. Dal momento che ho due opzioni per questa estensione, descriverò ogni chiave del dizionario di opzioni e dire quello che ho usato per ogni opzione.

Identificatore di opzione
Questa chiave dare PopClip un nome univoco per l'opzione è necessario per l'estensione. Viene utilizzato nella variabile di ambiente che viene passata al programma. Per le due opzioni, verranno utilizzati questi ID: biblekjv e biblethaikjv.

Tipo di opzione
Questa chiave definisce il tipo di opzione. Può essere boolean (Sì o no), stringa (qualsiasi) o multiplo (si dà un elenco di opzioni e l'utente può scegliere da loro). Il tipo boolean è ciò che è necessario per questa estensione.

Etichetta di opzione
Questa chiave definisce il testo da utilizzare nel pannello opzioni per l'estensione. Per questa estensione, le etichette KJB e Thai KJV funzionerà.

Con queste opzioni definite nel plist, verrà creato un pannello di preferenze per modificare le preferenze. Questo è ciò che apparirà come:

Bible Extension Preferences
Bibbia estensione preferenze

Lo Script

Ora, lo script deve essere scritto. Lo script completo è:

La prima cosa nello script è una matrice dei nomi dei libri nella Bibbia. Questa matrice è per tradurre i nomi di libro in inglese nel loro equivalente Thai. Web api che l'estensione utilizza solo dà riferimenti in inglese. Quindi, i nomi della Rubrica la Bibbia inglese ha bisogno di essere tradotte in Thai.

La prima funzione è una funzione di supporto. È una routine PHP per richiesta di informazioni da un sito web utilizzando curl e restituendo i risultati al programma chiamante. L'input è l'url della richiesta.

La seconda funzione è la funzione principale per l'elaborazione il versetto della Bibbia. Richiederà il processo XML risultante in un formato più leggibile per incollarli in un editor di testo o che cosa mai programma è attualmente attivo e un versetto della Bibbia. I parametri sono il versetto della Bibbia effettivo e la designazione per quale Bibbia richiedere. Per la Bibbia di re Giacomo, è sacra. Per la Bibbia Thai, è tailandese. È possibile ottenere altri codici dal link del sito qui sopra.


Ottenere informazioni dall'ambiente

PopClip invia informazioni allo script tramite le variabili di ambiente. È un modo semplice per comunicare. Questo è come si accedere a tali informazioni.

Il PHP funzione getenv() consente di recuperare la variabile di ambiente data nella stringa per la chiamata di funzione. Tutte le variabili di ambiente sono stringhe e devono essere utilizzati come tali. Le variabili di ambiente diverso sono:

POPCLIP_TEXT
Questa variabile è la selezione quando è stato chiamato PopClip. Poiché l'utente dell'estensione potrebbe selezionare spazio vuoto, mi piace sempre di utilizzare la funzione Trim() per rimuovere qualsiasi spazio vuoto.

POPCLIP_OPTION_BIBLEKJV
Questa variabile è l'opzione di ottenere il versetto dalla King James version. È una stringa contenente il carattere 1 Se true, che altrimenti contiene il carattere 0.

POPCLIP_OPTION_BIBLETHAIKJV
Questa variabile è l'opzione di ottenere il versetto dalla Thai King James version. È una stringa contenente il carattere 1 Se true, che altrimenti contiene il carattere 0.

POPCLIP_MODIFIER_FLAGS
Questo dice uso quali tasti sono stati premuti mentre il PopClip è stato selezionato l'azione. Tutto passato in una variabile di ambiente è una stringa. Di conseguenza, le stringhe devono essere tradotti in un formato facile da usare come bene. Io uso la funzione di intval() per convertire la stringa in un valore integer.

Tutti i valori di codice chiave diverso sono mostrati nel PopClip estensioni GitHub.

Come si può vedere, ogni opzione nelle preferenze per l'estensione ha sua propria corrispondente variabile di ambiente.

La variabile $result è inoltre impostata su una stringa vuota per le prossime due sezioni riempire.


Le variabili di ambiente di elaborazione

La parte principale di qualsiasi estensione di PopClip è quello di prendere le variabili passate nell'ambiente e fare qualcosa di utile con esso.

Questa sezione di codice verrà recuperato il versetto dal re James version se è stata impostata nelle preferenze (variabile $qKJV) o è stato premuto il tasto comando mentre si seleziona l'azione di PopClip ($keycode è 1048576). Essa richiederà anche se vengono premuti tasti di comando e controllo ($keycode è 1310720). Poiché la variabile $qKJV è una stringa che è 1 o 0, è possibile cercare il primo carattere di essere un personaggio 1. In questo modo, non ha al processo per un numero. Che consente di risparmiare tempo!

Se la condizione è true, i versi vengono recuperati utilizzando la funzione di getBibleVerse() e aggiunto alla stringa $result.

Qui, è simile. Se la versione di Thai King James è stata selezionata nelle preferenze ($qThaiKJV) o è stato premuto il tasto control mentre si seleziona l'azione PopClip ($keycode è 262144), quindi verrà richiesta la versione Thai King James. Essa richiederà anche se vengono premuti tasti di comando e controllo ($keycode è 1310720).

Se la condizione è true, i versi vengono recuperati utilizzando la funzione di getBibleVerse() e aggiunto alla stringa $result.

Qui, i risultati devono essere eco. Ma, se il buffer di risultati è vuoto, quindi il versetto dovrebbe essere eco. Se una stringa vuota è eco, Elimina in modo efficace ciò che è stato selezionato. Poiché tutto è un'opzione, è possibile arrivare con la variabile $results vuota. Buone pratiche di programmazione ci dice di prendere sempre ogni possibilità in considerazione.


Utilizzo

Una volta che l'estensione viene caricato in PopClip e le preferenze sono impostate, l'estensione è facile da usare. Basta selezionare un testo che è un riferimento di Bibbia.

Selecting a verse
Selezionando un versetto

Quando appare la barra di PopClip, selezionare la Bibbia bianca e la selezione sarà trasformata nel versetto. Qui, le preferenze sono stata istituite per le versioni sia KJV e ThaiKJV essere stampato.

Replaced Verse
Verse sostituita

Se il testo non corrisponde l'espressione regolare per un riferimento di Bibbia, non verrà visualizzato l'icona di Bibbia.

Selection not a Verse
Selezione non un versetto

Questo aiuta a risparmiare immobiliare sulla barra di PopClip. Ogni volta che si crea un'estensione, pensare a come ridurre al minimo inutili apparenze dell'estensione.


Riepilogo

Ora avete un estensione di PopClip poco pulito per ottenere versi da un sito web e incollandoli all'applicazione. Anche di meglio, ora sai come creare un pannello di preferenze per l'estensione, raggiungere tali informazioni dalla tua estensione, manipolare il testo selezionato e incollarlo nella parte superiore la maggior parte delle applicazioni. Si può prendere questo codice ed espanderlo o usarlo come uno scheletro per la propria estensione di PopClip. Tutti sappiano come lo si utilizza nei commenti!

Advertisement
Advertisement
Advertisement
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.