# Handbok för Pluma

## Introduktion

Programmet pluma låter dig skapa och redigera textfiler.

Målet med pluma är att vara en enkel och lättanvänd textredigerare. Mer kraftfulla funktioner kan aktiveras med olika insticksmoduler, som erbjuder en mängd funktioner relaterade till textredigering.

## Komma igång

### Starta pluma

Du kan starta pluma på följande sätt:

Program-menyn

- Välj Tillbehör Textredigerare.

Kommandorad

- Kör följande kommando: `pluma`

Som standard, när du öppnar ett textdokument i filhanteraren, kommer pluma att starta och visa dokumentet.

### Pluma-fönstret

När du startar pluma visas följande fönster:

#### Pluma-fönstret

Shows pluma main window.

pluma-fönstret innehåller följande element:

Menyrad

- Menyerna på menyraden innehåller alla de kommandon som du behöver för att arbeta med filer i pluma.

Verktygsrad

- Verktygsraden innehåller en del av de kommandon som du kan komma åt i menyraden.

Visningsrutan

- Visningsrutan innehåller texten för filer som du redigerar.

Statusrad

- Statusraden visar information om aktuell aktivitet i pluma och sammanhangsinformation om menyobjekten. Statusraden visar även följande information:

  - Markörposition: rad- och kolumnnumret där markören är placerad.

  - Redigeringsläge: Om redigeraren är i infogningsläge kommer statusraden att innehålla texten INF. Om redigeraren är i överskrivningsläge kommer statusraden att innehålla texten ÖVR. Tryck på tangenten Insert för att ändra redigeringsläge.

Sidopanel

- Sidopanelen visar en lista över öppnade dokument, och annan information beroende på vilka insticksmoduler som är aktiverade.

  Som standard visas inte sidopanelen. Välj Visa Sidopanel för att visa den.

Underpanelen

- Underpanelen används av programmeringsverktyg, som till exempel insticksmodulen Python-konsoll, för att visa utdata.

  Som standard visas inte underpanelen. Välj Visa Underpanel för att visa den.

När du högerklickar i pluma-fönstret kommer programmet att visa en popup-meny. Popup-menyn innehåller de mest vanliga textredigeringskommandona.

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.

### Kör pluma från en kommandorad

Du kan köra pluma från en kommandorad och öppna en eller flera filer. För att öppna flera filer från en kommandorad, ange följande kommando och tryck sedan Return:

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

Alternativt kan du ange en uri istället för ett filnamn.

För mer information om hur man kör pluma från en kommandorad, se Unix-manualsidan för pluma,

pluma

1.

## Arbeta med filer

### Skapa ett nytt dokument

För att skapa ett nytt dokument, välj Arkiv Ny. Programmet visar ett blankt dokument i pluma-fönstret.

### Öppna en fil

För att öppna en fil, välj Arkiv Öppna för att visa dialogrutan Öppna fil. Välj filen som du vill öppna och klicka sedan på Öppna. Filen visas i pluma-fönstret.

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.

Du kan öppna flera filer i pluma. Programmet lägger till en flik i fönstret för varje öppnad fil. För mer information om detta, se pluma-tabs.

### Spara en fil

Du kan spara filer på följande sätt:

- För att spara ändringar till en befintlig fil, välj Arkiv Spara.

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

### Öppna en fil från en uri

Genomför följande steg för att öppna en fil från en Uniform Resource Identifier (URI):

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

2. Ange uri:n för filen som du vill öppna.

3. Använd rullgardinsmenyn Teckenkodning för att välja lämplig teckenkodning.

4. Klicka på Öppna.

Giltiga typer av `uri` inkluderar `http:`, `ftp:`, `file:`, och alla de metoder som stöds av `mate-vfs`.

Filer från vissa typer av uri:er öppnas skrivskyddade, och alla ändringar du gör måste sparas på en annan plats. HTTP tillåter endast filer att bli lästa. Filer öppnade från en FTP-server är skrivskyddade på grund av att inte alla FTP-servrar fungerar korrekt när man sparar fjärrfiler.

Skrivning till FTP-servrar kan aktiveras med Konfigurationsredigerare, ställ in nyckeln `/apps/pluma/preferences/editor/save/writable_vfs_schemes`, men det kan orsaka fel.

### Arbeta med flikar

När fler än en fil är öppnade, visar pluma en flik för varje dokument ovanför visningsrutan. Klicka på fliken för att växla till dokumentet.

För att flytta ett dokument till ett annat pluma-fönster, dra fliken som motsvarar filen till det fönster som du vill flytta det till.

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

## Arbeta med text

### Redigera text

Du kan redigera texten för en fil på följande sätt:

- Skriv in ny text med tangentbordet. Den blinkande inmatningsmarkören markerar var den nya texten dyker upp. För att ändra det här, använd piltangenterna på tangentbordet eller klicka med musen.

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

### Ångra och gör om ändringar

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

## Hitta och ersätta

I pluma finns det två sätt att söka efter text på. Du kan använda dialogrutan Sök för att söka efter en specifik text, eller Interaktiv sökning för att färgmarkera matchande text under tiden du skriver in den.

### Hitta text

Genomför följande steg för att söka i en fil efter en textsträng:

1. Choose Search Find to display the Find dialog.

2. Skriv in strängen som du vill söka efter i fältet Sök efter. Du kan inkludera specialtecken såsom en ny rad eller tabulatortecken: se pluma-find-escapes.

3. Klicka på Sök för att söka igenom filen efter första förekomsten av strängen efter den nuvarande markörpositionen. Om pluma hittar strängen, väljer programmet den första förekomsten av strängen. Andra förekomster av strängen kommer att färgmarkeras.

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 .

### Interaktiv sökning

Interaktiv sökning färgmarkerar matchande text i dokumentet när du skriver in den, bokstav för bokstav. (Det här liknar sökfunktionen i flera webbläsare.)

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

Börja att skriva in text. Den text som matchas kommer att färgmarkeras i dokumentet. Första förekomsten efter markörpositionen kommer också att markeras.

För att flytta fram markeringen till nästa sökträff samtidigt som den interaktiva sökrutan är öppen, tryck Ctrl G. Tryck Ctrl Skift G för att gå tillbaka till föregående sökträff.

Du kan också använda uppåt- och nedåtpiltangenterna eller mushjulet för att flytta markeringen mellan sökträffar.

### Ersätt text

Genomför följande steg för att söka i en fil efter en sträng och ersätta strängen med en alternativ sträng:

1. Choose Search Replace to display the Replace dialog.

2. Skriv strängen som du vill söka efter i fältet Sök efter. Du kan inkludera specialtecken såsom en ny rad eller tabulatortecken: se pluma-find-escapes.

3. Skriv in strängen som du vill använda för att ersätta strängen som du söka efter i fältet Ersätt med.

För att granska varje förekomst av strängen innan den ersätts, klicka på Sök. Om pluma hittar strängen, kommer programmet att markera strängen. Klicka på Ersätt för att ersätta den markerade förekomsten av strängen. För att söka efter nästa förekomst av strängen, klicka på Sök igen.

För att ersätta alla förekomster av strängen genom hela dokumentet, klicka på Ersätt alla.

### Alternativ för att söka och ersätta

Dialogrutorna Sök och Ersätt har båda följande alternativ:

- Välj alternativet Gör skillnad på gemener/VERSALER för att endast söka efter förekomster av strängen som matchar skiftläget för texten som du anger. Till exempel om Gör skillnad på gemener/VERSALER har valts kommer "TEXT" inte att matcha "text".

- Välj alternativet Sök endast hela ord för att endast söka efter förekomster av strängen som matchar hela ord av texten som du anger. Till exempel om Sök endast hela ord har valts kommer "text" inte att matcha "textur".

- Välj alternativet Sök bakåt för att söka bakåt mot början av dokumentet.

- Välj alternativet Börja om från början för att söka mot slutet av dokumentet och sedan fortsätta från början av filen.

### Specialtecken

Du kan inkludera följande specialtecken i texten för att hitta eller ersätta för visade specialtecken.

`\n`

- Anger en ny rad.

`\t`

- Anger ett tabulatortecken.

`\r`

- Anger en vagnretur.

`\\`

- Själv backstegstecknet måste upprepas om det ska sökas efter. Till exempel om du letar efter "`\n`", så måste du ange "\\n" i fältet Sök efter. Om du letar efter en sekvens av backsteg så måste du dubbla antalet eftersökta backstegstecken.

### Positionera markören på en specifik rad

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.

Börja att skriva in numret på raden som du vill flytta markören till och dokumentet kommer att rulla fram till den angivna raden.

Tryck på Return för att stänga rutan och flytta markören till den angivna raden.

## Utskrifter

### Ställ in sidalternativen

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

Dialogrutan Sidkonfiguration låter dig ange följande utskriftsalternativ:

#### Fliksektionen Allmänt

Print syntax highlighting

- Välj det här alternativet för att skriva ut syntaxmarkering. För mer information om syntaxmarkering, se pluma-set-highlightmode.

Print page headers

- Välj det här alternativet för att inkludera ett sidhuvud på varje sida som du skriver ut. Du kan inte konfigurera sidhuvudet.

Line Numbers

- Välj alternativet Skriv ut radnummer för att inkludera radnummer när du skriver ut en fil.

  Använd snurrväljaren Tal var ... rad för att ange hur ofta radnumren ska skrivas ut, till exempel var 5:e rad, var 10:e rad, och så vidare.

Text Wrapping

- Välj alternativet Aktivera textradbrytning för att radbryta text till nästa rad, på teckennivå, när du skriver ut en fil. Programmet räknar radbrytna rader som en rad för radnumreringens skull.

  Välj alternativet Dela inte ord över två rader för att radbryta text till nästa rad, på ordnivå, när du skriver ut en fil.

#### Typsnitt

Body

- Klicka på den här knappen för att välja typsnittet att använda för att skriva ut huvudtexten för en fil.

Line numbers

- Klicka på den här knappen för att välja typsnittet att använda för att skriva ut radnummer.

Headers and footers

- Klicka på den här knappen för att välja typsnittet att använda för att skriva ut sidhuvuden och sidfötter i en fil.

För att återställa typsnitten till standardvärden för utskrift av en fil från pluma, klicka på Återställ standardtypsnitt.

### Skriv ut ett dokument

Du kan använda pluma för att genomföra följande utskriftsåtgärder:

- Skriva ut ett dokument till en skrivare.

- Skriva ut utdata för utskriftskommandot till en fil.

Om du skriver ut till en fil, skickar pluma utdata för filen till en förtryckningsformaterad fil. De mest vanliga förtryckningsformaten är PostScript och 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.

Dialogrutan Skriv ut låter dig ange följande utskriftsalternativ:

#### Fliksektionen Jobb

Print range

- Välj en av följande åtgärder för att bestämma hur många sidor som ska skrivas ut:

  - All

    Välj detta alternativ för att skriva ut alla sidorna i filen.

  - Lines

    Välj detta alternativ för att endast skriva ut de angivna raderna. Använd väljaren för Från och Till för att ange radintervallet.

  - Selection

    Välj det här alternativet för att endast skriv ut den markerade texten. Detta alternativ finns endast tillgängligt om du har markerat text.

Copies

- Använd väljaren Antal kopior för att ange antalet kopior av filen som du vill skriva ut.

  Om du skriver ut flera kopior av filen, välj alternativet Sortera för att sortera de utskrivna kopiorna.

#### Fliksektionen Skrivare

Printer

- Använd den här rullgardinslistan för att välja skrivaren till vilken du vill skriva ut filen.

Settings

- Använd den här rullgardinslistan för att välja utskriftsinställningarna.

  För att konfigurera skrivaren, klicka på Konfigurera. Till exempel kan du aktivera eller inaktivera dubbelsidig utskrift, eller schemalägga utskriften, om den här funktionaliteten stöds av skrivaren.

Location

- Använd den här rullgardinslistan för att välja ett av följande utskriftsmål:

  CUPS

- Skriv ut filen till en CUPS-skrivare.

  Om den valda skrivaren är en CUPS-skrivare, kommer CUPS att vara den enda posten i den här rullgardinslistan.

lpr

- Skriv ut filen till en skrivare.

File

- Skriv ut filen till en PostScript-fil.

  Klicka på Spara som för att visa en dialogruta där du anger namnet och platsen för PostScript-filen.

Custom

- Använd det angivna kommandot för att skriva ut filen.

  Skriv in namnet på kommandot i textrutan. Inkludera alla kommandoradsargument.

State

- Den här funktionaliteten stöds inte av den här versionen av pluma.

Type

- Den här funktionaliteten stöds inte av den här versionen av pluma.

Comment

- Den här funktionaliteten stöds inte av den här versionen av pluma.

#### Fliksektionen Papper

Paper size

- Använd den här rullgardinslistan för att välja storleken på pappret till vilket du vill skriva ut filen.

Width

- Använd den här snurrväljaren för att ange bredden på pappret. Använd den närliggande rullgardinslistan för att ändra mätenhet.

Height

- Använd den här snurrväljaren för att ange höjden på pappret.

Feed orientation

- Använd den här rullgardinslistan för att välja orienteringen på pappret i skrivaren.

Page orientation

- Använd den här rullgardinslistan för att välja sidorienteringen.

Layout

- Använd den här rullgardinslistan för att välja sidlayouten. En förhandsvisning för varje layout som du kan välja visas i rutan Förhandsgranska.

Paper tray

- Använd den här rullgardinslistan för att välja pappersfack.

## Programmeringsfunktioner

Flera programmeringsfunktioner i pluma tillhandahålls med hjälp av insticksmoduler. Till exempel tillhandahåller insticksmodulen Tagglista en lista över vanligen använda taggar för olika markup-språk: se pluma-tag-list-plugin.

### Syntaxmarkering

Syntaxmarkering gör det lättare att läsa källkod genom att visa olika delar av texten i olika färger.

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

- Visa inte någon syntaxmarkering.

Sources

- Visa syntaxmarkering för att redigera källkod. Använd undermenyn Källkoder för att välja källkodstypen.

Markup

- Visa syntaxmarkering för att redigera märkningskod. Använd undermenyn Märkning för att välja märkningskodtypen.

Scripts

- Visa syntaxmarkering för att redigera skriptkod. Använd undermenyn Skript för att välja skriptkodtypen.

Others

- Visa syntaxmarkering för att redigera andra typer av kod. Använd undermenyn Andra för att välja kodtypen.

### Omdirigera utdata för ett kommando till en fil

Du kan använda pluma för att omdirigera utdata från ett kommando till en textfil. För att till exempel omdirigera utdata för kommandot `ls` till en textfil, skriv `ls | pluma` och tryck på Return.

Utdata från kommandot `ls` visas i en ny textfil i pluma-fönstret.

Alternativt kan du använda insticksmodulen Externa verktyg för att omdirigera kommandoutdata till den aktuella filen.

## Snabbtangenter

Använd snabbtangenter för att genomföra vanliga uppgifter på ett snabbare sätt än med musen och menyerna. Följande tabell listar alla snabbtangenter i pluma.

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

Tabulatorer

Snabbtangenter för flikar:

Snabbtangent | Kommando
Ctrl + Alt + PageUp | Växlar till nästa flik åt vänster.
Ctrl + Alt + PageDown | Växlar till nästa flik åt höger.
Ctrl + W | Stäng flik.
Ctrl + Skift + L | Spara alla flikar.
Ctrl + Skift + W | Stäng alla flikar.
Alt + n | Hoppa till flik nummer n.

Filer

Snabbtangenter för arbete med filer:

Snabbtangent | Kommando
Ctrl + N | Skapa ett nytt dokument.
Ctrl + O | Öppna ett dokument.
Ctrl + L | Öppna en plats.
Ctrl + S | Spara det aktuella dokumentet till disk.
Ctrl + Skift + S | Spara aktuellt dokument med ett nytt filnamn.
Ctrl + P | Skriv ut det aktuella dokumentet.
Ctrl + Skift + P | Förhandsvisa utskrift.
Ctrl + W | Stäng aktuellt dokument.
Ctrl + Q | Avsluta Pluma.

Redigera

Snabbtangenter för redigering av dokument:

Snabbtangent | Kommando
Ctrl + Z | Ångra föregående åtgärd.
Ctrl + Skift + Z | Gör om senaste ångrade åtgärden.
Ctrl + X | Klipp ut markerad text eller område och placera den i urklipp.
Ctrl + C | Kopiera markerad text eller område till urklipp.
Ctrl + V | Klistra in innehållet i urklipp.
Ctrl + A | Markera allt.
Ctrl + D | Ta bort aktuell rad.
Alt + Up | Move the selected line up one line.
Alt + Down | Move the selected line down one line.

Paneler

Snabbtangenter för att visa och dölja paneler:

Snabbtangent | Kommando
F9 | Visa/dölj sidopanelen.
Ctrl + F9 | Visa/dölj nederkantspanelen.

Sök

Snabbtangenter för sökning:

Snabbtangent | Kommando
Ctrl + F | Sök efter en sträng.
Ctrl + G | Sök nästa förekomst av strängen.
Ctrl + Skift + G | Sök föregående förekomst av strängen.
Ctrl + K | Interaktiv sökning.
Ctrl + H | Sök och ersätt.
Ctrl + Skift + K | Ta bort markering.
Ctrl + I | Gå till rad.

Verktyg

Snabbtangenter för verktyg:

Snabbtangent | Kommando
Skift + F7 | Kontrollera stavning (med insticksmodul).
Alt + F12 | Ta bort eftersläpande blanksteg (med insticksmodul).
Ctrl + T | Dra in rader (med insticksmodul).
Ctrl + Skift + T | Ta bort indragning (med insticksmodul).
F8 | Kör "make" i aktuell katalog (med insticksmodul).
Ctrl + Skift + D | Kataloglistning (med insticksmodul).

Hjälp

Snabbtangent för hjälp:

Snabbtangent | Kommando
F1 | Öppna handboken för pluma.

## Inställningar

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

### Visa inställningar

Text Wrapping

- Välj alternativet Aktivera textradbrytning för att långa rader av text flyter i avsnitt istället för att fortsätta utanför kanten i textfönstret. Det här gör att man slipper rulla texten horisontellt.

  Välj alternativet Dela inte ord över två rader för att textradbrytningsalternativet ska behålla hela ord när text radbryts till nästa rad. Det här gör att texten blir enklare att läsa.

Line Numbers

- Välj alternativet Visa radnummer för att visa radnummer på vänster sida i pluma-fönstret.

Current Line

- Välj alternativet Färgmarkera aktuell rad för att färgmarkera raden där markören är placerad.

Right Margin

- Välj alternativet Visa högermarginal för att visa en vertikal linje som indikerar den högra marginalen.

  Använd snurrväljaren Högermarginal vid kolumn för att ange platsen för den vertikala linjen.

Bracket Matching

- Välj alternativet Färgmarkera matchande klammer för att färgmarkera motsvarande klammer när markören är positionerad på ett klammertecken.

### Redigerarinställningar

Tabs

- Använd snurrväljaren Tabulatorbredd för att ange bredden på utrymmet som pluma infogar när du trycker på tabulatortangenten.

  Välj alternativet Infoga blanksteg istället för tabulatortecken för att ange att pluma infogar blanksteg istället för ett tabulatortecken när du trycker på tabulatortangenten.

Auto Indentation

- Välj alternativet Aktivera automatiskt indrag för att ange att nästa rad börjar vid indragsnivån för den aktuella raden.

File Saving

- Välj alternativet Skapa en säkerhetskopia av filen innan den sparas för att skapa en säkerhetskopia av filen varje gång du sparar filen. Säkerhetskopian för filen innehåller ett ~ i slutet av filnamnet.

  Välj alternativet Spara filer automatiskt var ... minut för att automatiskt spara den aktuella filen med jämna intervall. Använd snurrväljaren för att ange hur ofta du vill spara filen.

### Typsnitt och färger

Font

- Välj alternativet Använd standardtematypsnitt för att använda standardsystemtypsnittet för texten i pluma-textfönstret.

  Fältet Redigerartypsnitt visar typsnittet som pluma använder för att visa text. Klicka på knappenför att ange typsnittstypen, stil och storlek för att använda för text.

Color Scheme

- Du kan välja ett färgschema från listan över färgscheman. Som standard finns följande färgscheman installerade:

  Classic

- Klassiskt färgschema baserat på gvim-färgschemat.

Cobalt

- Blått färgschema.

Kate

- Färgschema som används i textredigeraren Kate.

Oblivion

- Mörkt färgschema som använder Tango-färgpaletten.

Tango

- Färgschema som använder Tango-färgschemat.

Du kan lägga till ett nytt färgschema genom att klicka på Lägg till... och välja en färgschemafil

Du kan ta bort det markerade färgschemat genom att klicka på Ta bort

### Inställningar för insticksmoduler

Insticksmoduler lägger till extrafunktioner till pluma. För mer information om insticksmoduler och hur man använder de inbyggda insticksmodulerna, se pluma-plugins-overview.

#### Aktivera en insticksmodul

Genomför följande steg för att aktivera en insticksmodul i pluma:

1. Choose Edit Preferences .

2. Välj fliken Insticksmoduler.

3. Välj kryssrutan bredvid namnet på insticksmodulen som du vill aktivera.

4. Klicka på Stäng för att stänga dialogrutan Inställningar.

#### Inaktivera en insticksmodul

En insticksmodul är fortfarande aktiverad när du avslutar pluma.

Genomför följande steg för att inaktivera en insticksmodul i pluma:

1. Choose Edit Preferences .

2. Välj fliken Insticksmoduler.

3. Avmarkera kryssrutan bredvid namnet på insticksmodulen som du vill inaktivera.

4. Klicka på Stäng för att stänga dialogrutan Inställningar.

## Insticksmoduler

### Arbeta med insticksmoduler

Du kan lägga till extrafunktioner till pluma genom att aktivera insticksmoduler. En insticksmodul är ett tilläggsprogram som utökar funktionaliteten för ett program. Insticksmoduler lägger till nya objekt i pluma-menyerna för de nya funktioner som de tillhandahåller.

Flera insticksmoduler är redan inbyggda i pluma och du kan installera fler. Webbsidan för insticksmoduler för pluma listar insticksmoduler från tredjepartsleverantörer.

För att aktivera eller inaktivera insticksmoduler, eller se vilka insticksmoduler som för närvarande är aktiverade, använd Inställningar för insticksmoduler.

Följande insticksmoduler är inbyggda som standard i pluma:

- Ändra skiftläge låter dig ändra skiftläget på den markerade texten.

- Dokumentstatistik visar antal rader, ord och tecken i dokumentet.

- Externa verktyg låter dig köra externa kommandon från pluma.

- Filbläddrarpanel låter dig bläddra i din filer och mappar via sidopanelen.

- Dra in rader lägger till eller tar bort indragningen för markerade rader.

- Infoga datum/tid lägger till det aktuella datumet och tiden in i ett dokument.

- Lägesrader låter dig ställa in redigeringsinställningar för individuella dokument, och har stöd för lägesradstyperna Emacs, Kate och Vim.

- Python-konsoll låter dig köra kommandon i programspråket Python.

- Textsnuttar låter dig lagra ofta använda textstycken och infoga dem snabbt i ett dokument.

- Sortera arrangerar om markerade textrader i alfabetisk ordning.

- Stavningskontroll rättar stavningen i den markerade texten, eller markerar automatiskt fel i dokumentet.

- Tagglista låter dig infoga vanligen använda HTML-taggar och taggar för andra språk från en lista i sidopanelen.

För mer information om hur man skapar insticksmoduler, se webbsidan för pluma.

### Insticksmodulen Ändra skiftläge

Insticksmodulen Ändra skiftläge ändrar skiftläget på den markerade texten.

Följande objekt läggs till i menyn Redigera när insticksmodulen Ändra skiftläge aktiveras:

Menyobjekt | Åtgärd | Exempel
Edit Change Case All Upper Case | Ändra varje tecken till versaler. | `Denna text` blir `DENNA TEXT`
Edit Change Case All Lower Case | Ändra varje tecken till gemener. | `Denna Text` blir `denna text`
Edit Change Case Invert Case | Ändra varje gement tecken till versalt och ändra varje versalt tecken till gement. | `Denna Text` blir `dENNA tEXT`
Edit Change Case Title Case | Ändra första tecknet för varje ord till en gemen. | `denna text` blir `Denna Text`

### Insticksmodulen Dokumentstatistik

Insticksmodulen Dokumentstatistik räknar antalet rader, ord, tecken med blanksteg, tecken utan blanksteg och antal byte i den aktuella filen. Insticksmodulen visar resultatet i en Dokumentstatistik-dialog. Genomför följande steg för att använda insticksmodulen Dokumentstatistik:

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

   - Antal rader i det aktuella dokumentet.

   - Antal ord i det aktuella dokumentet.

   - Antal tecken, inklusive blanksteg, i det aktuella dokumentet.

   - Antal tecken, blanksteg undantaget, i det aktuella dokumentet.

   - Antal byte i det aktuella dokumentet.

2. Du kan fortsätta att uppdatera filen i pluma under tiden dialogrutan Dokumentstatistik är öppen. För att uppdatera innehållet i dialogrutan Dokumentstatistik, klicka på Uppdatera.

### Insticksmodulen Externa verktyg

Insticksmodulen Externa verktyg låter dig köra externa kommandon från pluma. Du kan omdirigera visst innehåll in i ett kommando och utforska dess utdata (till exempel, sed), eller starta ett fördefinierat kommando (till exempel, make).

Använd Hanterar för externa verktyg för att skapa och redigera kommandon. För att köra ett externt kommando, välj det från menyn Verktyg.

#### Inbyggda kommandon

Följande kommandon tillhandahålls av insticksmodulen Externa verktyg:

Bygg

- Kör make i katalogen för det aktuella dokumentet.

Kataloglistning

- Listar innehållet i det aktuella dokumentets katalog i ett nytt dokument.

Miljövariabler

- Visar listan över miljövariabler i underpanelen.

Grep

- Söker efter en term i alla filer i det aktuella dokumentets katalog med hjälp av mönstermatchning. Resultatet visas i underpanelen.

Ta bort eftersläpande blanksteg

- Tar bort alla blanksteg från slutet av rader i dokumentet.

#### Definiera ett kommando

För att lägga till ett externt kommando, välj Verktyg Externa verktyg.

I Hanterare för externa verktyg-fönstret, klicka på Nytt. Du kan ange följande detaljer för det nya kommandot:

Beskrivning

- Den här beskrivningen visas i statusraden när menykommandot väljs.

Snabbtangent

- Ange en snabbtangent för kommandot.

Kommandon

- De faktiska kommandon som ska köras. Flera miljövariabler i pluma kan användas för att skicka innehåll till dessa kommandon: se pluma-external-tools-plugin-variables.

Inmatning

- Innehållet att ge till kommandon (som `stdin`): hela texten av det aktuella dokumentet, nuvarande markeringen, rad eller ord.

Utdata

- Vad som ska göras med det utdata som kommer från kommandon: visa i underpanelen, lägg in i ett nytt dokument, eller placera det i det aktuella dokumentet, på slutet, vid markörens position, eller ersätt markeringen eller hela dokumentet.

Användbarhet

- Bestämmer vilka sorter av dokument som kan påverkas av kommandot, till exempel huruvida sparade eller inte, och lokala eller fjärr.

#### Verktyg för att redigera och ta bort

För att redigera ett verktyg, välj den i listan och gör ändringar i dess egenskaper.

För att byta namn på ett verktyg, klicka på den igen i listan.

För att återställa ett inbyggt verktyg som du har ändrat, tryck på Återställ.

För att ta bort ett verktyg, välj den från listan och tryck på Ta bort. Du kan inte ta bort inbyggda verktyg, endast de som du själv har skapat.

#### Variabler

Du kan använda följande variabler i fältet Kommandon för kommandodefinitionen:

- 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

### Insticksmodulen Filbläddrarpanel

Insticksmodulen Filbläddrarpanel visar dina filer och mappar i sidopanelen, vilket låter dig att snabbt öppna filer.

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.

#### Bläddra bland dina filer

Fliken Filbläddrare visar initialt dina filhanterarbokmärken. Dubbelklicka på valfritt objekt för att bläddra i dess innehåll.

För att visa en föräldramapp, välj det från rullgardinslistan, eller tryck på uppåtpilen i Filbläddrarens verktygsrad.

För att visa mappen som innehåller dokumentet som du för närvarande arbetar med, högerklicka i fillistan och välj Ställ in rot till aktivt dokument.

#### Öppna en fil

För att öppna en fil i pluma, dubbelklicka på den i fillistan.

#### Skapa filer och mappar

För att skapa en ny, tom textfil i den aktuella mappen som visas i bläddraren, högerklicka i fillistan och välj Ny fil.

För att skapa en ny mapp i den aktuella mappen som visas i bläddraren, högerklicka i fillistan och välj Ny mapp.

### Insticksmodulen Dra in rader

Insticksmodulen Dra in rader lägger till eller tar bort blanksteg från början av textrader.

Genomför följande steg för att dra in eller dra ut text:

1. Markera raderna som du vill dra in. För att dra in eller dra ut en enda rad, placera markören någonstans på den raden.

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

   - To remove the indentation, choose Edit Unindent .

Mängden utrymme som används, och huruvida tabulatortecknet eller blankstegstecken används, beror på inställningen Tabulatorstopp i redigerarinställningarna: se pluma-prefs-editor.

### Insticksmodulen Infoga datum/tid

Insticksmodulen Infoga datum/tid infogar det aktuella datumet och tiden in i ett dokument. Genomför följande steg för att använda insticksmodulen Infoga datum/tid:

1. Choose Edit Insert Date and Time .

   Om du inte har konfigurat insticksmodulen Infoga datum/tid till att automatiskt infoga datumet/tiden utan att fråga dig efter formatet, kommer pluma att visa dialogrutan Infoga datum och tid. Välj det lämpliga formatet för datum och tid från listan. Klicka på Infoga för att stänga dialogrutan Infoga datum och tid. pluma infogar datumet och tiden vid markörpositionen i den aktuella filen.

   Om du har konfigurat pluma till att använda ett specifikt format för datum och tid, kommer dialogrutan Infoga datum och tid inte att visas. Datumet och tiden kommer då att automatiskt infogas vid markörpositionen i den aktuella filen.

#### Konfigurera insticksmodulen Infoga datum/tid

Genomför följande steg för att konfigurera insticksmodulen Infoga datum/tid:

1. Choose Edit Preferences .

2. Välj fliken Insticksmoduler.

3. Välj insticksmodulen Infoga datum/tid.

4. Klicka på Konfigurera för att visa dialogrutan Konfigurera insticksmodulen för infoga datum/tid.

5. Välj ett av följande alternativ:

   - För att ange formatet för datum och tid varje gång som du infogar datumet och tiden, välj alternativet Fråga efter ett 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. Klicka på OK för att stänga dialogrutan Konfigurera insticksmodulen Infoga datum/tid.

7. För att stänga dialogrutan Inställningar, klicka på Stäng.

### Insticksmodulen Lägesrader

Insticksmodulen Lägesrader låter dig ställa in inställningar för individuella dokument. En lägesrad är en textrad vid början eller slutet av dokumentet med inställningar som pluma känner igen.

Inställningar inställda med lägesrader åsidosätter de som angivits i inställningsdialogen.

Du kan ställa in följande inställningar med lägesrader:

- Tabulatorbredd

- Indenteringsbredd

- Infoga blanksteg istället för tabulatortecken

- Textradbrytning

- Högermarginalbredd

Insticksmodulen Lägesrader har stöd för en mindre uppsättning av alternativ som används av de andra textredigerarna Emacs, Kate och Vim.

#### Lägesrader för Emacs

De två raderna raderna i ett dokument söks igenom efter lägesrader för Emacs.

Emacs-alternativen för tab-width, indent-offset, indent-tabs-mode och autowrap stöds. För mer information, se handboken för GNU Emacs.

#### Lägesrader för Kate

De tio första och sista raderna i ett dokument söks igenom efter lägesrader för Kate.

Kate-alternativen för tab-width, indent-width, space-indent, word-wrap och word-wrap-column stöds. För mer information, se webbsidan för Kate.

#### Lägesrader för Vim

De tre första och sista raderna i ett dokument söks igenom efter lägesrader för Vim.

Vim-alternativen för et, expandtab, ts, tabstop, sw, shiftwidth, wrap och textwidth stöds. För mer information, se webbsidan för Vim.

### Insticksmodulen Python-konsoll

insticksmodulen Python-konsoll låter dig köra kommandon i programspråket Python från pluma. Aktivering av insticksmodulen lägger till en flik till underpanelen. Den visar senaste utdata och ett kommandofält.

Kommandon som anges i Python-konsollen kontrolleras inte innan de körs. Det är därför möjligt att låsa hela pluma, till exempel genom att ange en oändlig slinga.

### Insticksmodulen Textsnuttar

Insticksmodulen Textsnuttar låter dig lagra ofta använda delar av text, kallade textsnuttar, och infoga dem snabbt i ett dokument.

Textsnuttar är specifika för språksyntaxen för det aktuella dokumentet. Till exempel när du arbetar med ett HTML-dokument kan du välja från en lista över textsnuttar som är användbara för HTML. I tilläggt till det är vissa textsnuttar globala och finns tillgängliga för alla dokument.

Ett antal inbyggda textsnuttar installeras med pluma, vilka kan ändras.

#### Infoga textsnuttar

För att infoga en textsnutt i ett dokument, skriv in dess tabulatorutlösare och tryck på tabulatorn. Tabulatorutlösaren för en textsnutt är vanligtvis de första bokstäverna i textsnutten, eller någonting annat som är kort och enkelt att komma ihåg.

Alternativt, tryck Ctrl Blanksteg för att se en lista över de textsnuttar du kan infoga.

#### Lägg till textsnuttar

Gör följande för att skapa en ny textsnutt:

1. Välj Verktyg Hantera textsnuttar. Fönstret Hantera textsnuttar öppnas.

2. Listan över textsnuttar grupperas efter språk. Välj språket som du vill lägga till en textsnutt till, eller en textsnutt i den språkgruppen. För att lägga till en textsnutt för alla språk, Välj Global i övre delen av listan. Syntaxen för dokumentet som du för närvarande arbetar med kommer att visas som standard.

3. Klicka på Ny. En ny textsnutt visas i listan.

4. Ange följande information för den nya textsnutten:

   Namn

5. Ange ett namn för textsnutten i textfältet i listan. Namnet på textsnutten är bara för att påminna om dess syfte. Du kan ändra namnet på en textsnutt som du har skapat genom att klicka på den i listan.

Textsnutt

- Ange texten för textsnutten i textrutan Redigera textsnutt. För de specialkoder som du kan använda, se pluma-snippets-plugin-syntax.

  Du kan växla tillbaka till dokumentfönstret för att kopiera text utan att stänga fönstret Hantera textsnuttar.

Tabulatorutlösare

- Ange tabulatorutlösaren för textsnutten. Det här är texten som du skriver innan du trycker på tabulatorn för att infoga textsnutten.

  Taggen måste antingen vara ett enda ord som består av endast bokstäver, eller ett enda tecken. Tabulatorutlösaren kommer att färgmarkeras i rött om en ogiltig tabulatorutlösare anges.

Snabbtangent

- Ange en snabbtangent att använda för att infoga textsnutten.

#### Redigera och ta bort textsnuttar

För att redigera en textsnutt, välj den i listan och gör ändringar till dess text- och aktiveringsegenskaper.

För att byta namn på en textsnutt, klicka på den igen i listan.

För att återställa en inbyggd textsnutt som du har ändrat, tryck på Återställ.

För att ta bort en textsnutt, välj den från listan och tryck på Ta bort. Du kan inte ta bort inbyggda textsnuttar, endast de som du själv har skapat.

#### Textsnuttsersättare

I tillägg till att infoga lagrad text kan en textsnutt inkludera anpassningsbar text, eller markera utrymme där du kan lägga till text när textsnutten har infogats i ditt dokument.

Du kan använda följande koder för platshållare i textsnutten:

Platshållare för tabulator

- `$`n`` definierar en platshållare för tabulator, där `n` är någon siffra från 1 och uppåt.

  `${`n`:`standard`}` definierar en platshållare för tabulator med ett standardvärde.

  En platshållare för tabulator markerar en plats i textsnutten där du kan lägga till extra text efter att textsnutten har infogats.

  För att använda platshållare för tabulator, infoga textsnutten som vanligt. Markören placeras på den första platshållaren. Skriv in text och tryck på tabulatorn för att gå vidare till nästa platshållare. Siffran i platshållarkoden definierar ordningen i vilken tabulatorn går vidare till varje plats i texten.

  Tryck på Skift Tabulator för att återgå till den föregående platshållaren. Tryck på Tabulator när det inte finns fler platshållare för tabulator flyttas markören till slutet av textsnutten, eller till slutet av platshållaren för avslut om det finns en.

Platshållare för spegel

- En upprepad platshållare för tabulator kommer att spegla platshållaren som redan har definierats. Det här gör att du kan skriva in text en gång som du vill ska visas flera gånger i textsnutten.

Platshållare för avslut

- `$0` definierar platshållaren för avslut. Det här gör att du kan sluta arbeta med textsnutten när markören är vid en position annan än för slutet av textsnutten.

Miljövariabler

- Miljövariabler som `$PATH` och `$HOME` ersätts i textsnutten. Följande variabler som är specifika för pluma kan också användas:

  $PLUMA_SELECTED_TEXT

- Den för närvarande markerade texten.

$PLUMA_FILENAME

- Det fullständiga namnet på dokumentet, eller en tom sträng om dokumentet inte har sparats än.

$PLUMA_BASENAME

- Basnamnet för filnamnet för dokumentet, eller en tom sträng om dokumentet inte har sparats än.

$PLUMA_CURRENT_WORD

- Ordet vid markörens plats i dokumentet. När den här variabeln används kommer det aktuella ordet att ersättas med textsnutten.

Platshållare för skal

- `$(`kommando`)` ersätts av resultatet för körningen av `kommando` i ett skal.

  `$(`n`:`kommando`)` låter dig ange en referens för den här platshållaren, där `n` är en siffra från 1 och uppåt. Använd `$`n`` för att använda utdata från en platshållare för skal som indata till ett annat.

Platshållare för Python

- `$<`kommando`>` ersätts av resultatet för evaluering av `kommando` i python-tolkaren.

  `$<`a`:`kommando`>` anger en annan platshållare för python som en beroende, där `a` anger dess ordning i textsnutten. Det här låter dig använda python-funktioner som definierats i en annan textsnutt. För att ange flera beroenden, separera siffrorna med kommatecken så här: `$<`a`,`b`:`kommando`>`

  För att använda en variabel i alla andra python-textsnuttar, deklarera den som `global`.

### Insticksmodulen Sortera

Insticksmodulen Sortera arrangerar om markerade textrader till alfabetisk ordning.

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 .

Genomför följande steg för att använda insticksmodulen Sortera:

1. Markera textraderna som du vill sortera.

2. Choose Edit Sort . The Sort dialog opens.

3. Välj alternativen som du vill använda för sorteringen:

   - För att arrangera texten i omvänd ordning, välj Baklänges.

   - För att ta bort dubblettrader, välj Ta bort dubletter.

   - För att ignorera skiftläge, välj Gör ingen skillnad på gemener/VERSALER.

   - För att sorteringen ska ignorera tecknen i början av raderna, ställ in det första tecknet som ska användas för sorteringen i snurrväljaren Börja vid kolumn.

4. För att genomföra sorteringsåtgärden, klicka på Sortera.

### Insticksmodulen Stavningskontroll

Insticksmodulen Stavningskontroll kontrollerar stavningen i den markerade texten. Du kan konfigurera pluma till att kontrollera stavningen automatiskt, eller bara kontrollera stavningen manuellt, för det angivna språket. Språkinställningen, och egenskaperna för den automatiskt stavningskontrollen, gäller per dokument. Genomför följande steg för att använda insticksmodulen Stavningskontroll:

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.

   Okända stavningar visas i en annan färg, och är understruken. Högerklicka på en okänd stavning, välj sedan Stavningsförslag från popup-menyn:

   - För att ersätta den okända stavningen med en annan stavning i listan, välj ersättningsstavningen från popup-menyn Stavningsförslag.

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

   Om det inte finns några stavningsfel, kommer dialogrutan Information att visa ett meddelande som säger att dokumentet inte innehåller några felstavade ord. Klicka på OK för att stänga dialogrutan Information.

   Om det finns stavningsfel kommer dialogrutan Kontrollera stavning att visa:

   - Felstavade ord visas i överkant av dialogrutan.

   - Ett förslag på stavning visas i textrutan Ändra till. Du kan ersätta det här med en annan känd stavning genom att välja en stavning från listan Förslag, eller så kan du ange text direkt i textrutan Ändra till.

   - För att kontrollera stavningen på texten i textrutan Ändra till, klicka på Kontrollera ord. Om det här är ett känt ord kommer listan Förslag att ersättas med texten `(korrekt stavning)`. Om ordet inte är känt kommer nya poster att visas i listan Förslag.

   - För att ignorera det aktuella förekomsten av det okända ordet, klicka på Ignorera. För att ignorera alla förekomster av det okända ordet, klicka på Ignorera alla. Det okända ordet kommer endast att ignoreras i den aktuella pluma-sessionen.

   - För att ändra den aktuella förekomsten av det okända ordet till texten i textrutan Ändra till, klicka på Ändra. För att ändra alla förekomster av det okända ordet till texten i textrutan Ändra till, klicka på Ändra alla.

   - För att lägga till det okända ordet till din personliga ordbok, klicka på Lägg till ord.

   - För att stänga dialogrutan Kontrollera stavning, klicka på Stäng.

### Insticksmodulen Tagglista

Insticksmodulen Tagglista låter dig infoga vanligen använda taggar från en lista i sidopanelen.

Genomför följande steg för att använda insticksmodulen Tagglista:

1. Choose View Side Pane .

2. Som standard visar sidopanelen en flik som innehåller en lista över öppna dokument. Klicka på fliken som visar ikonen + vid nederkant av sidopanelen för att visa fliken för tagglistor.

3. Välj den lämpliga taggkategorin från rullgardinslistan. Till exempel, HTML - Taggar.

4. Rulla genom tagglistan för att hitta den önskade taggen.

5. För att infoga en tagg vid markörpositionen i den aktuella filen, dubbelklicka på taggen i tagglistan. Du kan även infoga ett tagg på dessa sätt:

   - För att infoga en tagg i den aktuella filen och ändra fokus från sidopanelen till visningsrutan, tryck på Return.

   - För att infoga en tagg i den aktuella filen och bibehålla fokus för fönstret Insticksmodulen Tagglista, tryck på Skift Return.