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í gedit, ale můžete si je upravovat.

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

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

    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í Oddíl 10.10.4 ― Náhrady v úryvcích.

    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.

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

10.10.4. 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 gedit:

$GEDIT_SELECTED_TEXT

Aktuálně vybraný text.

$GEDIT_FILENAME

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

$GEDIT_BASENAME

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

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