Connector de fragments

El connector Fragments us permet emmagatzemar fragments de text utilitzats normalment, anomenats fragments, i inserir-los ràpidament a un document.

Els fragments són específics a la sintaxi del llenguatge del document actual. Per exemple, quan esteu treballant amb un document HTML, podeu triar des d'una llista de fragments que són útils per a l'HTML. A més, alguns fragments són globals i estan disponibles a tots els documents.

Un número de fragments integrats s'instal·len amb el gedit, els quals poden ser modificats.

10.10.1. Com inserir fragments

Per a inserir un fragment a un document, teclegeu el seu disparador de tabulador i premeu Tab. Normalment el disparador de tabulador d'un fragment són les primeres lletres del fragment o alguna altra cosa que sigui curta i fàcil de recordar.

Alternativament, premeu Ctrl+Espai per a veure una llista dels fragments que podeu inserir.

10.10.2. Com afegir fragments

Per a crear un fragment nou, feu el següent:

  1. Trieu Eines ▸ Gestiona fragments. S'obrirà la finestra Gestor de fragments.

  2. La llista dels fragments està agrupada per llenguatge. Seleccioneu el llenguatge on voleu afegir un fragment, o bé un fragment en aquell grup de llenguatge. Per a afegir un fragment a tots els llenguatges, trieu Global a la part superior de la llista. Per defecte es mostrarà la sintaxi del document en el qual esteu treballant actualment.

  3. Feu clic a Nou. Apareixerà un fragment nou a la llista.

  4. Introduïu la informació següent per al fragment nou:

    Nom

    Introduïu un nom per al fragment al camp de text a la llista de fragments. El nom d'un fragment només serveix com a recordatori del seu propòsit. Podeu canviar el nom d'un fragment que heu creat en fer-hi clic a la llista.

    Text del fragment

    Introduïu el text del fragment al quadre de text Edita el fragment. Per a saber els codis especials que podeu utilitzar, vegeu la Secció 10.10.4 ― Substitució de fragments.

    Podeu tornar a la finestra del document per a copiar text sense tancar la finestra del Gestor de fragments.

    Disparador de tabulador

    Introduïu el disparador de tabulador per al fragment. Aquest és el text que heu d'escriure abans de prémer Tab per a inserir el fragment.

    L'etiqueta ha de ser una sola paraula amb només lletres o un sol caràcter. El Disparador de tabulador es ressaltarà en vermell si s'ha introduït un disparador de tabulador no vàlid.

    Tecla de drecera

    Introduïu una tecla de drecera a utilitzar per a inserir el fragment.

10.10.3. Com editar i suprimir fragments

Per a editar un fragment, seleccioneu-lo a la llista i realitzeu els canvis a les seves propietats d'activació i text.

Per a canviar el nom d'un fragment, feu-hi clic un altre cop a la llista.

Per a restaurar un fragment integrat que heu modificat, premeu Recupera.

Per a suprimir un fragment, seleccioneu-lo a la llista i premeu Suprimeix. No podeu suprimir fragments integrats, només aquells que heu creat.

10.10.4. Substitució de fragments

A més d'inserir un text emmagatzemat, un fragment pot incloure text personalitzat o marcar els espais on podeu afegir text un cop s'hagi inserit el fragment al document.

Podeu utilitzar els codis de text variable següents al text del fragment:

Texts variables per a tabuladors

$n defineix un text variable per a tabulador, on n és qualsevol número des d'un en amunt.

${n:default} defineix un text variable per a tabulador amb un valor predeterminat.

Un text variable per a tabulador marca un espai al text del fragment on podeu afegir text addicional després d'inserir el fragment.

Per a utilitzar els texts variables per a tabuladors, inseriu un fragment de forma normal. El cursor s'ubicarà al primer text variable per a tabulador. Escriviu el text i premeu Tab per a anar al següent text variable per a tabulador. El número al codi del text variable defineix l'ordre en què avançarà la tabulació a cada ubicació del text.

Premeu Maj+Tab per a tornar al text variable per a tabulador anterior. En prémer Tab quan no hi ha més texts variables per a tabulador es mourà el cursor al final del text del fragment o al final del text variable si existeix.

Rèpliques de texts variables

Un text variable per a tabulador repetit replicarà el text variable ja definit. Això us permet escriure un sol cop el text que voleu que aparegui diverses vegades al fragment.

Text variable de final

$0 defineix el text variable de final. Aquest us permet de finalitzar de treballar amb el fragment amb el cursor a un punt diferent que el final del fragment de text.

Variables d'entorn

Les variables d'entorn com ara $PATH i $HOME són substituïdes al fragment de text. També es poden utilitzar les variables d'entorn següents específiques del gedit.

$GEDIT_SELECTED_TEXT

El text seleccionat actualment.

$GEDIT_FILENAME

El nom de fitxer complet del document o una cadena buida si el document encara no s'ha desat.

$GEDIT_BASENAME

El nom base del nom de fitxer del document o una cadena buida si el document encara no s'ha desat.

$GEDIT_CURRENT_WORD

La paraula a la ubicació del cursor al document. Quan s'utilitza aquesta variable, la paraula actual serà reemplaçada pel fragment de text.

Texts variables de l'interpret d'ordres

$(cmd) és reemplaçat pel resultat d'executar cmd a l'interpret d'ordres.

$(n:cmd) us permet donar una referència a aquest text variable, on n és qualsevol número de 1 en amunt. Utilitzeu $n per a utilitzar la sortida d'un text variable de l'interpret d'ordres com a entrada d'una altre.

Texts variables de Python

$<cmd> és reemplaçat pel resultat d'avaluar cmd a l'interpretador Python.

$<a:cmd> especifica un altre text variable Python com a dependència, on a proporciona el seu ordre al fragment. Això us permet utilitzar funcions Python definides a un altre fragment. Per a especificar diverses dependències, separeu els números amb comes com aquestes: $<a,b:cmd>

Per a utilitzar una variable a tots els altres fragments Python, declareu-la com a global.