# Manual de Pluma

2007 MATE Documentation Project
2002 2003 2004 Sun Microsystems
2000 Eric Baudais
Proyecto de documentación de MATE
Joachim Noreiko
MATE Documentation Project
MATE
Hal Canary Added the Shortcut Keys Table
Sun Java Desktop System Documentation Team
Sun Microsystems

    gdocteam@sun.com

Eric Baudais
MATE Documentation Project

     baudais@okstate.edu

Baris Cicek provided information from earlier revisions of the pluma application. Acknowledgements
Ajit George provided information about plugins. Acknowledgements
pluma V1.0
2000

Eric Baudais baudais@okstate.edu

MATE Documentation Project

pluma Manual V2.0
March 2002

Sun GNOME Documentation Team

MATE Documentation Project

pluma Manual V2.1
June 2002

Sun GNOME Documentation Team

MATE Documentation Project

pluma Manual V2.2
August 2002

Sun GNOME Documentation Team

MATE Documentation Project

pluma Manual V2.3
September 2002

Sun GNOME Documentation Team

MATE Documentation Project

pluma Manual V2.4
January 2003

Sun GNOME Documentation Team

MATE Documentation Project

pluma Manual V2.5
March 2003

Sun GNOME Documentation Team

MATE Documentation Project

pluma Manual V2.6
September 2003

Sun GNOME Documentation Team

MATE Documentation Project

pluma Manual V2.7
March 2004

Sun GNOME Documentation Team

MATE Documentation Project

pluma Manual V2.8
July 2006

Sun Java Desktop System Documentation Team

MATE Documentation Project

pluma Manual V2.9
July 2006

MATE Documentation Team

MATE Documentation Project

Este manual describe la versión 2.16 de pluma.

Comentarios

Para informar de un error o hacer alguna sugerencia sobre la aplicación pluma o el presente manual, siga las instrucciones que aparecen en la Página de comentarios de MATE.

pluma es un editor de textos para el Escritorio MATE con características básicas pero robustas, tales como impresión, corrección ortográfica, busqueda y reemplazo y resaltado de sintaxis. Existen características más avanzadas como complementos.

## Introducción

La aplicación pluma le permite crear y editar archivos de texto.

El objetivo de pluma es ser un editor de texto simple y fácil de usar. Se pueden activar características mas potentes con diferentes complementos, permitiendo una variedad de tareas relativas a la edición de texto.

## Procedimientos iniciales

### Para iniciar pluma

Para iniciar la aplicación pluma, siga estos pasos:

Aplicaciones menú

  Seleccione Accesorios Editor de texto.

Línea de comandos

  Ejecute el comando siguiente: `pluma`

Por omisión, cuando abra un documento de texto en el gestor de archivos, pluma arrancará, y mostrará el documento.

### La ventana de pluma

Cuando inicia pluma, aparece la ventana siguiente:

Ventana de pluma

Shows pluma main window.

La ventana de pluma contiene los elementos siguientes:

Barra de menús

  Los menús de esta barra contienen todos los comandos necesarios para trabajar con archivos de pluma.

Barra de herramientas

  La barra de herramientas contiene un subconjunto de comandos a los que puede acceder desde la barra de menús.

Área de visualización

  El área de visualización contiene el texto del archivo que se está editando.

Barra de estado

  La barra de estado muestra información sobre la actividad actual de pluma e información contextual sobre los elementos de menú:

  - Muestra el número de línea y columna en que se encuentra el cursor.

  - Muestra la modalidad de edición. Si el editor está en modalidad de inserción, la barra de estado contiene la palabra INS. Si el editor está en modalidad de sobreescritura, la barra de estado contiene la palabra SOB. Pulse la tecla Insert para cambiar el modo de edición.

Panel lateral

  El panel lateral muestra una lista de los documentos abiertos y otra información dependiendo de los complementos que estén activados.

  Por omisión el panel lateral no se muestra. Para mostrarlo, elijaVer Panel lateral.

Panel inferior

  El panel inferior lo usan las herramientas de programación tales como el complemento de Consola Python para mostrar la salida. Por omisión no se muestra.

  De forma predeterminada no se muestra el panel inferior. Para mostrarlo, elija Ver Panel inferior.

Cuando se pulsa el botón derecho del ratón en la ventana de pluma, la aplicación muestra un menú emergente. El menú emergente contiene los comandos de edición de texto más habituales.

Como en otras aplicaciones de MATE, las acciones en pluma pueden realizarse de varios modos: con el menú, con la barra de herramientas, o con combinaciones de teclas. Las combinaciones de teclas comunes a todas las aplicaciones están en la Guía de usuario.

### Para abrir pluma desde una línea de comandos

Puede ejecutar pluma desde una línea de comandos y abrir uno o varios archivos. Para abrir varios archivos desde una línea de comandos, escriba este comando y pulse la tecla Intro:

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

Alternativamente, puede especificar un URI en vez de un nombre de archivo.

Para obtener más información acerca de la ejecución de pluma desde una línea de comandos, consulte la página del manual de unix para pluma pluma 1.

## Trabajar con archivos

### Creación de un documento

Para crear un documento nuevo, seleccione Archivo Nuevo. La aplicación mostrará un documento nuevo en blanco en la ventana pluma.

### Apertura de un archivo

Para abrir un archivo, seleccione Archivo Abrir para que se muestre el cuadro de diálogo Abrir archivo. Seleccione el archivo que desee abrir y después pulse Aceptar. El archivo se muestra en la ventana 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.

Puede abrir múltiples archivos en pluma. La aplicación añade a la ventana una solapa para cada archivo abierto. Para más sobre ello vea la .

### Guardado de un archivo

Puede guardar archivos de cualquiera de estas maneras:

- Para guardar los cambios a un archivo existente, elija Archivo Guardar.

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

### Abrir un archivo desde una URI

Para abrir un archivo desde un identificador de recursos uniforme (URI), lleve a cabo los siguientes pasos:

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

2. Introduzca la URI del archivo que quiere abrir.

3. Use la lista desplegable Codificación de caracteres para seleccionar la codificación de caracteres apropiada.

4. Pulse Abrir.

Los tipos de URI válidos incluyen `http:`, `ftp:`, `file:` y todos los métodos admitidos por `mate-vfs`.

Archivos desde algunos tipos de URI se abren como sólo lectura, y cualquier cambio que realice deberá guardarlo en una ubicación diferente. HTTP sólo permite lectura de archivos. Los archivos abiertos desde FTP son de sólo lectura porque no todos los servidores FTP trabajan correctamente con guardado remoto de archivos.

Guardar a servidores FTP puede activarse con el Editor de configuración, estableciendo la clave /apps/pluma/preferences/editor/save/writable_vfs_schemes, pero puede causar errores.

### Trabajar con solapas

Cuando se abre más de un archivo, pluma muestra una solapa para cada documento en la parte superior del área de visualización. Para cambiar a otro documento, pulse en su solapa.

Para mover un documento a otra ventana de pluma, arrastre la solapa correspondiente al archivo a la ventana a la que la quiere mover.

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

## Trabajar con el texto

### Editar texto

El texto de un archivo se puede editar de las siguientes maneras:

- Escriba el texto nuevo desde el teclado. El cursor de inserción parpadeante marca donde aparece el texto. Para cambiar ésto, use las teclas de flechas del teclado o pulse con el ratón.

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

### Deshacer y rehacer cambios

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

## Búsqueda y reemplazo

En pluma, hay dos modos de buscar un texto. Puede usar el diálogo Buscar para buscar un fragmento específico del texto, o Búsqueda incremental para resaltar el texto coincidente a medida que lo teclea.

### Búsqueda de texto

Para buscar en un archivo una cadena de texto, realice estos pasos:

1. Choose Search Find to display the Find dialog.

2. Escriba la cadena que desea buscar en el campo Buscar. Puede incluir caracteres especiales como línea nueva o tabulador: vea la .

3. Pulse Buscar para buscar el archivo por la primera aparición de la cadena después de la posición actual del cursor. Si pluma encuentra la cadena, la aplicación selecciona la primera aparición de la cadena. Otras apariciones de la cadena se resaltan.

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 .

### Búsqueda incremental

La búsqueda incremental resalta el texto que coincide en el documento a medida que lo teclea letra a letra. (Esto es similar a la función de búsqueda en muchos navegadores web.)

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

Empiece a teclear, y el texto que coincida será resaltado en el documento. La primera instancia después la posición del cursor también se selecciona.

Para avanzar la selección a la siguiente coincidencia mientras mantiene la casilla de búsqueda incremental abierta, pulse Ctrl G. Pulse Ctrl Mayús G para volver a la coincidencia anterior.

También puede usar las teclas de flechas arriba y abajo o la rueda del ratón para mover la selección entre coincidencias.

### Reemplazar texto

Para buscar en un archivo una cadena y sustituirla por por otra, lleve a cabo los pasos siguientes:

1. Choose Search Replace to display the Replace dialog.

2. Teclee la cadena que desea buscar, en el campo Buscar. Puede incluir caracteres especiales como linea nueva o tabulador: vea la .

3. Escriba la cadena que desea usar para reemplazar a la que se ha encontrado en el campo Reemplazar por.

Para examinar cada aparición de la cadena antes de sustituirla, pulse Buscar. Si pluma encuentra la cadena, la aplicación la selecciona. Pulse Sustituir para sustituir la aparición de la cadena seleccionada. Para encontrar la siguiente aparición de la cadena, pulse otra vez Buscar.

Para reemplazar todas apariciones de la cadena en el documento, pulse Reemplazar todo.

### Opciones buscar y reemplazar

El diálogo Buscar y el diálogo Reemplazar tienen las siguientes opciones:

- Seleccione la opción Coincidir con capitalización para encontrar solamente los casos en que la cadena coincida con la capitalización del texto que ha escrito. Por ejemplo, seleccionando Coincidir con capitalización , "TEXTO" no coincidirá con "texto".

- Seleccione la opción Coincidir sólo con la palabra completa para encontrar solamente los casos en que el texto coincida exactamente con las palabras completas que se hayan escrito. Por ejemplo, seleccionando Coincidir sólo con la palabra completa,"texto" no coincidirá con "textura".

- Seleccione la opción Buscar atrás para buscar hacia atrás hasta el principio del documento.

- Seleccione la opción Continuar desde el principio para buscar hasta el final del documento y entonces continuar la búsqueda desde el principio del documento.

### Caracteres especiales

Puede incluir las siguientes secuencias de escape en el texto para buscar o reemplazar para representar caracteres especiales:

`\n`

  Especifica una línea nueva.

`\t`

  Especifica un carácter tabulador.

`\r`

  Especifica un retorno de carro.

`\\`

  El carácter barra invertida debe escaparse si es lo que se está buscando. Por ejemplo, si está buscando «`\n`» literalmente, deberá escribir «\\n» en el campo Buscar:. O si está buscando una secuencia de barras invertidas, deberá duplicar el número de barras invertidas buscadas.

### Situar el cursor en una línea 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.

Escriba el número de la línea a la que desea desplazar el cursor y el documento se deslizará hasta la línea especificada.

Para quitar la caja y mover el cursor a la línea especificada, pulse Intro.

## Impresión

### Establecimiento de opciones de página

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

El cuadro de diálogo Configuración de página le permite especificar las opciones de impresión siguientes:

#### Solapa General

Print syntax highlighting

  Seleccione esta opción para imprimir con sintaxis resaltada. Para más información sobre el resaltado de sintaxis, vea la .

Print page headers

  Seleccione esta opción para que se incluya una cabecera en todas las páginas que se impriman. La cabecera no se puede configurar.

Line Numbers

  Seleccione la opción Impresión de números de línea para incluir los números de línea cuando imprime un archivo.

  Use el marcador incrementable Número cada … líneas para especificar la frecuencia con la que desea que se impriman los números de línea, por ejemplo cada 5 líneas, cada 10 líneas, etc.

Text Wrapping

  Seleccione la opción Activar ajuste de texto para desplazar el resto del texto a la siguiente línea, cuando se llega a un número de carácter determinado, al imprimir un archivo. La aplicación cuenta las líneas desplazadas como si fueran una sola en lo que respecta a la numeración.

  Seleccione la opción No partir palabras en dos líneas para ajustar texto a la línea siguiente, en el nivel de palabra, cuando imprime un archivo.

#### Tipografía

Body

  Pulse en este botón con el fin de seleccionar la tipografía que desea usar para imprimir el cuerpo del texto de un archivo.

Line numbers

  Pulse en este botón para seleccionar la tipografía que desea usar para imprimir los números de línea.

Headers and footers

  Pulse en este botón con el fin de seleccionar la tipografía que desea usar para imprimir las cabeceras en un archivo.

Para restablecer las tipografías a los valores predeterminados para imprimir un archivo desde pluma pulse en el botón Restablecer las tipografía predeterminada.

### Impresión de un documento

La aplicación pluma se puede utilizar para realizar las operaciones de impresión siguientes:

- Imprimir un documento en una impresora.

- Imprimir la salida del comando de impresión en un archivo.

Si imprime en un archivo, pluma envía la salida a un archivo de formato de preimpresión. Los formatos de preimpresión más comunes son PostScript y 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 cuadro de diálogo Imprimir permite especificar las opciones de impresión siguientes:

#### Solapa tarea de impresión

Print range

  Seleccione una de las opciones siguientes para determinar cuántas páginas quiere imprimir:

  - All

    Seleccione esta opción para imprimir todas las páginas del archivo.

  - Lines

    Seleccione esta opción para imprimir sólo las líneas especificadas. Use los marcadores incrementables Desde y A para especificar el rango de líneas.

  - Selection

    Seleccione esta opción para imprimir sólo el texto seleccionado. Esta opción sólo está disponible si previamente se ha seleccionado texto.

Copies

  Use el marcador incrementable Número de copias para especificar el número de copias del archivo que desea imprimir.

  Si va a imprimir varias copias del archivo, seleccione la opción Intercalar para intercalar las copias impresas.

#### Solapa impresora

Printer

  Use esta lista desplegable para seleccionar la impresora en la que quiera imprimir el archivo.

Settings

  Use esta lista desplegable para seleccionar la configuración de la impresora.

  Para configurar la impresora, pulse Configurar. Por ejemplo, puede permitir o no la impresión dúplex, o programar una impresión para más tarde, si ésta función está soportada en la impresora.

Location

  Use esta lista desplegable para seleccionar uno de las siguientes destinos de impresión:

  CUPS

    Imprime el archivo a una impresora CUPS.

    Si la impresora seleccionada es una impresora CUPS, CUPS es la única entrada en esta lista desplegable.

  lpr

    Imprime el archivo en una impresora.

  File

    Imprime el archivo en un archivo PostScript.

    Pulse Guardar como para mostrar un diálogo cuando especifique el nombre y ubicación del archivo PostScript.

  Custom

    Use el comando especificado para imprimir el archivo.

    Teclee el nombre del comando en la caja de texto. Incluya todos los argumentos de línea de comandos.

State

  Esta funcionalidad no está soportada en esta versión de pluma.

Type

  Esta funcionalidad no está soportada en esta versión de pluma.

Comment

  Esta funcionalidad no está soportada en esta versión de pluma.

#### Solapa papel

Paper size

  Use esta lista desplegable para seleccionar el tamaño del papel en el que desea imprimir el archivo.

Width

  Use este marcador incrementable para especificar la anchura del papel. Use la lista desplegable contigua para cambiar la unidad de medida.

Height

  Use este marcador incrementable para especificar la altura del papel.

Feed orientation

  Utilice esta lista desplegable para seleccionar la orientación del papel en la impresora.

Page orientation

  Use esta lista desplegable para seleccionar la orientación de la página.

Layout

  Use esta lista desplegable para determinar la disposición de la página. En el área de Previsualización se muestra una vista previa de la disposición de las páginas que haya seleccionado.

Paper tray

  Use esta lista desplegable para seleccionar la bandeja de papel.

## Características de programación

Varias de las características para programación de pluma las proporcionan complementos. Por ejemplo, el complemento Lista de etiquetas proporciona una lista de etiquetas comúnmente usadas para diferentes lenguajes de marcado: vea .

### Resaltado de sintaxis

El resaltado de sintaxis hace el código fuente más legible mostrando diferentes partes del texto en diferentes colores.

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 mostrar ningún resaltado de sintaxis.

Sources

  Muestra el resaltado de sintaxis para editar código fuente. Use el submenú Fuentes para seleccionar el tipo de código fuente.

Markup

  Muestra resaltado de sintaxis para editar código marcado. Use el submenú Marcado para seleccionar el tipo de marcado de código.

Scripts

  Muestra resaltado de sintaxis para editar código de scripts. Use el submenú Scripts para seleccionar el tipo de código de script.

Others

  Muestra el marcado de sintaxis para editar otros tipos de código. Use el submenú Otros para seleccionar el tipo de código.

### Redirección la salida de un comando a un archivo

La aplicación pluma se puede usar para redirigir la salida de un comando a un archivo de texto. Por ejemplo, para redirigir la salida del comando `ls` a un archivo de texto, escriba `ls | pluma` y a continuación pulse Intro.

La salida del comando `ls` se muestra en un archivo de texto nuevo de la ventana pluma.

Alternativamente, puede usar el complemento Herramientas externas para conducir la salida de un comando al archivo actual.

## Teclas rápidas

Use las teclas rápidas para realizar tareas comunes más rápidamente que con el ratón y los menús. Las siguientes tablas listan todas las teclas rápidas de pluma.

Para obtener más información sobre las teclas rápidas, vea la Guía del usuario del escritorio.

#### Solapas

Teclas rápidas para las solapas:

Tecla rápida | Comando
--- | ---
Ctrl + Alt + RePág | Cambia a la siguiente solapa a la izquierda.
Ctrl + Alt + AvPág | Cambia a la siguiente solapa a la derecha.
Ctrl + W | Cerrar la solapa.
Ctrl + Mayús. + L | Guardar todas las solapas.
Ctrl + Mayús. + W | Cerrar todas las solapas.
Alt + n | Saltar a la enésima solapa.

#### Archivos

Teclas rápidas para trabajar con archivos:

Tecla rápida | Comando
--- | ---
Ctrl + N | Crear un nuevo documento.
Ctrl + O | Abrir un documento.
Ctrl + L | Abrir un lugar.
Ctrl + S | Guardar el documento actual al disco.
Ctrl + Mayús. + S | Guardar el documento actual con un nuevo nombre de archivo.
Ctrl + P | Imprimir el documento actual.
Ctrl + Mayús. + P | Vista preliminar de impresión.
Ctrl + W | Cerrar el documento actual.
Ctrl + Q | Salir de Pluma.

#### Editar

Teclas rápidas para editar documentos:

Tecla rápida | Comando
--- | ---
Ctrl + Z | Deshacer la última acción.
Ctrl + Mayús. + Z | Rehacer la última acción deshecha.
Ctrl + X | Copiar el texto o región seleccionado y ubicarlo en el portapapeles.
Ctrl + C | Copiar el texto o región seleccionado al portapapeles.
Ctrl + V | Pegar el contenido del portapapeles.
Ctrl + A | Seleccionar todo.
Ctrl + D | Borrar la línea actual.
Alt + Arriba | Mover la línea seleccionada una línea arriba.
Alt + Abajo | Mover la línea seleccionada una línea abajo.

#### Paneles

Teclas rápidas para mostrar y ocultar los paneles:

Tecla rápida | Comando
--- | ---
F9 | Mostrar/ocultar el panel lateral.
Ctrl + F9 | Mostrar/ocultar el panel inferior.

#### Buscar

Teclas rápidas para búsquedas:

Tecla rápida | Comando
--- | ---
Ctrl + F | Buscar una cadena.
Ctrl + G | Buscar la siguiente instancia de una cadena.
Ctrl + Mayús. + G | Buscar la instancia anterior de una cadena.
Ctrl + K | Búsqueda interactiva.
Ctrl + H | Buscar y reemplazar.
Ctrl + Mayús. + K | Limpiar el resaltado.
Ctrl + I | Ir a la línea.

#### Herramientas

Teclas rápidas para las herramientas:

Tecla rápida | Comando
--- | ---
Mayús. + F7 | Comprobar ortografía (con complemento).
Alt + F12 | Eliminar espacios finales (con complemento).
Ctrl + T | Sangría (con complemento).
Ctrl + Mayús. + T | Quitar sangría (con complemento).
F8 | Ejecutar «make» en el directorio actual (con complemento).
Ctrl + Mayús. + D | Listado de directorio (con complemento).

#### Ayuda

Teclas rápidas para la ayuda:

Tecla rápida | Comando
--- | ---
F1 | Abra el manual del usuario de pluma.

## Preferencias

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

### Preferencias de visualización

Text Wrapping

  Seleccione la opción Activar ajuste de texto para hacer que las líneas largas que se conviertan en párrafos en lugar de perderse por el borde de la ventana de texto. Esto evita tener que desplazarse horizontalmente

  Seleccione la opción No partir palabras en dos líneas para que la opción de ajustar el texto conserve las palabras enteras cuando el texto salte a la siguiente línea. Esto hace el texto más fácil de leer.

Line Numbers

  Seleccione esta opción para que se muestren números de línea en la parte izquierda de la ventana de pluma.

Current Line

  Seleccione la opción Resaltar la línea actual para resaltar la línea donde se ubica el cursor.

Right Margin

  Seleccionar Visualizar margen derecho opción para visualizar la linea vertical que indica el margen derecho.

  El cuadro de diálogo Imprimir permite especificar las opciones de impresión siguientes.

Bracket Matching

  Seleccione la opción Resaltar coincidencia de corchetes para resaltar el corchete correspondiente cuando el cursor está posicionado en un carácter corchete.

### Preferencias del Editor

Tabs

  Use el marcador incrementable Ancho de tabulador para especificar la anchura de espacio que pluma inserta cuando se pulsa la tecla Tabulador.

  Seleccione la opción Insertar espacios en lugar de tabuladores para especificar que pluma inserte espacios en lugar de caracteres de tabulador al pulsar la tecla Tabulador.

Auto Indentation

  Seleccione la opción Activar sangría automática para especificar que la línea siguiente empiece con el nivel de sangrado de la línea actual.

File Saving

  Seleccione la opción Crear una copia de respaldo de los archivos antes de guardar para crear una copia de seguridad de los archivos cada vez que se procede a guardarlos. La copia de seguridad de un archivo contiene una tilde (~) al final del nombre de archivo.

  Seleccione la opción Autoguardar archivos cada … minutos para guardar automáticamente el archivo actual a intervalos regulares. Use el marcador incrementable para especificar el intervalo para guardar el archivo.

### Preferencias de Tipografías y colores

Font

  Seleccione esta opción para usar la fuente de sistema predeterminada para el texto de la ventana de pluma.

  Este campo muestra la fuente que pluma usa para mostrar texto. Pulse en el botón para especificar el tipo, estilo y tamaño de fuente que desea usar para el texto.

Color Scheme

  Puede elegir un esquema de color de la lista de esquemas de colores. Los siguientes esquemas de color están instalados de forma predeterminada:

  Classic

    Esquema de color clásico basado en el esquema de color de gvim.

  Cobalt

    Esquema de color basado en el azul

  Kate

    Esquema de color usado en el editor de textos Kate.

  Oblivion

    Esquema de color oscuro usando la paleta de color Tango.

  Tango

    Esquema de color usando el esquema de color Tango.

  Puede añadir un esquema de color nuevo pulsando en Añadir... y seleccionando un archivo de esquema de color.

  Puede quitar el esquema de color seleccionar pulsando en Quitar

### Preferencias de Complementos

Los complementos añaden características extras a pluma. Para más información acerca de los complementos y cómo usar los complementos integrados, vea la .

#### Activación de un complemento

Para activar un complemento de pluma, realice los siguientes pasos:

1. Choose Edit Preferences .

2. Seleccione la solapa Complementos.

3. Seleccione la casilla junto al nombre del complemento que desea activar.

4. Pulse en Cerrar para cerrar el cuadro de diálogo Preferencias.

#### Desactivación de un complemento

Un complemento permanece activado cuando sale de pluma.

Para desactivar un complemento de pluma, realice los siguientes pasos:

1. Choose Edit Preferences .

2. Seleccione la solapa Complementos.

3. Deseleccione la casilla junto al nombre del complemento que desea desactivar.

4. Pulse en Cerrar para cerrar el cuadro de diálogo Preferencias.

## Complementos

### Trabajar con complementos

Puede añadir características extras a pluma añadiendo complementos. Un complemento es un programa suplementario que aumenta la funcionalidad de una aplicación. Los complementos añaden elementos nuevos a los menús de pluma para las características nuevas que proporcionan.

Varios complementos vienen integrados con pluma, y puede instalar más. El sitio web de pluma lista complementos de terceros.

Para activar o desactivar complementos, o ver qué complementos están activados use las Preferencias de complementos.

Los siguientes complementos vienen integrados con pluma:

- Cambio de capitalización le permite cambiar la capitalización del texto seleccionado.

- Estadísticas del documento muestra el número de líneas, palabras, y caracteres en el documento.

- Herramientas externas le permite ejecutar comandos externos desde pluma.

- Examinador de archivos le permite examinar sus archivos y carpetas en los paneles laterales.

- Sangría de líneas añade o elimina la sangría de las líneas seleccionadas.

- Insertar fecha/hora añade la fecha actual y la hora a un documento.

- Líneas de modo le permite establecer preferencias de edición para documentos individuales, soportando estilos de líneas de modo de Emacs, Kate y Vim.

- Consola Python le permite ejecutar comandos en el lenguaje de programación python.

- El complemento Recortes le permite almacenar trozos de texto usados frecuentemente, llamados recortes, e insertarlos rápidamente en un documento.

- Ordenar ordena las líneas seleccionadas de texto en orden alfabético.

- Ortografía corrige la ortografía en el texto seleccionado, o marca errores automáticamente en el documento.

- Lista de etiquetas le permite insertar etiquetas usadas comúnmente para HTML y otros lenguajes de una lista en el panel lateral.

Para obtener más información acerca de cómo crear complementos, consulte el sitio web de pluma.

### Complemento Cambiar capitalización

El complemento Cambiar capitalización le permite cambiar la capitalización del texto seleccionado.

Los siguientes elementos se añaden al menú Editar cuando está activado el complemento Cambiar capitalización:

Elemento del menú | Acción | Ejemplo
--- | --- | ---
Edit Change Case All Upper Case | Cambiar cada carácter a mayúsculas. | `Este texto` se convierte `ESTE TEXTO`
Edit Change Case All Lower Case | Cambia cada carácter a minúsculas. | `Este Texto` se convierte en `este texto`
Edit Change Case Invert Case | Cambiar cada carácter de minúscula a mayúscula y viceversa. | `Este Texto` se convierte en `eSTE tEXTO`
Edit Change Case Title Case | Cambiar el primer carácter de cada palabra a mayúscula. | `este texto` se convierte en `Este Texto`

### Complemento Estadísticas del documento

El complemento Estadísticas del documento cuenta el número de líneas, palabras, caracteres con espacios, caracteres sin espacios y bytes del archivo actual. El complemento muestra el resultado en un diálogo Estadísticas del documento. Para utilizar el complemento Estadísticas del documento, siga estos pasos:

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íneas del documento actual.

   - Número de palabras del documento actual.

   - Número de caracteres, espacios incluidos, del documento actual.

   - Número de caracteres, espacios excluidos, del documento actual.

   - Número de bytes del documento actual.

2. Puede seguir actualizando el archivo de pluma mientras el diálogo Estadísticas del documento esté abierto. Para actualizar el contenido del cuadro de diálogo Estadísticas del documento, pulse en el botón Actualizar.

### Complemento de herramientas externas

El complemento Herramientas externas permite ejecutar comandos externos desde pluma. Puede encauzar contenido a un comando y explotar su salida (por ejemplo, sed), o lanzar un comando predefinido (por ejemplo, make).

Use el Gestor de herramientas externas para crear y editar comandos. Para ejecutar un comando externo, elíjalo de entre el menú Herramientas.

#### Comandos integrados

Los siguientes comandos se proporcionan con el complemento Herramientas externas:

Construir

  Ejecuta la aplicación make en el directorio del documento actual.

Listado de directorio

  Lista el contenido del directorio del documento actual en un nuevo documento.

Variables de entorno

  Muestra la lista de variables de entorno en el panel inferior.

Grep

  Busca un término en todos los archivos en el directorio actual del documento, usando coincidencia de patrones. El resultado se muestra en el panel inferior.

Eliminar espacios finales

  Quita todos los espacios del final de las líneas en el documento.

#### Definir un comando

Para añadir un comando externo, elija Herramientas Herramientas externas.

En la ventana del Gestor de herramientas externas, pulse Nuevo. Puede especificar los siguientes detalles para el comando nuevo:

Descripción

  Esta descripción se muestra en la barra de estado cuando se elije el comando de menú.

Acelerador

  Introduzca un atajo de teclado para el comando.

Comandos

  Los comandos actuales para ejecutar. Se pueden usar varias variables de entorno de pluma para pasar contenido a estos comandos: vea .

Entrada

  El contenido para dar a los comandos (como stdin): el texto entero del documento actual, la selección, la línea o palabra actual.

Salida

  Qué hacer con la salida de los comandos: mostrarla en el panel inferior, ponerla en un documento nuevo, colocarla en el documento actual, al final, en la posición del cursor, o reemplazar la selección del documento entero.

Aplicabilidad

  Determina qué clase de documentos pueden verse afectados por el comando, por ejemplo si están guardados o no, los locales o los remotos.

#### Editar y quitar herramientas

Para editar una herramienta, selecciónela en la lista y haga cambios a sus propiedades.

Para renombrar una herramienta, pulse otra vez en la lista.

Para restaurar una herramienta integrada que haya modificado, pulse Revertir.

Para quitar una herramienta, selecciónela en la lista y pulse Quitar. No puede quitar los herramientas integradas, sólo aquellas que haya creado.

#### Variables

Puede usar las siguientes variables en el campo Comandos de la definición del comando:

- 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

### Complemento del examinador de archivos

El complemento del Examinador de archivos muestra sus archivos y carpetas en el panel lateral, permitiéndole abrir rápidamente archivos.

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.

#### Examinar sus archivos

La solapa del visor de archivos muestra inicialmente sus marcadores del gestor de archivos. Para examinar el contenido de cualquier elemento, pulse dos veces en él.

Para mostrar una carpeta madre, elija de la lista desplegable, o pulse la flecha arriba en la barra de herramientas del gestor de archivos.

Para mostrar la carpeta que contiene el documento en el que está trabajando actualmente, pulse dos veces en la lista del archivo y elija Establecer raíz al documento activo.

#### Apertura de un archivo

Para abrir un archivo en pluma, pulse dos veces en él en la lista de archivos.

#### Crear archivos y carpetas

Para crear un archivo de texto nuevo vacío en la carpeta actual mostrada en el examinador, pulse con el botón derecho en la lista de archivos y elija Archivo nuevo.

Para crear una carpeta nueva en la carpeta actual mostrada en el examinador, pulse con el botón derecho en la lista de archivos y elija Nueva carpeta.

### Complemento Sangrar líneas

El complemento de Sangrar líneas añade o quita espacio del principio de las líneas de texto.

Para sangrar o quitar la sangría del texto, realice los siguientes pasos:

1. Seleccione las líneas que desea sangrar. Para sangrar o anular el sangrado de una única línea, sitúe el cursor en cualquier posición dentro de la línea.

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

   - To remove the indentation, choose Edit Unindent .

La cantidad de espacio usado, y dependiendo de si se usan caracteres de tabulación o caracteres de espacio, depende de los ajustes de Puntos de tabulación en las preferencias del Editor: vea .

### Complemento Insertar fecha/hora

El complemento Insertar fecha/hora inserta la fecha y la hora actuales en un documento. Para utilizar el complemento Insertar fecha/hora, realice los siguientes pasos:

1. Choose Edit Insert Date and Time .

   Si no ha configurado el complemento Insertar fecha/hora para insertar automáticamente la fecha y la hora sin solicitar el formato, pluma mostrará el diálogo Insertar fecha y hora. Seleccione el formato de fecha/hora apropiado en la lista. Pulse en el botón Insertar para cerrar el diálogo Insertar fecha y hora;pluma insertará la fecha y la hora en el archivo actual, en la posición del cursor.

   Si ha configurado pluma para que utilice un formato de fecha/hora especifico, no se mostrará el diálogo Insertar fecha y hora; la fecha y la hora se insertarán automáticamente en el archivo actual, en la posición del cursor.

#### Para configurar el complemento Insertar fecha/hora

Para configurar el complemento Insertar fecha/hora, realice los siguientes pasos:

1. Choose Edit Preferences .

2. Seleccione la solapa Complementos.

3. Seleccione el complemento Insertar fecha/hora.

4. Pulse en Configurar el complemento para abrir el cuadro de diálogo Configurar el complemento Insertar fecha/hora.

5. Seleccione una de las siguientes opciones:

   - Para especificar el formato de fecha/hora cada vez que inserte este dato, seleccione la opción Preguntar por un formato.

   - 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. Pulse en Aceptar para cerrar el cuadro de diálogo Configurar el complemento Insertar fecha/hora.

7. Para cerrar el cuadro de diálogo Preferencias, pulse Cerrar.

### Complemento líneas de modo

El complemento Líneas de modo le permite establecer preferencias para documentos individuales. Una línea de modo es una línea de texto al principio o final del documento con ajustes que pluma reconoce.

Las preferencias establecidas para usar líneas de modo tienen preferencia sobre las especificadas en el diálogo de preferencias.

Puede establecer las siguientes preferencias con líneas de modos:

- Ancho de tabulación

- Anchura de la sangría

- Insertar espacios en lugar de tabuladores

- Ajuste de texto

- Anchura del margen derecho

El complemento Líneas de Modos soporta un subconjunto de las opciones usadas por los otros editores de texto Emacs, Kate y Vim.

#### Líneas de modo Emacs

Las primeras dos líneas de un documento se analizan buscando líneas de modos Emacs.

Se soportan las opciones Emacs para tab-width, indent-offset, indent-tabs-mode y autowrap. Para obtener más información, consulte el manual de GNU Emacs.

#### Líneas de modo Kate

La primera y las últimas diez líneas de un documento se analizan buscando líneas de modo Kate.

Se soportan las opciones Kate para tab-width, indent-width, space-indent, word-wrap and word-wrap-column. Para más información, vea el sitio web de Kate.

#### Líneas de modo Vim

La primera y las últimas tres líneas de un documento se escanean buscando líneas de modo Vim.

Se soportan las opciones Vim para et, expandtab, ts, tabstop, sw, shiftwidth, wrap, y textwidth. Para obtener más información, consulte la ">página web de Vim.

### Complemento consola Python

El complemento Consola Python le permite ejecutar comandoes en el lenguaje de programación Python desde pluma. Activando el complemento se añade una solapa al panel inferior. Esta muestra su salida reciente y un campo de entrada de comandos.

Los comandos introducidos en la consola de python no se comprueban antes de ejecutarlos. Es posible entonces colgar pluma, por ejemplo entrando un bucle infinito.

### Complemento Recortes

El complemento Recortes le permite almacenar trozos de texto usados frecuentemente, llamados recortes, e insertarlos rápidamente en un documento.

Los recortes son específicos a la sintaxis del lenguaje del documento actual. Por ejemplo, cuando esta trabajando en un documento HTML, puede elegir de una lista de recortes que son útiles para HTML. Además, algunos recortes son globales, y están disponibles para todos los documentos.

Junto con pluma, se instalan varios recortes, que pueden modificarse.

#### Inserción de recortes

Para insertar un recorte en un documento, teclee su disparador y pulse Tab. El disparador de un recorte es usualmente las primeras pocas letras del recorte, o algo parecido que sea corto y fácil de recordar.

Alternativamente, pulse Ctrl Espacio para ver una lista de recortes que puede insertar.

#### Adición de recortes

Puede crear un recorte nuevo, haga lo siguiente:

1. Seleccione Herramientas Gestión de Recortes. La ventana del Gestor de Recortes se abre.

2. La lista de recortes esta agrupada por lenguajes. Seleccione el lenguaje con el que quiere añadir el recorte, o un recorte en ese grupo de lenguajes. Para añadir un recorte para todos los lenguajes, elija Global en la parte superior de la lista. La sintaxis del documento con el que esta trabajando actualmente se muestra por omisión.

3. Pulse Nuevo. Aparece un recorte nuevo en la lista.

4. Introduzca la siguiente información para el recorte nuevo:

   Nombre

     Introduzca un nombre para el recorte en el campo de texto dentro de la lista de recortes. El nombre de un recorte sirve sólo como recordatorio de su propósito. Puede cambiar el nombre de un recorte que cree para pulsar en él en la lista.

   Texto del recorte

     Introduzca el texto del recorte en la caja de texto Editar recorte. Para códigos especiales, que pueda usar, vea .

     Puede volver a la ventana del documento para copiar texto sin cerrar la ventana del Gestor de recortes.

   Disparador de tabulador

     Introduzca el disparado para el recorte. Este es el texto que teclea antes de pulsar la tecla Tab para insertar el recorte.

     La etiqueta debe ser o una sola palabra comprendiendo sólo letras, o cualquier carácter en solitario. El disparador se resaltará en rojo si se introduce un disparador inválido.

   Tecla rápida

     Teclee una tecla de acceso rápido para usarla para insertar el recorte.

#### Editar y quitar recortes

Para editar un recorte, selecciónelo en la lista y haga cambios a sus propiedades de activación de texto.

Para renombrar un recorte, pulse otra vez en la lista.

Para restaurar un recorte integrado que haya modificado, pulse Revertir.

Para quitar un disparador, selecciónelo en la lista y pulse Quitar. No puede quitar los recortes integrados, sólo aquellos que usted haya creado.

#### Sustituciones de recortes

Además de insertar texto almacenado, un recorte puede incluir texto personalizado, o marcar espacios donde puede añadir texto una vez que el recorte se ha insertado en su documento.

Puede usar los siguientes códigos de reserva de espacio en el texto del recorte:

Reservas de espacio para tabuladores

  `$n` define un lugar de reserva de tabulador donde `n` es cualquier número desde 1 en adelante.

  `${n:default}` define una reserva de espacio de tabulación con un valor diferente.

  Una reserva de espacio de tabulación marca un lugar en el texto de un recorte donde puede añadir texto adicional después de insertar el recorte.

  Para usar las reservas de espacio, inserte el recorte de forma normal. El cursor se coloca en la primera reserva de espacio. Teclee el texto, pulse la tecla Tab para avanzar a la siguiente reserva de espacio. El número en el código de la reserva de espacio define el orden en que cada tabulación avanza a cada lugar del texto.

  Pulse Mayús Tab para volver al anterior reserva de espacio para tabulador. Pulsando Tab cuando no hay más reservas de espacio de tabulador mueve el cursor al final del recorte de texto, o a la reserva de espacio al final si existe.

Replicar reservas de espacio

  Una reserva de espacio repetida replicará la reserva de espacio ya definida. Esto permite teclear texto sólo una vez cuando quiere que aparezca varias veces en el recorte.

Terminar reserva de espacio

  `$0` define el final de la reserva de espacio. Esto le permite terminar de trabajar con el recorte con el cursor en un punto distinto que el final del texto recortado.

Variables de entorno

  Las variables de entorno como `$PATH` y `$HOME` se sustituyen en el texto del recorte. Las siguientes variables específicas de pluma se pueden usar también:

  $PLUMA_SELECTED_TEXT

    El texto actualmente seleccionado.

  $PLUMA_FILENAME

    El nombre completo del documento, o una cadena vacía si el documento no está guardado aún.

  $PLUMA_BASENAME

    El nombre base del nombre de archivo del documento, o una cadena vacía si el documento aún no se ha guardado.

  $PLUMA_CURRENT_WORD

    La palabra en al lugar del cursor en el documento. Cuando esta variable se esté usando, la palabra actual se reemplazará con el texto del recorte.

Reservas de espacio de shell

  `$(cmd)` se reemplaza por el resultado de ejecutar cmd en una shell.

  `$(n:cmd)` le permite dar esta reserva de espacio una referencia, donde n es cualquier número desde 1 hacia adelante. Use `$n` para usar la salida desde una reserva de espacio de shell como entrada en otra.

Reservas de espacio de Python

  `$<cmd>` se reemplaza por el resultado de evaluar cmd en el intérprete de python.

  `$<a:cmd>` especifica otra reserva de espacio python como una dependencia, donde a da su orden en el recorte. Esto le permite usar funciones python definidas en otro recorte. Para especificar varias dependencias, separe los números con comas así: `$<a,b:cmd>`

  Para usar una variable en todos los otros recortes de python, declárela como `global`.

### Complemento Ordenar

El complemento Ordenar coloca las líneas seleccionadas en orden alfabético.

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 .

Para utilizar el complemento Ordenar, realice los siguientes pasos:

1. Seleccione las líneas de texto que quiere ordenar.

2. Choose Edit Sort . The Sort dialog opens.

3. Elija las opciones que quiera para la ordenación:

   - Para ordenar el texto en orden inverso, seleccione la opción Orden inverso.

   - Para borrar las líneas duplicadas, seleccione la opción Eliminar duplicados.

   - Para no distinguir entre mayúsculas y minúsculas, seleccione la opción Ignorar capitalización.

   - Para que la ordenación ignore los caracteres al principio de las líneas, establezca el primer carácter que debería usarse para ordenar en el marcador incrementable Empezar en la columna.

4. Para efectuar la ordenación, pulse el botón Ordenar.

### Complemento Corrector ortográfico

El complemento Corrector ortográfico revisa la ortografía del texto seleccionado. Puede configurar pluma para revisar la ortografía automáticamente, o puede revisar la ortografía manualmente, en el idioma especificado. El idioma y las propiedades del revisor de ortografía, se aplican por cada documento. Para usar el complemento Corrector ortográfico, realice los siguientes pasos:

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.

   Las ortografías desconocidas se muestran en un color diferente, y subrayado. Pulse en el botón derecho en una ortografía desconocida, después seleccione Sugerencias de ortografía del menú emergente:

   - Para sustituir la ortografía desconocida por otra ortografía en la lista, seleccione sustituir ortografía desde Sugerencias de ortografía del menú emergente.

   - 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 hay errores de ortografía, un diálogo de Información visualiza un mensaje expone que el documento no contiene palabras mal escritas. Pulse Aceptar para cerrar el diálogo de Información.

   Si hay errores de ortografía, el Revisor de Ortografía diálogo se visualiza:

   - La Palabra mal escrita se visualiza en la parte de arriba del diálogo.

   - Una sugerencia de ortografía conocida es visualizada en la casilla de textoCambiar a. Puede sustituirse ésta con otra palabra conocida seleccionado una ortografía de la lista de Sugerencias, o puede introducir el texto directamente en la casilla de texto de Cambiar a.

   - Para revisar la ortografía del texto en la casilla de texto de Cambiar por, pulse Comprobar palabra. Si ésta es una palabra conocida, la lista Sugerenciasserá sustituida con el texto `(ortografía correcta)`. Si la palabra es desconocida, aparecerán nuevas entradas en la lista de Sugerencias.

   - Para ignorar en ese momento la palabra desconocida señalada, pulse Ignorar. Para ignorar todas las palabras desconocidas, pulse Ignorar todo. La palabra desconocida es ignorada sólo en la sesión actual de pluma.

   - Para cambiar la palabra desconocida señalada al texto en la casilla de texto Cambiar a, pulse Cambiar. Para cambiar todas las palabras desconocidas al texto en la casilla de texto Cambiar por, pulse Cambiar todo.

   - Para añadir la palabra desconocida a su diccionario personal, pulse el botón Añadir palabra.

   - Para cerrar el cuadro de diálogo Ir a la línea, pulse en el botón Cerrar.

### Complemento Lista de etiquetas

La aplicación Lista de etiquetas le permite insertar etiquetas comunes de una lista en el panel lateral.

Para utilizar el complemento Lista de etiquetas, realice los siguientes pasos:

1. Choose View Side Pane .

2. Por omisión, el panel lateral muestra una solapa conteniendo una lista de documentos abiertos. pulse en la solapa mostrando un icono + en la parte de abajo del panel lateral para mostrar la solapa de listas de etiquetas.

3. Seleccione la categoría de etiquetas apropiada en la lista desplegable; por ejemplo, `Etiquetas HTML`.

4. Desplácese en la lista hasta encontrar la etiqueta deseada.

5. Para insertar una etiqueta en la posición del cursor del archivo actual, pulse dos veces sobre la etiqueta en la lista. También puede emplear este procedimiento:

   - Para insertar una etiqueta en el archivo actual y cambiar el foco desde el panel lateral al área de visualización, pulse Intro.

   - Para insertar una etiqueta en el archivo actual y mantener el foco en la ventana del complemento Lista de etiquetas, pulse Mayús Intro.

pluma
text editor