# Příručka k aplikaci Pluma

## Úvod

Pomocí aplikace pluma můžete vytvářet a upravovat textové soubory.

Aplikace pluma se snaží být jednoduchým a snadno použitelným textovým editorem. Složitější funkce lze doplnit různými zásuvnými moduly, což umožňuje provádět rozmanité činnosti související s úpravou textu.

## Jak začít

### Spuštění pluma

pluma můžete spustit následujícími způsoby:

Nabídka Aplikace

- Zvolte Příslušenství Textový editor.

Příkazový řádek

- Spusťte následující příkaz: `pluma`

Standardně, pokud otevřete textový dokument ve správci souborů, tak se spustí pluma a zobrazí dotyčný dokument.

### Okno aplikace pluma

Když spustíte pluma, objeví se následující okno:

#### Okno aplikace pluma

Shows pluma main window.

Okno aplikace pluma obsahuje následující části:

Panel nabídek

- Nabídky v panelu nabídek obsahují všechny příkazy, které jsou zapotřebí pro práci v pluma.

Panel nástrojů

- Panel nástrojů obsahuje část nejpoužívanějších příkazů ze celého panelu nabídek.

Zobrazovací plocha

- Zobrazovací plocha obsahuje text ze soubory, který upravujete.

Stavový řádek

- Stavový řádek zobrazuje informace o současných činnostech pluma a kontextové informace položkám nabídek. Stavový řádek rovněž obsahuje následující informace:

  - Umístění kurzoru: číslo řádku a sloupce, kde se kurzor nachází.

  - Režim psaní: Když je editor v režimu vkládání, tak stavový řádek obsahuje text VLO. Když je editor v režimu přepisování, tak stavový řádek obsahuje text PŘE. Režim můžete přepnout klávesou Insert.

Postranní panel

- Postranní panel obsahuje seznam otevřených dokumentů a další informace závislé na tom, které zásuvné moduly jsou povolené.

  Ve výchozím stavu není postranní panel zobrazený. Pokud jej chcete zobrazit, zvolte Zobrazit Postranní panel.

Spodní panel

- Spodní panel využívají programátorské nástroje, jako je zásuvný modul Konzola Pythonu k zobrazení výstupu.

  Ve výchozím stavu není spodní panel zobrazený. Pokud jej chcete zobrazit, zvolte Zobrazit Spodní panel.

Pokud kliknete pravým tlačítkem v okně pluma, tak aplikace zobrazí vyskakovací nabídku. Vyskakovací nabídka obsahuje nejběžnější příkazy pro úpravu textu.

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.

### Spouštění pluma z příkazového řádku

pluma můžete spustit z příkazového řádku a přitom otevřít jeden nebo i více souborů. Pokud chcete otevřít z příkazové řádky více souborů, napište příkaz podobně jako v následujícím příkladu a stiskněte Return:

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

Případně můžete místo názvu souboru zadat URI.

Více informací o tom, jak spustit pluma z příkazové řádky najdete v unixových manuálových stránkách pluma

pluma

1.

## Práce se soubory

### Vytváření nového dokumentu

Nový dokument vytvoříte volbou Soubor Nový. Aplikace pluma zobrazí v okně nový prázdný dokument.

### Otevírání souboru

Pokud chcete otevřít soubor, zvolte Soubor Otevřít a objeví se dialog Otevřít soubory. Zvolte soubor, který chcete otevřít a klikněte na Otevřít. Soubor se zobrazí v okně 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.

V pluma můžete otevřít více souborů naráz. Aplikace pro každý otevřený soubor přidá do okna další kartu. Více se o tom dozvíte v pluma-tabs.

### Ukládání souboru

Ukládat můžete soubory následujícími způsoby:

- Pokud chcete uložit existující soubor, zvolte Soubor Uložit.

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

### Otevírání souboru z URI

Pokud chcete otevřít soubor z Uniform Resource Identifier (URI), proveďte následující kroky:

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

2. Zadejte URI souboru, který chcete otevřít.

3. Použijte vyskakovací seznam Kódování znaků k zadání správného kódování znaků.

4. Klikněte na Otevřít.

Platné typy `URI` zahrnují `http:`, `ftp:`, `file:` a všechny další metody podporované `mate-vfs`.

Soubory z některých typů URI se otevírají v pouze pro čtení a pokud chcete uložit změny, musíte tak provést na jiné místo. Konkrétně HTTP umožňuje soubory pouze číst. Soubory otevřené z FTP jsou pouze pro čtení, protože ne všechny FTP servery pracují korektně s ukládáním vzdálených souborů.

Ukládání na FTP servery můžete povolit v Editoru nastavení nastavením klíče `/apps/pluma/preferences/editor/save/writable_vfs_schemes`, ale může to způsobovat chyby.

### Práce s kartami.

Pokud je otevřený víc než jeden soubor, pluma vytvoří v zobrazovací oblasti pro každý dokument kartu. Mezi dokumenty se přepíná kliknutím na kartu.

Dokumenty můžete přesouvat mezi okny pluma, stačí jednoduše přetáhnout příslušnou kartu myší do kterého okna chcete.

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

## Práce s textem

### Úprava textu

Text souboru můžete upravovat následujícími postupy:

- Psát na klávesnici nový text. Psát se bude v místě, kde bliká vkládací kurzor. Jeho pozici můžete měnit kurzorovými klávesami nebo kliknutím myší.

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

### Vracení a opětovné provádění změn

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

## Vyhledávání a nahrazování

V programu pluma jsou dva způsoby, jak vyhledat text. Můžete použít dialog Hledat k hledání zadané části textu nebo Inkrementální hledání ke zvýraznění textu ve shodně s textem jak jej píšete.

### Vyhledávání textu

Pokud chcete v souboru vyhledat textový řetězec, postupujte podle následujících kroků:

1. Choose Search Find to display the Find dialog.

2. Do pole Hledat zadejte řetězec, který chcete najít. Můžete zadat i různé speciální znaky, jako je třeba zalomení řádku nebo tabelátor, jak je uvádí pluma-find-escapes.

3. Klikněte na Hledat a soubor se začne od současné pozice kurzoru prohledávat na výskyt zadaného řetězce. Jakmile pluma najde první výskyt, tak nalezený řetězec vybere. Ostatní výskyty se zvýrazní.

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 .

### Inkrementální vyhledávání

Inkrementální vyhledávání zvýrazňuje shodný text v dokumentu tak, jak jej píšete písmenko po písmenku. (Funguje to podobně jako vyhledávání v některých webových prohlížečích.)

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

Stačí začít psát a v textu se budou zvýrazňovat shody. První výskyt od pozice kurzoru se navíc i vybere.

Pokud chcete výběr posunout na následující shodný text a přitom nechat zobrazené políčko inkrementálního vyhledávání, tak stiskněte Ctrl G. Zpět na předchozí výskyt přesunete výběr stiskem Ctrl Shift G.

Pro pohyb mezi nalezenými výskyty řetězce můžete použít i klávesové šipky nahoru a dolů nebo kolečko myši.

### Nahrazování textu

Pokud chcete v souboru řetězec najít a nahradit jej jiným řetězcem, postupujte následovně:

1. Choose Search Replace to display the Replace dialog.

2. Do pole Hledat zadejte řetězec, který chcete najít. Můžete zadat i různé speciální znaky, jako je třeba zalomení řádku nebo tabelátor, jak je uvádí pluma-find-escapes.

3. Řetězec, kterým chcete nahrazovat nalezený řetězec, zadejte do pole Nahradit za.

Pokud chcete každý nalezený výskyt řetězce před jeho nahrazení zkontrolovat, klikněte na Hledat. Pokud pluma řetězec nalezne, tak jej vybere. Vy potom kliknete na Nahradit a vybraný řetězec se nahradí. Pro pokračování na další výskyt řetězce klikněte znovu na Hledat.

Jestliže chcete nahradit úplně všechny výskyty řetězce v celém dokumenty, tak klikněte na Nahradit vše.

### Volby vyhledávání a nahrazování

Oba dialog Hledat i Nahradit mají následující volby:

- Volbu Rozlišovat velikost písmen vyberte jen v případě, že chcete hledat výskyt řetězců, které se shodují i velikostí písmen. Například s touto zapnutou volbou slovo „TEXT“ neodpovídá slovu „text“.

- Volbu Hledat pouze celá slova vyberte jen v případě, že chcete hledat výskyty, které odpovídají hledanému textu jako samostatné slovo. Například se zapnutou touto volbou slovo „text“ neodpovídá slovu „textura“.

- Volba Hledat pozpátku způsobí, že se bude hledat od pozice kurzoru směrem k začátku dokumentu.

- Volba Přecházet přes okraj způsobí, že po dosažení konce dokumentu bude hledání pokračovat od opačného konce dokumentu.

### Speciální znaky

Pro vyhledávání nebo nahrazování speciálních znaků můžete zadávat následující escape sekvence:

`\n`

- Představuje znak NL (nový řádek).

`\t`

- Představuje znak tabelátor.

`\r`

- Představuje znak CR (na začátek řádku)

`\\`

- Znak zpětné lomítko musí být ošetřený jako escape sekvence. Pokud chcete například najít řetězec „`\n`“, musíte do pole Hledat zadat „\\n“. Jednoduše řečeno, každé zpětné lomítko, které hledáte, musíte zadat zdvojeně.

### Umístění kurzoru na zadaný řádek

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.

Jakmile začnete psát číslo řádku, na který chcete kurzor přesunout, začne se dokument posouvat na zadaný řádek.

Zadání dokončíte stiskem Return. Poličko zmizí a kurzor se přesune na zadaný řádek.

## Tisk

### Nastavení voleb stránky

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

V dialogu Nastavení stránky můžete upravovat následující volby pro stránku:

#### Karta Všeobecné

Print syntax highlighting

- Zvolte tuto možnost, pokud chcete tisknout zvýrazněnou syntaxi. Více informací o zvýrazňování syntaxe podává pluma-set-highlightmode.

Print page headers

- Touto volbou zajistíte tisk záhlaví na každé vyjeté stránce. Vzhled záhlaví nelze nastavit.

Line Numbers

- Zvolte Tisknout čísla řádků, aby se při tisku souboru před každý řádek umístilo jeho číslo.

  Použijte číselné pole Číslo každých ... řádků k určení, jak často se mají čísla řádků tisknout. Například na každém 5 řádku, každém 10 řádku atd.

Text Wrapping

- Zvolte Povolit zalamování textu, aby se při tisku souboru text zalamoval na úrovni znaků na nové řádky. Zalamování nemá vliv na číslování řádků, zlámaný řádek se počítá jako jeden.

  Zvolte Nerozdělovat slova na dva řádky, aby se text při tisku souboru zalamoval na další řádek na úrovni slov.

#### Písma

Body

- Klikněte na toto tlačítko, abyste mohli vybrat písmo použité pro tisk těla textu.

Line numbers

- Klikněte na toto tlačítko, abyste mohli vybrat písmo použité pro tisk čísel řádků.

Headers and footers

- Klikněte na toto tlačítko, abyste mohli vybrat písmo použité pro tisk záhlaví a zápatí.

Výchozí písma pro tisk souborů z pluma nastavíte zpátky kliknutím na Obnovit výchozí písma.

### Tisk dokumentu

V pluma můžete provádět následující tiskové operace:

- Tisk dokumentu na tiskárnu

- Tisk výstupu zpracování tisku do souboru

Pokud tisknete do souboru, pluma posílá výstup do souboru v předtiskovém formátu. Nejběžnější předtiskové formáty jsou PostScript a 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.

Dialog Tisk vám dovoluje přizpůsobit následující nastavení:

#### Karta Úloha

Print range

- Zvolte jednu z následujících možností pro určení, které stránky vytisknout:

  - All

    Tato volba způsobí vytisknutí všech stránek souboru.

  - Lines

    Touto volbou vytisknete jen určené řádky. V polích Od a do zadejte rozsah stránek.

  - Selection

    Tato volba způsobí, že se vytiskne jen vybraný text. Dostupná je ale jen v případě, že nějaký text vybraný je.

Copies

- V poli Kopie můžete zadat kolik kopií souboru chcete vytisknout.

  Pokud tisknete více kopií souboru, můžete volbou Setřídit zajistit, že se stránky správně seřadí.

#### Karta Tiskárna

Printer

- Použijte tento vyskakovací seznam k výběru tiskárny, na kterou chcete soubor vytisknout.

Settings

- V seznamu si zvolte nastavení tiskárny.

  Pokud chcete nastavení tiskárny upravit, klikněte na Nastavit. Můžete například povolit nebo zakázat oboustranný tisk nebo naplánovat zpožděný tisk, pokud tiskárna tyto věci podporuje.

Location

- V tomto seznamu vyberte z následujících možností, kam se má tisk provést:

  CUPS

- Tisknout soubor na tiskárnu CUPS.

  Pokud je vybraná tiskárna tiskárnou CUPS, pak je CUPS jedinou nabízenou volbou v tomto seznamu.

lpr

- Tisknout soubor na tiskárnu.

File

- Tisknut soubor do souboru formátu PostScript.

  Kliknutím na Uložit jako se zobrazí dialog, ve kterém můžete zadat název a umístění souboru formátu PostScript.

Custom

- Použít zadaný příkaz pro tisk do souboru.

  Do textového pole zadejte název příkazu. Včetně všech voleb příkazového řádku.

State

- Tato funkcionalita není v této verzi pluma podporovaná.

Type

- Tato funkcionalita není v této verzi pluma podporovaná.

Comment

- Tato funkcionalita není v této verzi pluma podporovaná.

#### Karta Papír

Paper size

- V tomto vyskakovacím seznamu si zvolte velikost papíru, na který hodláte tisknout.

Width

- V tomto poli můžete zadat šířku papíru. V přiléhajícím seznamu můžete zvolit jednotky, v kterých budete rozměry zadávat.

Height

- V tomto poli můžete zadat výšku papíru.

Feed orientation

- V tomto vyskakovacím seznamu zadejte, jak je natočený papír v podavači.

Page orientation

- V tomto vyskakovacím seznamu zvolte, jaká má být orientace papíru pro tisk.

Layout

- Použijte tento vyskakovací seznam k volbě rozvržení stránky. V Náhledu se vám ukazuje, jak zvolené rozvržení vypadá.

Paper tray

- V tomto vyskakovacím seznamu můžete zvolit, ze kterého podavače bude tiskárna brát papír.

## Programátorské funkce

Několik programátorských funkcí je v pluma nabízeno v podobě zásuvných modulů. Například zásuvný modul Seznam tagů poskytuje seznam nejpoužívanějších tagů pro různé značkovací jazyky: viz pluma-tag-list-plugin.

### Zvýrazňování syntaxe

Zvýrazňování syntaxe usnadňuje čtení zdrojového kódu díky různobarevnému rozlišení částí textu.

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

- Nezobrazuje žádné zvýraznění syntaxe.

Sources

- Zobrazuje zvýraznění syntaxe pro zdrojové kódy. V podnabídce Zdrojové kódy zvolte typ zdrojového kódu.

Markup

- Zobrazuje zvýraznění syntaxe pro značkovací jazyky. V podnabídce Značky zvolte typ značkovacího jazyka.

Scripts

- Zobrazuje zvýraznění syntaxe pro skriptovací jazyky. V podnabídce Skripty zvolte typ skriptovacího jazyka.

Others

- Zobrazuje zvýraznění syntaxe pro ostatní kód. V podnabídce Jiné zvolte typ kódu.

### Propojení výstupu příkazu do souboru

Můžete pluma použít k propojení výstupu příkazu do textového souboru. Například chcete dostat do textového souboru výstup příkazu `ls`, tak stačí napsat `ls | pluma` a stisknout Return.

Výstup příkazu `ls` se zobrazí jako nový textový soubor v okně pluma.

Případně lze použít i zásuvný modul Externí nástroje, který propojí výstup příkazu do současného souboru.

## Klávesové zkratky

Používejte klávesové zkratky pro provádění běžných úkonů rychleji než kdybyste pracovali s myší a nabídkami. Následující tabulky uvádějí klávesové zkratky aplikace pluma.

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

Tabelátory

Klávesové zkratky pro karty:

Klávesová zkratka | Příkaz
Ctrl + Alt + PageUp | Přepnout na následující kartu vlevo.
Ctrl + Alt + PageDown | Přepnout na následující kartu vpravo.
Ctrl + W | Zavřít kartu.
Ctrl + Shift + L | Uložit všechny karty.
Ctrl + Shift + W | Zavřít všechny karty.
Alt + n | Přepnout na n-tou kartu.

Soubory

Klávesové zkratky pro práci se soubory:

Klávesová zkratka | Příkaz
Ctrl + N | Vytvořit nový dokument.
Ctrl + O | Otevřít dokument.
Ctrl + L | Otevřít umístění.
Ctrl + S | Uložit současný dokument na disk.
Ctrl + Shift + S | Uložit současný dokument pod novým názvem.
Ctrl + P | Vytisknout současný dokument.
Ctrl + Shift + P | Zobrazit náhled před tiskem.
Ctrl + W | Zavřít současný dokument.
Ctrl + Q | Ukončit Pluma.

Úprava

Klávesové zkratky pro úpravu dokumentu:

Klávesová zkratka | Příkaz
Ctrl + Z | Vrátit zpět poslední provedený úkon.
Ctrl + Shift + Z | Znovu provést naposledy zpět vrácený úkon.
Ctrl + X | Vyjmout vybraný text nebo oblast a vložit ji do schránky.
Ctrl + C | Zkopírovat vybraný text nebo oblast do schránky.
Ctrl + V | Vložit obsah ze schránky.
Ctrl + A | Vybrat vše.
Ctrl + D | Odstranit aktuální řádek.
Alt + Up | Přesune vybraný řádek o řádek nahoru.
Alt + Down | Přesune vybraný řádek o řádek dolů.

Panely

Klávesové zkratky pro zobrazování a skrývání panelů:

Klávesová zkratka | Příkaz
F9 | Zobrazit/skrýt postranní panel.
Ctrl + F9 | Zobrazit/skrýt spodní panel.

Vyhledávání

Klávesové zkratky pro vyhledávání:

Klávesová zkratka | Příkaz
Ctrl + F | Hledat řetězec.
Ctrl + G | Hledat následující výskyt téhož řetězce.
Ctrl + Shift + G | Hledat předchozí výskyt téhož řetězce.
Ctrl + K | Interaktivní inkrementální vyhledávání.
Ctrl + H | Vyhledat a nahradit.
Ctrl + Shift + K | Zrušit zvýrazňování.
Ctrl + I | Přejít na řádek.

Nástroje

Klávesové zkratky pro nástroje:

Klávesová zkratka | Příkaz
Shift + F7 | Zkontrolovat pravopis (se zásuvným modulem)
Alt + F12 | Odstranit koncové mezery (se zásuvným modulem)
Ctrl + T | Odsadit (se zásuvným modulem)
Ctrl + Shift + T | Zrušit odsazení (se zásuvným modulem)
F8 | Spustit „make“ v aktuální složce (se zásuvným modulem)
Ctrl + Shift + D | Výpis složky (se zásuvným modulem)

Nápověda

Klávesové zkratky pro nápovědu:

Klávesová zkratka | Příkaz
F1 | Otevřít uživatelskou příručku k aplikaci pluma

## Volby

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

### Volby na kartě Zobrazit

Text Wrapping

- Zvolte Povolit zalamování textu, pokud chcete, aby se příliš dlouhé řádky textu zalomily do odstavce místo toho, aby přetékaly za okraj okna. Díky tomu nemusíte používat vodorovný posuvník.

  Zvolte Nerozdělovat slova na dva řádky, pokud chcete zabránit rozdělení celého slova na dva řádky v případě dlouhých řádků. Díky tomu je text lépe čitelný.

Line Numbers

- Zvolte Zobrazovat čísla řádků, pokud chcete na levé straně okna vypisovat čísla řádků.

Current Line

- Zvolte Zvýrazňovat aktuální řádek, pokud chcete zvýraznit řádek, na kterém se nachází kurzor.

Right Margin

- Zvolte Zobrazovat pravý okraj, pokud chcete vykreslovat svislou čáru naznačující pravý okraj.

  V poli Pravý okraj ve sloupci můžete určit umístění čáry označující pravý okraj.

Bracket Matching

- Zvolte Zvýrazňovat odpovídající závorku, pokud chcete zvýraznit odpovídající závorku do páru v situaci, kdy se kurzor nachází na znaku závorky.

### Volby na kartě Editor

Tabs

- Použijte pole Šířka tabelátorů k určení šířky místa, které pluma vloží, pokud stisknete klávesu Tab.

  Zvolte Vkládat mezery místo tabelátorů, pokud chcete, aby pluma vkládal mezery místo znaku tab, ve chvíli, kdy stisknete klávesu Tab.

Auto Indentation

- Zvolte Povolit automatické odsazování, pokud chcete, aby se po přechodu na nový řádek nastavilo stejné odsazení jako u aktuálního.

File Saving

- Zvolte Vytvářet záložní kopii souborů před uložením, pokud chcete vytvářet záložní kopii souboru pokaždé, když soubor uložíte. Záložní kopie souboru obsahuje na konci názvu znak ~.

  Zvolte Automaticky ukládat soubory každých ... minut, pokud chcete aby se aktuální soubory ukládaly v pravidelných intervalech. Do číselného pole zadejte, jak často se má ukládání provádět.

### Volby na kartě Písma a barvy

Font

- Zvolte Použít systémové písmo s pevnou šířkou, pokud chcete použít výchozí systémový font s pevnou šířkou pro text v okně pluma.

  Písmo editoru vám umožňuje vybrat písmo textu, pokud nepoužíváte systémové. Kliknutím na tlačítko můžete vybrat typ písma a jeho styl a velikost.

Color Scheme

- Můžete si vybrat barevné schéma ze seznamu barevných schémat. Standardně jsou nainstalovaná následující barevná schémata:

  Classic

- Klasické barevné schéma založené na barevném schématu gvim.

Cobalt

- Barevné schéma do modra.

Kate

- Barevné schéma používané v editoru Kate.

Oblivion

- Tmavé barevné schéma dle barevné palety Tango.

Tango

- Barevné schéma využívající barevnou paletu Tango.

Můžete i přidat nové barevné schéma kliknutím na Přidat a výběrem souboru s barevným schématem.

Odstranit vybrané barevné schéma lze kliknutím na Odebrat.

### Volby na kartě Zásuvné moduly

Zásuvné moduly přidávají do aplikace pluma dodatečnou funkcionalitu. Více informací o zásuvných modulech a o tom, jak používat zabudované zásuvné moduly, podává pluma-plugins-overview.

#### Povolení zásuvného modulu

Zásuvný modul pluma povolíte následujícím postupem:

1. Choose Edit Preferences .

2. Přejděte na kartu Zásuvné moduly

3. Zaškrtněte pole vedle názvu zásuvného modulu, který chcete povolit.

4. Kliknutím na Zavřít dialog Volby aplikace pluma uzavřete.

#### Zakázání zásuvného modulu

Zásuvný modul zůstane povolený i když pluma ukončíte.

Zásuvný modul pluma zakážete následujícím postupem:

1. Choose Edit Preferences .

2. Přejděte na kartu Zásuvné moduly

3. Zrušte zaškrtnutí pole vedle názvu zásuvného modulu, který chcete zakázat.

4. Kliknutím na Zavřít dialog Volby aplikace pluma uzavřete.

## Zásuvné moduly

### Práce se zásuvnými moduly

Do pluma můžete další funkce doplnit povolením zásuvných modulů. Zásuvný modul je přídavný program, který rozšiřuje funkčnost aplikace. Zásuvné moduly přidávají do nabídek pluma nové položky pro nové funkce, které poskytují.

Několik zásuvných modulů je přímo součástí pluma, další si můžete doinstalovat. Na webu pluma je uvedený seznam zásuvných modulů třetích stran.

K povolení a zakázání nebo jen zjištění, které zásuvné moduly jsou momentálně povolené, použijte Volby zásuvných modulů.

Následující zásuvné moduly vám přináší pluma jako standardní součást:

- Změnit velikost písmen umožňuje změnit velikost písmen vybraného textu.

- Statistika dokumentu ukazuje počet řádků, slov a znaků v dokumentu.

- Externí nástroje umožňuje spustit z pluma externí příkaz.

- Panel prohlížeče souboru vám umožní procházet své soubory a složky v postranním panelu.

- Odsadit řádky přidává nebo ruší odsazení u vybraných řádků.

- Vložit datum/čas přidá aktuální datum a čas do dokumentu.

- Řádky s režimem vám umožní nastavit editační volby zvlášť pro jednotlivé dokumenty a podporuje režimy ve stylu Emacs, Kate a Vim.

- Konzola Pythonu umožňuje spustit příkazy programovacího jazyka Python.

- Úryvky vám umožní zapamatovat si často používané části textu a rychle je do dokumentu vkládat.

- Řadit uspořádává vybrané řádky textu v abecedním pořadí.

- Kontrola pravopisu opravuje překlepy ve vybraném textu nebo chyby v dokumentu automaticky označuje.

- Seznam tagů vám usnadňuje vkládání běžně používaných tagů pro HTML a další jazyky ze seznamu v postranním panelu.

Více informací o tom, jak vytvářet zásuvné moduly, najdete na webu aplikace pluma.

### Zásuvný modul Změnit velikost písmen

Zásuvný modul Změnit velikost písmen mění velikost písmen ve vybraném textu.

Pokud je zásuvný modul Změnit velikost písmen povolený, přidají se do nabídky Upravit následující položky.

Položka nabídky | Činnost | Příklad
Edit Change Case All Upper Case | Každé písmeno změní na velké. | `Tento text` se změní na `TENTO TEXT`
Edit Change Case All Lower Case | Každé písmeno změní na malé. | `Tento Text` se změní na `tento text`
Edit Change Case Invert Case | Každé malé písmeno změní na velké a každé velké písmeno na malé. | `Tento Text` se změní na `tENTO tEXT`
Edit Change Case Title Case | První písmeno každého slova změní na velké, ostatní na malé. | `tento text` se změní na `Tento Text`

### Zásuvný modul Statistika dokumentu

Zásuvný modul Statistika dokumentu počítá řádky, slova, znaky včetně mezer, znaky vyjma mezer a bajty v aktuálním souboru. Výsledky zásuvný modul zobrazuje v dialogu Statistika dokumentu. Pokud chcete využít tento zásuvný modul, postupujte následovně:

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

   - Počet řádků v současném dokumentu.

   - Počet slov v současném dokumentu.

   - Počet znaků v současném dokumentu, včetně mezer.

   - Počet znaků v současném dokumentu, mimo mezer.

   - Počet bajtů v současném dokumentu.

2. Můžete v pluma pokračovat v další práci se souborem a dialog Statistika dokumentu přitom nechat otevřený. Obsah dialogu občerstvíte kliknutím na tlačítko Aktualizovat.

### Zásuvný modul Externí nástroje

Zásuvný modul Externí nástroje slouží ke spouštění externích příkazů z aplikace pluma. Příkazu můžete předat nějaký obsah a využít jeho výstup (např. sed) nebo spustit předefinovaný příkaz (např. make).

Pro vytváření a úpravu příkazů použijte Správce externích nástrojů. Spustit externí příkazy můžete z nabídky Nástroje

#### Zabudované příkazy

Se zásuvným modulem Externí nástroje jsou dodávané následující příkazy:

Sestavit

- Spustí make ve složce současného souboru.

Výpis složky

- Vypíše do nového dokumentu obsah složky současného dokumentu.

Proměnné prostředí

- Zobrazí ve spodním panelu seznam proměnných prostředí.

Grep

- Vyhledá termín pomocí srovnání vzorků ve všech souborech nacházejících se ve složce současného dokumentu. Výsledek se zobrazí ve spodním panelu.

Odstranit koncové mezery

- Odstraní v dokumentu všechny mezery z konců řádků.

#### Definování příkazu

Přidat lze externí příkazy volbou Nástroje Externí nástroje.

V okně Správce externích nástrojů klikněte na Nový. U nového příkazu můžete zadat následující údaje:

Popis

- Popis se ukáže ve stavovém řádku ve chvíli, kdy příkaz vyberete v nabídce.

Klávesová zkratka

- Zadejte klávesovou zkratku pro příkaz.

Příkazy

- Vlastní příkaz, který se má spouštět. Pokud potřebujete příkazu předat údaje, můžete použít několik proměnných prostředí definovaných programem pluma: viz pluma-external-tools-plugin-variables.

Vstup

- Obsah, který lze předat příkazu (přes standardní vstup `stdin`): celý text současného dokumentu, současný výběr, řádek nebo slovo.

Výstup

- Co lze udělat s výstupem příkazu: zobrazit ve spodním panelu, vložit do nového dokumentu nebo vložit do současného dokumentu na konec, na aktuální pozici nebo nahradit výběr nebo celý dokument.

Použitelnost

- Určuje, jakou kategorie dokumentů může příkaz zpracovávat, např. zda jsou uložené nebo ne, místní nebo vzdálené apod.

#### Úprava a odstraňování nástrojů

Pokud chcete nástroj upravit, zvolte jej v seznamu a změňte jeho vlastnosti.

Pokud chcete nástroj přejmenovat, klikněte na něj v seznamu ještě jednou.

Pokud chcete zabudovaný nástroj vrátit do původního stavu, klikněte na Vrátit.

Pokud chcete nástroj odstranit, vyberte jej v seznamu a stiskněte Odstranit. Zabudované nástroje odstranit nelze, pouze ty, které jste vytvořili.

#### Proměnné

V definici příkazu v poli Příkazy můžete použít následující proměnné:

- 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

### Zásuvný modul Panel prohlížeče souborů

Zásuvný modul Panel prohlížeče souborů zobrazuje vaše soubory a složky v postranním panelu, což vám umožňuje rychle otevírat soubory.

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.

#### Procházení vašich souborů

Na kartě prohlížeče souborů jsou v počátečním stavu zobrazené záložky ze správce souborů. Obsah kterékoliv z nich zobrazíte dvojitým kliknutím na ní.

Rodičovskou složku zobrazíte buď výběrem s vyskakovacího seznamu nebo zmáčknutím šipky nahoru na panelu nástrojů prohlížeče souborů.

Složku, která obsahuje dokument, na kterém právě pracujete, zobrazíte kliknutím pravým tlačítkem v seznamu souborů a následnou volbou Nastavit kořen podle aktivního dokumentu.

#### Otevírání souboru

Pro otevření souboru v pluma postačí dvojitě kliknout na soubor v seznamu.

#### Vytváření souborů a složek

Pokud chcete vytvořit nový prázdný textový soubor v aktuální složce zobrazené v prohlížeči, klikněte pravým tlačítkem v seznamu souborů a zvolte Nový soubor.

Pokud chcete vytvořit novou složku v aktuální složce zobrazené v prohlížeči, klikněte pravým tlačítkem v seznamu souborů a zvolte Nová složka.

### Zásuvný modul Odsadit řádky

Zásuvný modul Odsadit řádky přidá nebo odstraní mezery ze začátku textového řádku.

Pro odsazení nebo přiražení textu proveďte následující kroky:

1. Vyberte řádky, který chcete odsadit. Pokud chcete odsadit nebo přirazit jen jeden řádek, stačí na něj umístit textový kurzor.

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

   - To remove the indentation, choose Edit Unindent .

Počet mezer a zda se mají použít mezery nebo tabelátor, je závislé na nastavení Tabelátory ve volbách editoru: viz pluma-prefs-editor.

### Zásuvný modul Vložit datum/čas

Zásuvný modul Vložit datum/čas vkládá současné datum a čas do dokumentu. Tento zásuvný modul se používá následovně:

1. Choose Edit Insert Date and Time .

   Pokud nemáte zásuvný modul Vložit datum/čas nastavený tak, aby vkládal datum/čas automaticky bez ptaní na formát, pluma zobrazí dialog Vložit datum a čas. Ze seznamu si vyberte požadovaný formát data/času. Klikněte na Vložit, dialog se zavře a pluma vloží datum/čas do aktuálního souboru na pozici kurzoru.

   Pokud máte pluma nastavený tak, aby používal konkrétní formát data/času, dialog Vložit datum a čas se nezobrazí. Datum/čas se automaticky vloží na pozici kurzoru v aktuálním souboru.

#### Nastavení zásuvného modulu Vložit datum/čas

Nastavení zásuvného modulu Vložit datum/čas provedete následovně:

1. Choose Edit Preferences .

2. Přejděte na kartu Zásuvné moduly

3. Zvolte zásuvný modul Vložit datum/čas.

4. Klikněte na Nastavit zásuvný modul pro zobrazení dialogu Nastavit zásuvný modul pro vložení data a času.

5. Vyberte jednu z následujících možností:

   - Pokud chcete při každém vkládání data/času určovat jeho formát, zvolte si Zeptat se na formát

   - 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. Kliknutím na OK dialog Nastavit zásuvný modul pro vložení data a času zavřete.

7. Dialog Volby zavřete kliknutím na Zavřít.

### Zásuvný modul Řádky s režimem

Zásuvný modul Řádky s režimem vám umožní nastavit volby pro jednotlivé dokumenty. Řádka s režimem je řádek textu na začátku nebo konci dokumentu obsahující nastavení, která pluma rozpoznává.

Volby nastavené s použitím řádků s režimem mají přednost před stejnými volbami zadanými v dialogu Volby.

V řádcích s režimem můžete nastavit následující volby:

- Šířka tabelátoru

- Šířka odsazení

- Vkládání mezer místo tabelátorů

- Zalamování textu

- Šířka pravého okraje

Zásuvný modul Řádky s režimem podporuje podmnožinu voleb používaných ostatními textovými editory Emacs, Kate a Vim.

#### Řádky s režimem ve stylu Emacs

První dva řádky dokumentu se zkoumají na řádky s režimem Emacs.

Z Emacs jsou podporované volby tab-width, indent-offset, indent-tabs-mode a autowrap. Více informací je v GNU Emacs Manual.

#### Řádky s režimem ve stylu Kate

První dva řádky dokumentu se zkoumají na řádky s režimem Kate.

Z Kate jsou podporované volby tab-width, indent-width, space-indent, word-wrap and word-wrap-column. Více informací je na webu Kate.

#### Řádky s režimem ve stylu Vim

První dva řádky dokumentu se zkoumají na řádky s režimem Vim.

Z Vim jsou podporované volby et, expandtab, ts, tabstop, sw, shiftwidth, wrap, and textwidth. Více informací je na webu Vim.

### Zásuvný modul Konzola Pythonu

Zásuvný modul Konzola Pythonu vám umožňuje spouštět příkazy programovacího jazyka Python z prostředí pluma. Po povolení tohoto zásuvného modulu se přidá karta do spodního panelu. Na ní se zobrazují poslední výstupy a a výzva k příkazu.

Příkazy zadané do konzoly Pythonu se před spuštěním nekontrolují. Proto mohou způsobit zatuhnutí celé aplikace pluma, například když zadáte nekonečnou smyčku.

### Zásuvný modul Úryvky

Zásuvný modul Úryvky vám umožňuje uložit si často používané části textu nazývané úryvky a rychle je vkládat do dokumentu.

Úryvky závisí na jazykové syntaxi aktuálního dokumentu. Například, pokud pracujete v HTML dokumentu, můžete vybírat z úryvků použitelných pro HTML. Některé úryvky jsou ale globální a lze je použít ve všech dokumentech.

Množství zabudovaných úryvků se nainstaluje spolu s aplikací pluma, ale můžete si je upravovat.

#### Vložení úryvku

Úryvek do dokumentu vložíte tak, že napíšete jeho spouštěč tabelátoru a zmáčknete Tab. Spouštěčem tabelátoru je obvykle pár prvních písmen z úryvku nebo jiný krátký a snadno zapamatovatelný text.

Respektive můžete zmáčknout Ctrl Space pro zobrazení seznamu úryvků, které můžete vložit.

#### Přidání úryvku

Nový úryvek vytvoříte následovně:

1. Zvolte Nástroje Spravovat úryvky. Otevře se okno Správce úryvků.

2. Seznam úryvků je seskupený podle jazyků. Zvolte jazyk, do kterého chcete úryvek přidat, nebo nějaký úryvek náležející do onoho jazyka. Pokud chcete přidat úryvek pro všechny jazyky, musíte použít skupinu Globální na začátku seznamu. Skupina odpovídající syntaxi dokumentu, který právě upravujete, se na začátku přímo nabídne.

3. Klikněte na Nový. Nový úryvek se objeví v seznamu.

4. U nového úryvku zadejte následující informace:

   Název

5. Zadejte název úryvku v textovém poli v seznamu úryvků. Název úryvku slouží pouze k označení jeho účelu. Název vytvořeného úryvku můžete změnit kliknutím na vybraný název v seznamu.

Text úryvku

- Do textového pole Upravit zadejte text úryvku. Můžete použít speciální kódy, jak je uvádí pluma-snippets-plugin-syntax.

  Můžete se přepnout zpátky do okna s dokumentem, abyste si zkopírovali text, i bez zavření Správce úryvků.

Spouštěč tabelátoru

- Zadejte spouštěč tabelátoru pro úryvek. Jedná se o text, který musíte zadat, než můžete zmáčknout Tab pro vložení úryvku.

  Značka musí být samostatné slovo skládající se pouze z písmen nebo samostatný znak. V případě, že zadáte neplatný Spouštěč tabelátoru, tak zčervená.

Klávesová zkratka

- Zapište klávesovou zkratku použitelnou pro vložení úryvku.

#### Úprava a odstranění úryvků

Upravit úryvek můžete tak, že jej vyberete v seznamu a změníte jeho text a spouštěcí vlastnosti.

Pokud chcete vybraný úryvek přejmenovat, tak na něj ještě jednou klikněte.

Jestliže jste zabudovaný úryvek změnili a chcete jej vrátit do původního stavu, zmáčkněte Vrátit.

Když chcete úryvek odstranit, tak jej vyberte v seznamu a zmáčkněte Odstranit. Nelze odstranit zabudované úryvky, pouze ty, které jste vytvořili.

#### Náhrady v úryvcích

Mimo vkládání uloženého textu mohou úryvky obsahovat přizpůsobitelný text nebo rezervované místo, na které doplníte text až po vložení úryvku do dokumentu.

V úryvcích můžete použít následující zástupné kódy:

Tabelátorový zástupce

- `$`n`` definuje tabelátorového zástupce, kde `n` je číslo větší než 1.

  `${`n`:`default`}` definuje tabelátorového zástupce s výchozí hodnotou.

  Tabelátorový zástupce označuje v textu úryvku místo, na které můžete po vložení úryvku doplnit dodatečný text.

  Tabelátorového zástupce použijete tak, že úryvek normálně vložíte. Kurzor se umístí na pozici prvního tabelátorového zástupce. Vepište případný text a stiskem Tab se přesunete na dalšího tabelátorového zástupce. Číslo tabelátorového zástupce určuje pořadí, v jakém se budete po tabelátorových zástupcích pohybovat.

  Stisknutím Shift Tab se vrátíte na předchozího tabelátorového zástupce. Pokud stisknete Tab, když už není k dispozici žádný další tabelátorový zástupce, kurzor se přesune na konec úryvku nebo na koncového zástupce, pokud existuje.

Zrcadlený zástupce

- Opakování stejného tabelátorového zástupce bude zrcadlem již definovaného zástupce. Potom stačí zadat text jen jednou a objeví se v úryvku vícekrát.

Koncový zástupce

- `$0` definuje koncového zástupce. Ten umožňuje dokončit práci s úryvkem s kurzorem na jiné pozici, než je konec textu úryvku.

Proměnné prostředí

- Proměnné prostředí, jako je `$PATH` a `$HOME`, se v úryvku příslušně nahradí jejich hodnotou. Navíc můžete použít následující proměnné specifické pro pluma:

  $PLUMA_SELECTED_TEXT

- Aktuálně vybraný text.

$PLUMA_FILENAME

- Plný název souboru s dokumentem nebo prázdný řetězec v případě, že dokument není doposud uložený.

$PLUMA_BASENAME

- Samotný název souboru s dokumentem bez cesty nebo prázdný řetězec v případě, že dokument není doposud uložený.

$PLUMA_CURRENT_WORD

- Slovo nacházející se na pozici kurzoru v dokumentu. Pokud se použije tato proměnná, tak se současné slovo nahradí textem úryvku.

Zástupce Shell

- `$(`cmd`)` se nahradí výsledkem spuštění `cmd` v shellu.

  `$(`n`:`cmd`)` vám umožní se na tohoto zástupce odkazovat. `n` je číslo větší než 1. Použitím `$`n`` můžete zadat výstup jednoho zástupce jako vstup jiného.

Zástupce Python

- `$<`cmd`>` se nahradí výsledkem vyhodnocení `cmd` v interpretru Pythonu.

  `$<`a`:`cmd`>` deklaruje jiného zástupce Python jako závislost, kde `a` určuje jeho pořadí v úryvku. To vám umožňuje použít funkci Pythonu definovanou v jiném úryvku. Více závislostí zadáte jako čísla oddělená čárkami takto: `$<`a`,`b`:`cmd`>`

  Aby šly proměnné použít ve všech dalších úryvcích, musíte je deklarovat jako `global`.

### Zásuvný modul Řadit

Zásuvný modul Řadit uspořádává vybrané řádky textu v abecedním pořadí.

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 .

Zásuvný modul Řadit se používá následovně:

1. Vyberte řádky s textem, které chcete seřadit.

2. Choose Edit Sort . The Sort dialog opens.

3. Nastavte volby, jak chcete řadit:

   - Aby se text uspořádal v opačném pořadí, zvolte Obrácené peřadí.

   - Aby se vymazaly duplicitní řádky, zvolte Odstranit duplikáty.

   - Aby se ignorovala velikost písmen, zvolte Ignorovat velikost písmen.

   - Aby se při řazení ignorovaly znaky na začátku řádku, nastavte první znak, který se použije pro řazení, v poli Začít ve sloupci.

4. Operaci seřazení spustíte kliknutím na Seřadit.

### Zásuvný modul Kontrola pravopisu

Zásuvný modul Kontrola pravopisu kontroluje překlepy ve vybraném textu. Můžete si pluma nastavit tak, aby překlepy kontroloval průběžně automaticky a nebo si kontrolu spouštět ručně, oboje v zadaném jazyce. Nastavený jazyk a automatická kontrola se vztahují na jednotlivé dokumenty. Modul Kontrola pravopisu se používá následovně:

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.

   Neznámá slova se zobrazují barevně podtržená. Můžete na ně kliknout pravým tlačítkem a ve vyskakovací nabídce Návrhy pravopisu provést:

   - Nahrazení neznámého slova jiným slovem ze seznamu volbou navrženého slova ve vyskakovací nabídce Návrhy pravopisu.

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

   Pokud v dokumentu žádná pravopisná chyba není, tak se zobrazí dialog Informace se zprávou, že dokument neobsahuje žádná slova s překlepy. Kliknutím na OK dialog Informace zavřete.

   Pokud v dokumentu pravopisné chyby jsou, tak se zobrazí dialog Kontrolovat pravopis:

   - Chybné slovo je uvedené v horní části dialogu.

   - Navržená správná varianta slova je zobrazená v textovém poli Změnit na. Můžete ji nahradit jiným návrhem správného tvaru buď výběrem ze seznamu Návrhy nebo ručním zadáním slov přímo do pole Změnit na.

   - Překlepy textu v poli Změnit na můžete zkontrolovat kliknutím na Zkontrolovat slovo. Pokud je zadané slovo známé, tak se seznam Návrhů nahradí textem `(správný tvar)`. Pokud je slovo neznámé, objeví se v seznamu Návrhy nové položky.

   - Aktuální výskyt neznámého slova můžete ignorovat kliknutím na Ignorovat. Pokud chcete ignorovat veškeré výskyty toho neznámého slova, tak klikněte na Ignorovat vše. Neznáme slovo se bude ignorovat pouze v tomto sezení pluma.

   - Nahrazení výskytu neznámého slova textem v poli Změnit na provedete kliknutím na Změnit. Všechny výskyty tohoto neznámého slova nahradíte textem v poli Změnit na kliknutím na Změnit vše.

   - Do osobního slovníku neznámé slovo přidáte kliknutím na Přidat slovo.

   - Dialog Kontrolovat pravopis zavřete kliknutím na Zavřít.

### Zásuvný modul Seznam tagů

Zásuvný modul Seznam tagů vám usnadní vkládání běžných tagů ze seznamu v postranním panelu.

Zásuvný modul Seznam tagů se používá následujícím způsobem:

1. Choose View Side Pane .

2. Ve výchozím stavu postranní panel zobrazuje kartu obsahující seznam otevřených dokumentů. Klikněte na kartu s ikonou „+“ v dolní části, aby se zobrazil seznam tagů.

3. Ve vyskakovacím seznamu si vyberte správnou kategorii, např. HTML - Tagy.

4. Najděte si v seznamu požadovaný tag.

5. Tag do aktuálního souboru na pozici kurzoru vložíte dvojitým kliknutím na tag v seznamu. A nebo můžete použít následující postupy:

   - Vložit tag do aktuálního souboru a přepnout zaměření z postranního panelu do zobrazovací oblasti stiskem Return.

   - Vložit tag do aktuálního souboru a zaměření ponechat v Seznamu tagů stiskem Shift Return.