# Manual del pluma

## Introducció

L'aplicació pluma us permet crear i editar fitxers de text.

L'objectiu del pluma és ser un editor text senzill i fàcil d'utilitzar. Les funcions més potents es poden habilitar amb diferents connectors, permetent una varietat de tasques relacionades amb l'edició de text.

## Primers passos

### Com iniciar el pluma

Podeu iniciar el pluma de les maneres següents:

Menú Aplicacions

- Trieu Accessoris Editor de text.

Línia d'ordres

- Executeu l'ordre següent: `pluma`

Per defecte, quan obriu un document de text amb el gestor de fitxers, el pluma s'iniciarà i mostrarà el document.

### La finestra del pluma

Quan inicieu el pluma, es mostrarà la finestra següent:

#### Finestra del pluma

Shows pluma main window.

La finestra del pluma conté els elements següents:

Barra de menú

- Els menús a la barra de menú contenen totes les ordres que necessiteu per a treballar amb fitxers al pluma.

Barra d'eines

- La barra d'eines conté un subconjunt d'ordres a les quals podeu accedir des de la barra de menú.

Àrea de visualització

- L'àrea de visualització conté el text del fitxer que esteu editant.

Barra d'estat

- La barra d'estat mostra la informació sobre l'activitat actual del pluma i la informació contextual sobre els elements del menú. La barra d'estat també mostra la informació següent:

  - Posició del cursor: el número de línia i el número de columna on està ubicat el cursor.

  - Mode d'edició: si l'editor està en mode d'inserció, la barra d'estat conté el text INSER. Si l'editor està en mode de sobreescriptura, la barra d'estat conté el text SOBR. Premeu la tecla d'Inserció per a canviar el mode d'edició.

Subfinestra lateral

- La subfinestra lateral mostra una llista dels documents oberts i altra informació depenent de quins connectors s'hagin habilitat.

  Per defecte la subfinestra lateral no es mostra. Per a mostrar-la, trieu Visualitza Subfinestra lateral.

Subfinestra inferior

- La subfinestra inferior s'utilitza per a eines de programació com ara el connector Consola Python per a mostrar missatges.

  Per defecte la subfinestra inferior no es mostra. Per a mostrar-la, trieu Visualitza Subfinestra inferior.

Quan feu clic amb el botó secundari a la finestra del pluma, l'aplicació mostrarà un menú emergent. El menú emergent conté les ordres d'edició més habituals.

Like other MATE applications, actions in pluma can be performed in several ways: with the menu, with the toolbar, or with shortcut keys. Shortcuts keys common to all applications are listed in the User Guide.

### Com executar el pluma des d'una línia d'ordres

Podeu executar el pluma des d'una línia d'ordres i obrir un fitxer o diversos fitxers. Per a obrir diversos fitxers des d'una línia d'ordres, introduïu l'ordre següent i premeu Retorn:

`pluma `file1.txt file2.txt file3.txt``

Alternativament, podeu especificar un URI enlloc d'un nom de fitxer.

Per a obtenir més informació sobre com executar el pluma des d'una línia d'ordres, vegeu la pàgina del manual UNIX del pluma,

pluma

1.

## Com treballar amb fitxers

### Com crear un document nou

Per a crear un document nou, trieu Fitxer Nou. L'aplicació mostrarà un document en blanc nou a la finestra del pluma.

### Com obrir un fitxer

Per a obrir un fitxer, trieu Fitxer Obre per a mostrar el diàleg Obertura de fitxers. Seleccioneu el fitxer que voleu obrir i feu clic a Obre. El fitxer es mostrarà a la finestra del pluma.

The application records the paths and filenames of the five most recent files that you edited and displays the files as menu items on the File menu. You can also click on the Shows Recent Files menu icon. icon on the toolbar to display the list of recent files.

Podeu obrir múltiples fitxers al pluma. L'aplicació afegeix una pestanya a la finestra per a cada fitxer obert. Per a obtenir més informació vegeu la pluma-tabs.

### Com desar un fitxer

Podeu desar fitxers de les maneres següents:

- Per a desar els canvis d'un fitxer existent, trieu Fitxer Desa.

- To save a new file or to save an existing file under a new filename, choose File Save As . Enter a name for the file in the Save As dialog, then click Save.

- To save all of the files that are currently open in pluma, choose Documents Save All .

To close all of the files that are currently open in pluma, choose Documents Close All .

### Com obrir un fitxer des d'un URI

Per a obrir un fitxer des d'un identificador de recursos uniforme (URI), realitzeu els passos següents:

1. Choose File Open Location to display the Open Location dialog.

2. Introduïu l'URI del fitxer que voleu obrir.

3. Utilitzeu la llista desplegable Codificació de caràcters per a seleccionar la codificació de caràcters apropiada.

4. Feu clic a Obre.

Els tipus d'`URI` vàlids inclouen `http:`, `ftp:`, `file:` i tots els mètodes admesos pel `mate-vfs`.

Els fitxers d'alguns tipus d'URI s'obren com a només lectura i els canvis que realitzeu s'han de desar a una ubicació diferent. L'HTTP només permet la lectura dels fitxers. Els fitxers oberts des d'un FTP són de només lectura perquè no tots els servidors FTP treballen correctament amb el desament remot de fitxers.

Es pot habilitar el desament a servidors FTP amb l'editor de configuració, en establir la clau `/apps/pluma/preferences/editor/save/writable_vfs_schemes`, però això pot causar errors.

### Com treballar amb pestanyes

Quan s'ha obert més d'un fitxer, el pluma mostra una pestanya per a cada document sobre l'àrea de visualització. Per a canviar a un altre document, feu clic a la seva pestanya.

Per a moure un document a una altra finestra del pluma, arrossegueu la pestanya corresponent a la finestra on voleu moure'l.

To move a document to a new pluma window, either drag its tab to the desktop, or choose Documents Move to New Window .

## Com treballar amb text

### Com editar un text

Podeu editar el text d'un fitxer de les maneres següents:

- Introduïu el text nou des del teclat. El cursor d'inserció parpellejant marca el punt on apareix el text nou. Per a canviar-ho, utilitzeu les tecles de cursor del teclat o feu clic amb el ratolí.

- To copy the selected text to the clipboard, choose Edit Copy .

- To delete the selected text from the file and move the selected text to the clipboard, choose Edit Cut .

- To permanently delete the selected text from the file, choose Edit Delete .

- To insert the contents of the clipboard at the cursor position, choose Edit Paste . You must cut or copy text before you can paste text into the file, either from pluma or another application.

- To select all of the text in a file, choose Edit Select All .

### Com desfer i refer els canvis

To undo a change you have made, choose Edit Undo . To reverse this action, choose Edit Redo .

## Com cercar i reemplaçar

Al pluma hi ha dues maneres de cercar text. Podeu utilitzar el diàleg Cerca per a cercar un fragment específic de text o la Cerca incremental per a ressaltar el text coincident mentre l'introduïu.

### Com trobar un text

Per a cercar una cadena de text d'un fitxer, realitzeu els passos següents:

1. Choose Search Find to display the Find dialog.

2. Introduïu la cadena que voleu trobar al camp Cerca. Podeu incloure caràcters especials com ara una línia nova o una tabulació. Vegeu la pluma-find-escapes.

3. Feu clic a Cerca per a cercar la primera ocurrència de la cadena en el fitxer després de la posició actual del cursor. Si el pluma troba la cadena, l'aplicació en seleccionarà la primera ocurrència. Les altres ocurrències de la cadena es ressaltaran.

4. To find the next occurrence of the string, click Find or choose Search Find Next . To find the previous occurrence of the text, choose Search Find Previous .

After you have closed the Find dialog, you can still move the selection to other occurrences of the text by choosing Search Find Next and Search Find Previous .

To remove the highlighting from the text, choose Search Clear Highlight .

### Cerca incremental

La cerca incremental ressalta el text coincident al document mentre l'escriviu lletra per lletra (això és semblant a la funció de cerca de diversos navegadors web).

To start an incremental search, choose Search Incremental Search . The search box appears at the top of the display area.

Comenceu a escriure i el text que coincideixi es ressaltarà al document. La primera instància després de la posició del cursor se seleccionarà.

Per a avançar la selecció a la coincidència següent mentre manteniu el quadre de cerca incremental obert, premeu Ctrl G. Premeu Ctrl Maj G per a tornar a la coincidència anterior.

També podeu utilitzar les tecles de cursor amunt i avall o la roda del ratolí per a moure la selecció entre coincidències.

### Com reemplaçar un text

Per a cercar una cadena a un fitxer i reemplaçar la cadena amb una cadena alternativa, realitzeu els passos següents:

1. Choose Search Replace to display the Replace dialog.

2. Introduïu la cadena que voleu trobar al camp Cerca. Podeu incloure caràcters especials com ara una línia nova o una tabulació. Vegeu la pluma-find-escapes.

3. Introduïu al camp Reemplaça per la cadena que vulgueu utilitzar per a reemplaçar la cadena cercada.

Per a examinar cada ocurrència de la cadena abans de reemplaçar-la, feu clic a Cerca. Si el pluma troba la cadena, l'aplicació la seleccionarà. Feu clic a Reemplaça per a reemplaçar l'ocurrència de la cadena seleccionada. Per a trobar l'ocurrència següent de la cadena, feu clic un altre cop a Cerca.

Per a reemplaçar totes les ocurrències de la cadena del document, feu clic a Reemplaça-ho tot.

### Opcions de cerca i reemplaçament

El diàleg de Cerca i el diàleg Reemplaça tenen les opcions següents:

- Seleccioneu l'opció Coincidència de majúscules i minúscules per a només trobar ocurrències de la cadena que coincideixen en majúscules i minúscules amb el text que heu introduït. Per exemple, amb Coincidència de majúscules i minúscules seleccionat, «TEXT» no coincideix amb «text».

- Seleccioneu l'opció Només coincideix la paraula sencera per a només trobar ocurrències de la cadena que coincideixen amb tota la paraula del text que heu introduït. Per exemple, amb Només coincideix la paraula sencera seleccionat, «text» no coincideix amb «textura».

- Seleccioneu l'opció Cerca cap enrere per a cercar enrere cap a l'inici del document.

- Seleccioneu l'opció Continua des de l'inici per a cercar fins al final del document i llavors continuar la cerca des de l'inici del document.

### Caràcters especials

Podeu incloure les seqüències d'escapada següents al text per a representar caràcters especials per a cercar o reemplaçar:

`\n`

- Especifica una línia nova.

`\t`

- Especifica un caràcter de tabulació.

`\r`

- Especifica un caràcter de retorn.

`\\`

- El caràcter de barra inversa s'ha d'escapar si s'està cercant. Per exemple, si esteu cercant el literal «`\n`», heu d'introduir «\\n» al camp Cerca. O si esteu cercant una seqüència de barres inverses, heu de doblar el nombre de barres inverses que cerqueu.

### Com posicionar el cursor a una línia específica

To position the cursor on a specific line in the current file, choose Search Go to Line . The line number box appears at the top of the display area.

Comenceu a introduir el número de línia on voleu moure el cursor i el document es desplaçarà a la línia especificada.

Per a tancar el quadre i moure el cursor a la línia especificada, premeu Retorn.

## Impressió

### Com establir les opcions de la pàgina

To set the page options, choose File Page Setup to display the Page Setup dialog.

El diàleg Configuració de la pàgina us permet especificar les opcions d'impressió següents:

#### Pestanya general

Print syntax highlighting

- Seleccioneu aquesta opció per a imprimir el ressaltat de la sintaxi. Per a obtenir més informació sobre el ressaltat de la sintaxi, vegeu la pluma-set-highlightmode.

Print page headers

- Seleccioneu aquesta opció per a incloure una capçalera a cada pàgina que imprimiu. No podeu configurar la capçalera.

Line Numbers

- Seleccioneu l'opció Imprimeix els números de línia per a incloure els números de línia quan imprimiu un fitxer.

  Utilitzeu el quadre de selecció de valors Número cada ... línies per a especificar cada quan s'ha d'imprimir el número de línia. Per exemple cada 5 línies, cada 10 línies, etc.

Text Wrapping

- Seleccioneu l'opció Habilita l'ajustament de text per a ajustar el text a la línia següent quan s'arriba a un número de caràcters, quan imprimiu un fitxer. L'aplicació compta les línies ajustades com a una sola línia per a la numeració.

  Seleccioneu l'opció No separis les paraules en dues línies per a ajustar el text a la línia següent, a nivell de paraula, quan imprimiu un fitxer.

#### Tipus de lletres

Body

- Feu clic a aquest botó per a seleccionar el tipus de lletra a utilitzar per a imprimir el text del cos d'un fitxer.

Line numbers

- Feu clic a aquest botó per a seleccionar el tipus de lletra a utilitzar per a imprimir els números de línia.

Headers and footers

- Feu clic a aquest botó per a seleccionar el tipus de lletra a utilitzar per a imprimir les capçaleres i peus de pàgina d'un fitxer.

Per a reiniciar els tipus de lletra als tipus de lletra predeterminats per a imprimir un fitxer del pluma, feu clic a Restaura els tipus de lletra predeterminats.

### Impressió d'un document

Podeu utilitzar el pluma per a realitzar les operacions d'impressió següents:

- Imprimir un document a una impressora.

- Imprimir la sortida de l'ordre d'imprimir a un fitxer.

Si imprimiu a un fitxer, el pluma envia la sortida del fitxer a un fitxer de format de preimpressió. Els formats de preimpressió més habituals són el PostScript i el Portable Document Format (PDF).

To preview the pages that you want to print, choose File Print Preview .

To print the current file to a printer or a file, choose File Print to display the Print dialog.

El diàleg Imprimeix us permet especificar les opcions d'impressió següents:

#### Pestanya de tasca

Print range

- Seleccioneu una de les opcions següents per a determinar quantes pàgines imprimir:

  - All

    Seleccioneu aquesta opció per a imprimir totes les pàgines del fitxer.

  - Lines

    Seleccioneu aquesta opció per a imprimir només les línies especificades. Utilitzeu els quadres de selecció de valors Des de i A per a especificar el rang de línies.

  - Selection

    Seleccioneu aquesta opció per a imprimir només el text seleccionat. Aquesta opció només està disponible si seleccioneu text.

Copies

- Utilitzeu el quadre de selecció de valors Número de còpies per a especificar el número de còpies que voleu imprimir del fitxer.

  Si imprimiu diverses còpies del fitxer, seleccioneu l'opció Compagina per a compaginar les còpies impreses.

#### Pestanya d'impressora

Printer

- Utilitzeu aquesta llista desplegable per a seleccionar la impressora on voleu per a imprimir el fitxer.

Settings

- Utilitzeu aquesta llista desplegable per a seleccionar els paràmetres de la impressora.

  Per a configurar la impressora, feu clic a Configura. Per exemple, podeu habilitar o inhabilitar la impressió doble o la impressió retardada, si la impressora admet aquesta funcionalitat.

Location

- Utilitzeu aquesta llista desplegable per a seleccionar un dels destins d'impressió següents:

  CUPS

- Imprimeix el fitxer a una impressora CUPS.

  Si la impressora seleccionada és una impressora CUPS, el CUPS és l'única entrada d'aquesta llista desplegable.

lpr

- Imprimeix el fitxer a una impressora.

File

- Imprimeix el fitxer a un fitxer PostScript.

  Feu clic a Anomena i desa per a mostrar un diàleg on podeu especificar el nom i la ubicació del fitxer PostScript.

Custom

- Utilitzeu l'ordre especificada per a imprimir el fitxer.

  Introduïu el nom de l'ordre al quadre de text. Incloent tots els arguments de la línia d'ordres.

State

- Aquesta funcionalitat no està implementada en aquesta versió del pluma.

Type

- Aquesta funcionalitat no està implementada en aquesta versió del pluma.

Comment

- Aquesta funcionalitat no està implementada en aquesta versió del pluma.

#### Pestanya del paper

Paper size

- Utilitzeu aquesta llista desplegable per a seleccionar la mida del paper on voleu imprimir el fitxer.

Width

- Utilitzeu aquest quadre de selecció de valors per a especificar l'amplada del paper. Utilitzeu la llista desplegable adjacent per a canviar la unitat de mesura.

Height

- Utilitzeu aquest quadre de selecció de valors per a especificar l'alçada del paper.

Feed orientation

- Utilitzeu aquesta llista desplegable per a seleccionar l'orientació del paper a l'impressora.

Page orientation

- Utilitzeu aquesta llista desplegable per a seleccionar l'orientació de la pàgina.

Layout

- Utilitzeu aquesta llista desplegable per a seleccionar la disposició de la pàgina. Es mostrarà una previsualització de cada disposició que seleccioneu a l'àrea de Previsualització.

Paper tray

- Utilitzeu aquesta llista desplegable per a seleccionar la safata de paper.

## Funcions de programació

Diverses de les funcions per a programar del pluma les proporcionen els connectors. Per exemple, el connector «Llistat de marcadors» proporciona una llista dels marcadors utilitzats normalment per a marcar llenguatges. Vegeu la pluma-tag-list-plugin.

### Ressaltat de la sintaxi

El ressaltat de la sintaxi fa el codi font més fàcil llegir en mostrar les diferents parts del text en diferents colors.

pluma chooses an appropriate syntax highlighting mode based on a document's type. To override the syntax highlighting mode, choose View Highlight Mode , then choose one of the following menu items:

Normal

- No mostris cap ressaltat de la sintaxi.

Sources

- Mostra el ressaltat de la sintaxi per a editar codi font. Utilitzeu el submenú Codis font per a seleccionar el tipus de codi font.

Markup

- Mostra el ressaltat de la sintaxi per a editar codi de marcatge. Utilitzeu el submenú Marcatge per a seleccionar el tipus de codi de marcatge.

Scripts

- Mostra el ressaltat de la sintaxi per a editar codi d'script. Utilitzeu el submenú Scripts per a seleccionar el tipus de codi d'script.

Others

- Mostra el ressaltat de la sintaxi per a editar altres tipus de codi. Utilitzeu el submenú Altres per a seleccionar el tipus de codi.

### Condueix la sortida d'una ordre a un fitxer

Podeu utilitzar el pluma per a conduir la sortida d'una ordre a un fitxer de text. Per exemple, per a conduir la sortida d'una ordre `ls` a un fitxer de text, escriviu `ls | pluma` i premeu Retorn.

La sortida de l'ordre `ls` es mostrarà a un fitxer de text nou a la finestra del pluma.

Alternativament, podeu utilitzar el connector Eines externes per a conduir la sortida d'una ordre al fitxer actual.

## Dreceres de teclat

Utilitzeu les dreceres de teclat per a realitzar tasques més ràpidament que amb el ratolí i els menús. Les taules següents llisten totes les dreceres de teclat del pluma.

For more on shortcut keys, see the Desktop User Guide.

Pestanyes

Dreceres per a les pestanyes:

Tecla de drecera | Ordre
Ctrl + Alt + RePàg | Commuta a la pestanya següent a l'esquerra.
Ctrl + Alt + AvPàg | Commuta a la pestanya següent a la dreta.
Ctrl + W | Tanca la pestanya.
Ctrl + Maj + L | Desa totes les pestanyes.
Ctrl + Maj + W | Tanca totes les pestanyes.
Alt + n | Salta a l'enèsima pestanya.

Fitxers

Dreceres per a treballar amb fitxers:

Tecla de drecera | Ordre
Ctrl + N | Crea un document nou.
Ctrl + O | Obre un document.
Ctrl + L | Obre una ubicació.
Ctrl + S | Desa el document actual al disc.
Ctrl + Maj + S | Desa el document actual amb un nom de fitxer nou.
Ctrl + P | Imprimeix el document actual.
Ctrl + Maj + P | Previsualitza la impressió.
Ctrl + W | Tanca el document actual.
Ctrl + Q | Surt del pluma.

Edita

Dreceres per a editar documents:

Tecla de drecera | Ordre
Ctrl + Z | Desfés l'última acció.
Ctrl + Maj + Z | Refés l'última acció desfeta.
Ctrl + X | Retalla el text o regió seleccionat i el col·loca al porta-retalls.
Ctrl + C | Copia el text o regió seleccionat al porta-retalls.
Ctrl + V | Enganxa el contingut del porta-retalls.
Ctrl + A | Selecciona-ho tot.
Ctrl + D | Suprimeix la línia actual.
Alt + Up | Move the selected line up one line.
Alt + Down | Move the selected line down one line.

Subfinestres

Dreceres per a mostrar i amagar les subfinestres:

Tecla de drecera | Ordre
F9 | Mostra/amaga la subfinestra lateral.
Ctrl + F9 | Mostra/amaga la subfinestra inferior.

Cerca

Dreceres per a cercar:

Tecla de drecera | Ordre
Ctrl + F | Cerca una cadena.
Ctrl + G | Cerca la instància següent de la cadena.
Ctrl + Maj + G | Cerca la instància anterior de la cadena.
Ctrl + K | Cerca interactiva.
Ctrl + H | Cerca i reemplaça.
Ctrl + Maj + K | Neteja el ressaltat.
Ctrl + I | Ves a la línia.

Eines

Dreceres per a les eines:

Tecla de drecera | Ordre
Maj + F7 | Comprova l'ortografia (amb connector).
Alt + F12 | Suprimeix els espais al final de les línies (amb connector).
Ctrl + T | Sagna (amb connector).
Ctrl + Maj + T | Suprimeix el sagnat (amb connector).
F8 | Executa el «make» al directori actual (amb connector).
Ctrl + Maj + D | Llistat del directori (amb connector).

Ajuda

Dreceres per a l'ajuda:

Tecla de drecera | Ordre
F1 | Obre el manual d'usuari del pluma.

## Preferències

To configure pluma, choose Edit Preferences . The Preferences dialog contains the following categories:

- pluma-prefs-view

- pluma-prefs-editor

- pluma-prefs-fontsandcolors

- pluma-prefs-plugins

### Visualitza les preferències

Text Wrapping

- Seleccioneu l'opció Habilita l'ajustament de text per a fer que les línies llargues de text es converteixin en paràgrafs enlloc de continuar pel final de la finestra de text. Això evita haver de desplaçar-se horitzontalment.

  Seleccioneu l'opció No separis les paraules en dues línies per a fer que l'opció d'ajustament del text conservi la paraula sencera quan el text salti a la línia següent. Això fa el text més fàcil de llegir.

Line Numbers

- Seleccioneu l'opció Mostra els números de línia per a mostrar els números de línia a la banda esquerra de la finestra del pluma.

Current Line

- Seleccioneu l'opció Ressalta la línia actual per a ressaltar la línia on està ubicat el cursor.

Right Margin

- Seleccioneu l'opció Mostra el marge dret per a mostrar una línia vertical que indica el marge dret.

  Utilitzeu el quadre de selecció de valors Marge dret a la columna per a especificar la ubicació de la línia vertical.

Bracket Matching

- Seleccioneu l'opció Ressalta el claudàtor concordant per a ressaltar el claudàtor corresponent quan el cursor està ubicat en un caràcter de claudàtor.

### Preferències de l'editor

Tabs

- Utilitzeu el quadre de selecció de valors Amplada de la tabulació per a especificar l'amplada de l'espai que el pluma insereix quan premeu la tecla Tab.

  Seleccioneu l'opció Insereix espais en comptes de tabulacions per a especificar que el pluma insereixi espais enlloc d'un caràcter de tabulació quan premeu la tecla Tab.

Auto Indentation

- Seleccioneu l'opció Habilita el sagnat automàtic per a especificar que la línia següent inicia el nivell de sagnat a la línia actual.

File Saving

- Seleccioneu l'opció Crea una còpia de seguretat dels fitxers abans de desar-los per a crear una còpia de seguretat d'un fitxer cada cop que deseu el fitxer. La còpia de seguretat del fitxer conté un ~ al final del nom de fitxer.

  Seleccioneu l'opció Desa els fitxers automàticament cada ... minuts per a desar automàticament el fitxer actual a intervals regulars. Utilitzeu el quadre de selecció de valors per a especificar l'interval per a desar el fitxer.

### Preferències de tipus de lletra i colors

Font

- Seleccioneu l'opció Utilitza el tipus de lletra del tema predeterminat per a utilitzar el tipus de lletra del sistema predeterminat per al text a la finestra de text del pluma.

  El camp Tipus de lletra de l'editor mostra el tipus de lletra que el pluma utilitza per a mostrar el text. Feu clic al botó per a especificar el tipus de lletra, l'estil i la mida a utilitzar per al text.

Color Scheme

- Podeu triar un esquema de color des de la llista d'esquemes de colors. Per defecte, els esquemes de color següents estan instal·lats:

  Classic

- Esquema de color clàssic basat en l'esquema de color del gvim.

Cobalt

- Esquema de color basat en el blau.

Kate

- Esquema de color que s'utilitza en l'editor de text Kate.

Oblivion

- Esquema de color fosc que utilitza la paleta de colors del Tango.

Tango

- Esquema de color que utilitza la paleta de colors del Tango.

Podeu afegir un esquema de color nou fent clic a Afegeix... i seleccionant el fitxer d'esquema de color.

Podeu suprimir l'esquema de color seleccionat fent clic a Suprimeix

### Preferències dels connectors

Els connectors afegeixen funcions extres al pluma. Per a obtenir més informació sobre els connectors i com utilitzar connectors integrats, vegeu la pluma-plugins-overview.

#### Com habilitar un connector

Per a habilitar un connector del pluma, realitzeu els passos següents:

1. Choose Edit Preferences .

2. Seleccioneu la pestanya Connectors.

3. Seleccioneu la casella de selecció al costat del nom del connector que voleu habilitar.

4. Feu clic a Tanca per a tancar el diàleg Preferències.

#### Com inhabilitar un connector

Un connector continuarà habilitat quan sortiu del pluma.

Per a inhabilitar un connector del pluma, realitzeu els passos següents:

1. Choose Edit Preferences .

2. Seleccioneu la pestanya Connectors.

3. Desseleccioneu la casella de selecció al costat del nom del connector que voleu inhabilitar.

4. Feu clic a Tanca per a tancar el diàleg Preferències.

## Connectors

### Treball amb connectors

Podeu afegir funcions addicionals al pluma en habilitar connectors. Un connector és un programa addicional que millora la funcionalitat d'una aplicació. Els connectors afegeixen elements nous als menús del pluma per a les funcions noves que proporcionen.

Diversos connectors ja venen integrats amb el pluma i en podeu instal·lar més. El lloc web del pluma llista connectors de tercers.

Per a habilitar i inhabilitar connectors o veure quins connectors estan habilitats actualment, vegeu les Preferències dels connectors.

Els connectors següents venen integrats amb el pluma:

- Canvia les majúscules/minúscules us permet canviar les majúscules/minúscules del text seleccionat.

- Estadístiques del document mostra el número de línies, paraules i caràcters al document.

- Eines externes us permet executar ordres externes des del pluma.

- Navegador de fitxers us permet navegar pels fitxers i carpetes a la subfinestra lateral.

- Sagna les línies afegeix i suprimeix el sagnat a les línies seleccionades.

- Insereix la data/hora afegeix la data i hora actuals a un document.

- Modes de línia us permet establir preferències d'edició per a documents individuals i admet estils de modes de línia de l'Emacs, el Kate i el Vim.

- Consola Python us permet executar ordres en el llenguatge de programació Python.

- Fragments us permet emmagatzemar fragments de text utilitzats freqüentment i inserir-los ràpidament a un document.

- Ordena ordena les línies de text seleccionades en ordre alfabètic.

- Comprovador d'ortografia corregeix l'ortografia del text seleccionat o marca automàticament els errors al document.

- Llistat de marcadors us permet inserir marcadors utilitzats freqüentment per a HTML i altres llenguatges des d'una llista a la subfinestra lateral.

Per a obtenir més informació sobre com crear connectors, vegeu el lloc web del pluma.

### Connector de canvi de les majúscules/minúscules

El connector Canvia les majúscules/minúscules canvia les majúscules/minúscules del text seleccionat.

Els elements següents s'afegeixen al menú Edita quan s'habilita el connector Canvia les majúscules/minúscules.

Element del menú | Acció | Exemple
Edit Change Case All Upper Case | Canvia cada caràcter a majúscules | `Aquest text` es torna `AQUEST TEXT`
Edit Change Case All Lower Case | Canvia cada caràcter a minúscules. | `Aquest text` es torna `aquest text`
Edit Change Case Invert Case | Canvia cada caràcter en minúscules a majúscules i canvia cada caràcter en majúscules a minúscules. | `Aquest Text` es torna `aQUEST tEXT`
Edit Change Case Title Case | Canvia els primer caràcter de cada paraula a majúscules. | `aquest text` es torna `Aquest Text`

### Connector d'estadístiques del document

El connector Estadístiques del document compta el número de línies, paraules, caràcters amb espais, caràcters sense espais i bytes del fitxer actual. El connector mostra els resultats al diàleg Estadístiques del document. Per a utilitzar el connector Estadístiques del document, realitzeu els passos següents:

1. Choose Tools Document Statistics to display the Document Statistics dialog. The Document Statistics dialog displays the following information about the file:

   - Número de línies al document actual.

   - Número de paraules al document actual.

   - Número de caràcters, incloent-hi els espais, al document actual.

   - Número de caràcters, sense incloure-hi el espais, al document actual.

   - Número de bytes al document actual.

2. Podeu seguir actualitzant el fitxer del pluma mentre el diàleg Estadístiques del document està obert. Per a refrescar els continguts del diàleg Estadístiques del document, feu clic a Actualitza.

### Connector d'eines externes

El connector Eines externes us permet executar ordres externes des del pluma. Podeu conduir contingut a una ordre i explotar la seva sortida (per exemple el sed) o executar una ordre predefinida (per exemple el make).

Utilitzeu el Gestor d'eines externes per a crear i editar ordres. Per a executar una ordre externa, trieu-la des del menú Eines.

#### Ordres integrades

El connector Eines externes proporciona les ordres següents:

Munta

- Executa el make al directori actual del document.

Llistat del directori

- Llista els continguts del directori actual del document en un document nou.

Variables d'entorn

- Mostra la llista de variables d'entorn a la subfinestra inferior.

Grep

- Cerca un terme a tots els fitxers del directori actual del document, utilitzant un patró de coincidència. Els resultats es mostren a la subfinestra inferior.

Suprimeix espais al final de les línies

- Suprimeix tots els espais al final de les línies del document.

#### Com definir una ordre

Per a afegir una ordre externa, trieu Eines Eines externes.

A la finestra Gestor d'eines externes, feu clic a Nou. Podeu especificar els detalls següents per a una ordre nova:

Descripció

- Aquesta descripció es mostra a la barra d'estat quan es tria l'ordre del menú.

Accelerador

- Introduïu una drecera de teclat per a l'ordre.

Ordres

- Les ordres actuals a executar. Es poden utilitzar diverses variables d'entorn del pluma per a passar contingut a aquestes ordres. Vegeu la pluma-external-tools-plugin-variables.

Entrada

- El contingut a donar a les ordres (com ara `stdin`): el text sencer del document actual o la selecció, línia o paraula actual.

Sortida

- Què fer amb la sortida de les ordres: mostrar a la subfinestra inferior, col·locar a un document nou o col·locar al document actual al final, a la posició del cursor o reemplaçant la selecció o tot el document.

Aplicabilitat

- Determina quins tipus de documents poden ser afectats per l'ordre, per exemple si s'han desat o no i si són locals o remots.

#### Com editar i suprimir eines

Per a editar una eina, seleccioneu-la a la llista i realitzeu canvis a les seves propietats.

Per a canviar el nom d'una eina, feu clic un altre cop a la llista.

Per a restaurar una eina integrada que heu canviat, premeu Recupera.

Per a suprimir una eina, seleccioneu-la a la llista i premeu Suprimeix. No podeu suprimir eines integrades, només aquelles que heu creat.

#### Variables

Podeu utilitzar les variables següents al camp Ordres de la definició de l'ordre:

- PLUMA_CURRENT_DOCUMENT_URI

- PLUMA_CURRENT_DOCUMENT_NAME

- PLUMA_CURRENT_DOCUMENT_SCHEME

- PLUMA_CURRENT_DOCUMENT_PATH

- PLUMA_CURRENT_DOCUMENT_DIR

- PLUMA_DOCUMENTS_URI

- PLUMA_DOCUMENTS_PATH

### Connector de navegador de fitxers

El connector Navegador de fitxers mostra el vostres fitxers i carpetes a la subfinestra lateral, permetent-vos obrir ràpidament els fitxers.

To view the File Browser, choose View Side Pane and then click on the tab showing the File Browser icon at the bottom of the side pane.

#### Com navegar pels vostres fitxers

La pestanya del navegador de fitxers inicialment mostra les adreces d'interes del vostre gestor de fitxers. Per a navegar pels continguts de qualsevol element, feu-hi doble clic.

Per a mostrar una carpeta pare, trieu-la a la llista desplegable o premeu la fletxa amunt a la barra d'eines del navegador de fitxers.

Per a mostrar la carpeta que conté el document en què esteu treballant actualment, feu clic amb el botó secundari a la llista de fitxers i trieu Establiu l'arrel del document actiu.

#### Com obrir un fitxer

Per a obrir un fitxer al pluma, feu-hi doble clic a la llista de fitxers.

#### Com crear fitxers i carpetes

Per a crear un fitxer de text nou i buit a la carpeta actual que es mostra al navegador, feu clic amb el botó secundari a la llista de fitxers i trieu Fitxer nou.

Per a crear una carpeta nova a la carpeta actual que es mostra al navegador, feu clic amb el botó secundari a la llista de fitxers i trieu Carpeta nova.

### Connector de sagnat de línies

El connector Sagna les línies afegeix o suprimeix espai a l'inici de les línies de text.

Per a sagnar o desfer el sagnat del text, realitzeu els passos següents:

1. Seleccioneu les línies que voleu sagnar. Per a sagnar o desfer el sagnat d'una sola línia, col·loqueu el cursor a qualsevol lloc d'aquesta línia.

2. - To indent the text, choose Edit Indent .

   - To remove the indentation, choose Edit Unindent .

La quantitat d'espai utilitzat i si s'ha d'utilitzar el caràcter de tabulació o caràcters d'espai; depèn dels paràmetres Tabulacions a l'editor de preferències. Vegeu la pluma-prefs-editor.

### Connector d'inserció de la la data/hora

El connector Insereix la data/hora insereix la data i hora actual a un document. Per a utilitzar el connector d'inserir la data/hora, realitzeu els passos següents:

1. Choose Edit Insert Date and Time .

   Si no teniu configurat el connector d'inserció de la la data/hora per a inserir automàticament la data/hora sense sol·licitar-vos-en el format, el pluma mostrarà el diàleg Insereix la data i hora. Seleccioneu el format apropiat de data/hora de la llista. Feu clic a Insereix per a tancar el diàleg Insereix la data i hora. El pluma inserirà la data/hora a la posició del cursor a la fila actual.

   Si heu configurat el pluma per a utilitzar un format particular de data/hora, no es mostrarà el diàleg Insereix la data i hora. La data/hora s'inserirà automàticament a la posició del cursor a la fila actual.

#### Configuració del connector d'inserir la data/hora

Per a configurar el connector d'inserir la data/hora, realitzeu els passos següents:

1. Choose Edit Preferences .

2. Seleccioneu la pestanya Connectors.

3. Seleccioneu el connector Insereix la data/hora.

4. Feu clic a Configura el connector per a mostrar el diàleg Configura el connector per inserir la data/hora.

5. Seleccioneu una de les opcions, tal com es mostra:

   - Per a especificar el format de data/hora cada cop que inseriu la data/hora, seleccioneu l'opció Pregunta per un format.

   - To use the same pluma-provided date/time format each time you insert the date/time, select the Use the selected format option, then select the appropriate format from the list. When you select this option, pluma does not prompt you for the date/time format when you choose Edit Insert Date and Time .

   - To use the same customized date/time format each time you insert the date/time, select the Use custom format option, then enter the appropriate format in the text box. For more information about how to specify a custom format, see

     strftime

     3. When you select this option, pluma does not prompt you for the date/time format when you choose Edit Insert Date and Time .

6. Feu clic a D'acord per a tancar el diàleg Configura el connector per inserir la data/hora.

7. Per a tancar el diàleg Preferències, feu clic a Tanca.

### Connector de modes de línia

El connector Modes de línia us permet establir les preferències per a documents individuals. Un mode de línia és una línia de text a l'inici o final del document amb paràmetres que el pluma reconeix.

Les preferències establertes utilitzant els modes de línia tenen preferència sobre les especificades al diàleg de preferències.

Podeu establir les preferències següents amb els modes de línia:

- Amplada de la tabulació

- Amplada del sagnat

- Inserir espais en comptes de tabuladors

- Ajustament de línia

- Amplada del marge dret

El connector Modes de línia admet un subconjunt de les opcions que utilitzen altres editors de text com l'Emacs, el Kate i el Vim.

#### Modes de línia de l'Emacs

Les primeres dues línies d'un document s'analitzen cercant modes de línia de l'Emacs.

S'admeten les opcions de l'Emacs per a tab-width, indent-offset, indent-tabs-mode i autowrap. Per a obtenir més informació, vegeu el Manual del GNU Emacs.

#### Modes de línia del Kate

Les primeres i últimes deu línies d'un document s'analitzen cercant modes de línia del Kate.

S'admeten les opcions del Kate per a tab-width, indent-width, space-indent, word-wrap i word-wrap-colum. Per a obtenir més informació, vegeu el lloc web del Kate.

#### Modes de línia del Vim

Les primeres i últimes tres línies d'un document s'analitzen cercant modes de línia del Vim.

S'admeten les opcions del Vim per a et, expandtab, ts, tabstop, sw, shiftwidth, wrap i textwidth. Per a obtenir més informació, vegeu el lloc web del Vim.

### Connector de consola Python

El connector Consola Python us permet executar ordres en el llenguatge de programació Python des del pluma. En habilitar el connector s'afegirà una pestanya a la subfinestra inferior. Aquest mostra l'última sortida i un camp d'entrada d'ordres.

Les ordres introduïdes a la consola Python no es comproven abans d'executar-les. Per tant és possible penjar el pluma, per exemple en introduir un bucle infinit.

### 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 pluma, els quals poden ser modificats.

#### 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.

#### 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

5. 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 pluma-snippets-plugin-syntax.

  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.

#### 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.

#### 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 pluma.

  $PLUMA_SELECTED_TEXT

- El text seleccionat actualment.

$PLUMA_FILENAME

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

$PLUMA_BASENAME

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

$PLUMA_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`.

### Connector d'ordenació

El connector Ordena col·loca les línies seleccionades de text en ordre alfabètic.

You cannot undo the Sort operation, so you should save the file before performing the sort. To revert to the saved version of the file after the sort operation, choose File Revert .

Per a utilitzar el connector d'ordenació, realitzeu els passos següents:

1. Seleccioneu les línies de text que voleu ordenar.

2. Choose Edit Sort . The Sort dialog opens.

3. Trieu les opcions que voleu per a l'ordenació:

   - Per a ordenar el text en ordre invers, seleccioneu Inverteix l'ordre.

   - Per a suprimir les línies duplicades, seleccioneu Suprimeix els duplicats.

   - Per a ignorar les diferències de majúscules i minúscules, seleccioneu Ignora diferències de majúscules i minúscules.

   - Per a fer que l'ordenació ignori els caràcters a l'inici de les línies, establiu el primer caràcter que s'hauria d'utilitzar per a ordenar al quadre de selecció de valors Comença per la columna.

4. Per a realitzar l'operació d'ordenació, feu clic a Ordena.

### Connector de comprovació d'ortografia

El connector Comprovador d'ortografia comprova l'ortografia del text seleccionat. Podeu configurar el pluma per a comprovar l'ortografia automàticament o podeu comprovar l'ortografia manualment, en l'idioma especificat. L'idioma i la comprovació automàtica d'ortografia s'apliquen per a cada document. Per a utilitzar el connector de comprovació d'ortografia, realitzeu els passos següents:

1. Choose Tools Set Language to display the Set language dialog. Select the appropriate language from the list. Click OK to close the Set language dialog.

2. To check the spelling automatically, choose Tools Autocheck Spelling . To unset the automatic spell check, choose Tools Autocheck Spelling again. When automatic spell checking is set, an icon is displayed beside the Autocheck Spelling menu item. Automatic spell checking is unset by default, each time pluma starts.

   Les paraules desconegudes es mostren d'un color diferent i subratllades. Feu clic amb el botó secundari a una paraula desconeguda i seleccioneu Suggeriments d'ortografia des del menú emergent:

   - Per a substituir la paraula desconeguda amb una altra paraula de la llista, seleccioneu la paraula substituta des del menú emergent Suggeriments d'ortografia.

   - To add the unknown spelling to your personal dictionary, select Spelling Suggestions Add .

   - To ignore all occurrences of the unknown spelling, so that they are no longer flagged as unknown but are not added to your personal dictionary, select Spelling Suggestions Ignore All . The unknown word is ignored in the current pluma session only.

3. To check the spelling manually, choose Tools Check Spelling .

   Si no hi ha errors d'ortografia, un diàleg d'Informació mostrarà un missatge indicant que aquest document no conté paraules mal escrites. Feu clic a D'acord per a tancar el diàleg Informació.

   Si hi ha errors ortogràfics, es mostrarà el diàleg Comprova l'ortografia:

   - La Paraula mal escrita es mostrarà a la part superior del diàleg.

   - Es mostrarà un suggeriment ortogràfic conegut al quadre de text Canvia a. Podeu substituir-lo amb una altra paraula coneguda en seleccionar una paraula de la llista Suggeriments o podeu introduir directament el text al quadre de text Canvia a.

   - Per a comprovar l'ortografia del text al quadre de text Canvia a, feu clic a Comprova la paraula. Si aquesta és una paraula coneguda, la llista Suggeriments serà substituïda amb el text `(ortografia correcta)`. Si la paraula no és coneguda, apareixeran entrades noves a la llista Suggeriments.

   - Per a ignorar l'ocurrència actual de la paraula desconeguda, feu clic a Ignora. Per a ignorar totes les ocurrències de la paraula desconeguda, feu clic a Ignora-ho tot. La paraula desconeguda només s'ignorarà a la sessió actual del pluma.

   - Per a canviar l'ocurrència actual de la paraula desconeguda al text del quadre de text Canvia a, feu clic a Canvia. Per a canviar totes les ocurrències de la paraula desconeguda al text al quadre de text Canvia a, feu clic a Canvia-ho tot.

   - Per a afegir la paraula desconeguda al vostre diccionari personal, feu clic a Afegeix una paraula.

   - Per a tancar el diàleg Comprova l'ortografia, feu clic a Tanca.

### Connector del llistat de marcadors

El connector Llistat de marcadors us permet inserir marcadors habituals des d'una llista a la subfinestra lateral.

Per a utilitzar el connector del llistat de marcadors, realitzeu els passos següents:

1. Choose View Side Pane .

2. Per defecte, la subfinestra lateral mostra una pestanya que conté una llista de documents oberts. Feu clic a la pestanya que mostra la icona + a la part inferior de la subfinestra lateral per a mostrar la pestanya del llistat de marcadors.

3. Seleccioneu la categoria de marcadors apropiada des de la llista desplegable. Per exemple HTML - Marcadors.

4. Desplaceu-vos pel llistat de marcadors per a trobar el marcador necessari.

5. Per a inserir un marcador a la posició del cursor al fitxer actual, feu doble clic al marcador al llistat de marcadors. També podeu inserir un marcador com segueix:

   - Per a inserir un marcador al fitxer actual i canviar el focus des de la subfinestra lateral a l'àrea de visualització, premeu Retorn.

   - Per a inserir un marcador al fitxer actual i mantenir el focus a la finestra Connector del llistat de marcadors, premeu Maj Retorn.