Plug-in de Trechos
O plug-in Trechos permite que você armazene pedaços de texto usados freqüentemente, chamados trechos, e inseri-los rapidamente dentro de um documento.
Os trechos são específicos à sintaxe da linguagem do documento atual. Por exemplo, quando você está trabalhando com um documento HTML, você pode escolher de uma lista de trechos que são úteis para HTML. Além disso, alguns trechos são globais e estão disponíveis para todos os documentos.
Um número de trechos embutidos já vem instalado com o gedit, e pode ser modificado.
- 10.10.1 Inserindo Trechos
- 10.10.2 Adicionando Trechos
- 10.10.3 Editando e Removendo Trechos
- 10.10.4 Substituições de Trechos
10.10.1 Inserindo Trechos
Para inserir um trecho dentro de um documento, digite seu disparador e pressione Tab. Um disparador de trecho é geralmente as primeiras letras do trecho, ou alguma outra coisa que seja pequena e fácil de lembrar.
Opcionalmente, pressione Ctrl+Space para ver uma lista de trechos que você pode inserir.
10.10.2 Adicionando Trechos
Para criar um novo trecho, faça o seguinte:
-
Selecione Gerenciador de Trechos será aberta.
. A janela -
A lista de trechos é agrupada por linguagens. Selecione a linguagem para a qual você quer adicionar um trecho, ou um trecho nesse grupo. Para adicionar um trecho, escolha Global no topo da lista. A sintaxe do documento que você estiver trabalhando é mostrada por padrão.
-
Clique no botão
. Um novo trecho aparece na lista. -
Digite as seguintes informações para o novo trecho:
- Nome
-
Insira um nome para o trecho no campo de texto dentro da lista de trechos. O nome de um trecho serve somente para lembrar para o que ele serve. Você pode mudar o nome de um trecho que você criou clicando nele na lista.
- Texto do trecho
-
Insira o texto do trecho na caixa de texto de Editar trecho. Para códigos especiais que você pode usar, veja a Seção 10.10.4 ― Substituições de Trechos.
Você pode mudar para a janela do documento para copiar texto sem fechar a janela do Gerenciador de Trechos.
- Disparador
-
Insira o disparador para o trecho. Este é o texto que você digita antes de pressionar Tab para inserir o trecho.
A identificação deve ser uma única palavra contendo somente letras, ou qualquer caractere. O Disparador destacará em vermelho se um disparador inválido é inserido.
- Tecla de atalho
-
Digite uma tecla de atalho a usar para inserir o trecho.
10.10.3 Editando e Removendo Trechos
Para editar um trecho, selecione-o na lista e faça as alterações ao texto e propriedades de ativação.
Para renomear um trecho, clique no trecho novamente na lista.
Para restaurar um trecho embutido que você alterou, pressione em Reverter.
Para remover um trecho, selecione-o na lista e pressione no botão
. Você não pode remover trechos embutidos, só aqueles que você criou.10.10.4 Substituições de Trechos
Além de inserir textos armazenados, um trecho pode incluir textos personalizados, ou espaços marcados aos quais você pode adicionar texto, uma vez que o trecho é inserido em seu documento.
Você pode usar os seguintes códigos para marcadores de substituição em trechos de texto:
- Marcadores de substituição
-
$n define um marcador de substituição, onde n é qualquer número de 1 para cima.
${n:padrão} define um marcador de substituição com um valor padrão.
Um marcador de substituição marca um local no trecho onde você pode adicionar texto depois que o trecho é inserido.
Para usar os marcadores de substituição, insira o trecho normalmente. O cursor irá até o primeiro marcador. Digite o texto e pressione Tab para ir para o próximo. O Número no código do marcador define a ordem na qual o cursor avança ao pressionar Tab.
Pressione Shift+Tab para retornar ao marcador de substituição anterior. Pressionar Tab quando não há mais marcadores de substituição move o cursor até o fim do trecho, ou até o marcador de fim, se existir.
- Marcadores espelhos
-
Um marcador de substituição repetido irá copiar o marcador já definido. Isso permite a você digitar só uma vez um texto que você quer que apareça várias vezes no trecho.
- Marcador de fim
-
$0 define um marcador de fim. Isso permite a você terminar de trabalhar no trecho com o cursor em um lugar diferente do fim do trecho.
- Variáveis de ambiente
-
Variáveis de ambiente como $PATH e $HOME são substituídas no texto do trecho. As seguintes variáveis específicas do gedit podem ser usadas:
- $GEDIT_SELECTED_TEXT
-
O texto selecionado no momento.
- $GEDIT_FILENAME
-
O nome completo de arquivo do documento, ou uma seqüência vazia se o documento ainda não estiver salvo.
- $GEDIT_BASENAME
-
O nome do arquivo sem a extensão, ou uma seqüência vazia se o documento ainda não estiver salvo.
- $GEDIT_CURRENT_WORD
-
A palavra que estiver na posição do cursor no documento. Quando essa variável é usada, a palavra atual será substituída pelo texto do trecho.
- Marcadores de substituição do Shell
-
$(cmd) é substituído pelo resultado da execução de cmd no shell.
$(n:cmd) permite a você dar a esse marcador de substituição uma referência, onde n é qualquer número de 1 para cima. Use $n para usar a saída de um marcador de substituição de shell como entrada em outro.
- Marcadores de substituição do Python
-
$<cmd> é substituído pelo resultado da execução de cmd no interpretador python.
$<a:cmd> especifica outro marcador de substituição do python como uma dependência, onde a fornece sua ordem no trecho. Isso permite a você usar funções do python definidos em outro trecho. Para especificar várias dependências, separe os números com vírgulas, assim: $<a,b:cmd>
Para usar uma variável em todos os outros trechos de python, declare-a como global.