- Início
- Notícias
- Instalação
- Guia do Usuário
- Fóruns

# Guia do Usuário

## Abas :

Cada janela pode conter um numero de abas, cada um com seu próprio terminal. A diferença do gnome-terminal e versões anteriores do ROXTerm, a barra de abas é sempre mostrada por padrão, mesmo se houver apenas uma guia, para evitar inconsistências ao redimensionar, mas isto é configurável.

If you experience a problem with tab labels shrinking after dragging tabs so that they only have room to display '...', try making sure the pointer is over the body of a terminal when you drop a dragged tab, not over the tab bar area.

## Menus :

Quando a barra de menu é escondida, o menu popup duplica os mesmos itens na barra de menu. isto dá a você acesso completo para todas as funções com a barra de menu oculta. A barra de menu é efetivamente redundante, mas fornecido para fazer RoxTerm parecer mais simples para usuários principiantes. Isso pode ser ligado ou desligado por uma janela particular ou mais permanentemente através do gerente de configuração.

O menu popup também permite endereço web e email, para ser aberto em aplicações externas, se tal endereço é realçado pelo cursor sobre ele.

## Destacado de URI :

Quando o cursor estiver sobre um endereço que o ROXTerm reconhece como uma URI (tipicamente uma URL da web ou endereço de email) será realçado por sublinhado e mudará a forma do cursor. Você pode abrir o endereço pelo botão direito do mouse e selecionando abrir... no menu mantendo pressionado Ctrl e clicar com botão esquerdo do mouse. As aplicações usadas para gerenciar esses endereços, podem ser definidas através das ferramentas de configurações, caso contrário terá que tentar encontrar um padrão adequado. Também mantendo pressionado Crtl você pode arrastar a URI para passar para outra aplicação que aceita URI ou texto, arrastando-o para a mesma janela que veio o endereço de volta colado.

Nota que se o cursor está sobre uma parte de uma URL de endereço de servidor, somente realça o endereço, omitindo o nome do arquivo, mova o cursor do mouse sobre o nome do arquivo para obter URL inteira. Da mesma forma você pode destacar em endereço de email com ou sem um principal mailto:.

As of version 2.9.1 ssh URI and hostname matching is supported. URIs including a path name can only be copied to the clipboard; in the absence of a pathname ROXTerm can also start a ssh session to the described host. Plain hostnames are also matched, but only if they start with "ssh" or end with ".local" or ".lan". Attempting to match more generic hostnames would cause too many false positives. If you regularly use a non-matching ssh server consider adding a matching alias in /etc/hosts.

## Arrastar & Soltar :

Agora você pode arrastar itens na janela do terminal. Objetos de texto são enviados para o terminal como tivesse digitado. Arquivos e URIs tem sua localização (Nome do arquivo ou URI) em lugar do conteúdo do objeto. Arquivos gráficos podem também serem arrastados para área apropriada do gerente de configuração, para definir o fundo da imagem do terminal. Segure a tecla Ctrl enquanto arrasta um URI destacada, permite o endereço a ser arrastado para outra aplicação.

Você pode arrastar abas para reordena-las dentro de uma janela ROXTerm, ou mudar para outra janela ROXTerm, ao soltar uma janela ROXTerm fora de uma janela, uma nova janela ROXTerm é criada. Use o botão direito do mouse para mover uma aba não selecionada sem seleciona-la. Note que versões versões anteriores a 1.9 utiliza o botão do meio do mouse. Na versão atual o botão do meio do mouse é um atalho para colar conteúdo da área de transferência com o nome da aba.

## Named User Sessions :

New in version 3.1.1 is the ability to save named user sessions. Click Save Session... in the File menu to name your session and save it. A session saves the state of current windows and tabs but not the terminals' text content. A session can be restored with roxterm's --session command-line option, or will be restored automatically if named 'Default'. Leaving the field blank is equivalent to 'Default'.

## Configuração :

Configuração se baseia no nome de perfil para que você possa salvar diferente definições de opções e mudar rapidamente entre eles. São perfis para configurações gerais, esquema de cores e atalhos do teclado (ás vezes referidos como aceleradores). Esquema de cores e perfis se aplicam em uma aba de cada vez, mas atalhos do teclado aplicam-se em todas as abas numa mesma janela, para evitar uma potencial confusão em diferentes abas, por haver atalhos diferente de teclado para alternar entre elas. Novas janelas e abas herdarão as definições a partir das novas janela/aba que se abriram.

Antes da versão 1.15.1 todas as abas compartilhavam o mesmo perfil, mas isso foi mudado. Em consequência uma fonte de um perfil e outras definições que afetam o tamanho do terminal, podem ser substituídas para mantem uma geometria consistente atreves de um numero de abas em uma mesma janela.

As preferências do menu permitem você selecionar um perfil atual e etc... (estas configurações não serão lembradas, use o gerente de configuração para definir o padrão), abra o gerente de configuração para editar o perfil atual ou o esquema de cores ou para gerenciar todas as configurações. No gerente de configuração você pode selecionar um dos quatro tipos do grupo de opções e editar, copiar, deletar ou renome-la. Cada item tem um campo de seleção. O item com o campo selecionado é o padrão para novos terminais. Note que codificação de caracteres são ligeiramente manuseados de forma diferente.

## Atalhos do teclado :

There is no editor for keyboard shortcuts; instead, prior to GTK+ 3.10 they can be changed by pressing keys while the mouse is hovering over a menu item in the terminal. This feature must be enabled with the "Enable editing" option under the "Keyboard shortcuts" section of the Configuration Manager. There is also a "hidden" global GNOME setting to determine whether GTK applications can have their shortcuts edited in this way. The global option is managed by gconf, which roxterm is not linked with, so in some circumstances the global and roxterm options may conflict with each other.

The above method for editing shortcuts has been disabled from GTK+ 3.10 onwards. Instead ROXTerm 2.9.1 onwards allows the shortcuts profiles to be edited in a text editor, either via the Configuration Manager or from a terminal's menu (Preferences submenu). Due to an "unintended feature", the action names correspond to the localised labels used in the menu items, but the top-levels ("File", "Edit", "View", "Preferences", "Tabs" and "Help") must be in English. The new shortcuts should automatically be reloaded when you save the file. Alternatively, selecting a scheme in the Preferences menu now forces it to be reloaded.

If you have GTK+ 3.10 or newer, but can't upgrade from an older ROXTerm you will have to open the config files in a text editor yourself, then restart roxterm. The default file is ~/.config/roxterm.sourceforge.net/Shortcuts/Default. If one does not already exist you can copy the Default file provided with roxterm and use it as a template. This can be found as Config/Shortcuts/Default in the source tree, or /usr/share/roxterm/Config/Shortcuts/Default in most installed packages.

## Gerenciamento de Configuração :

Você também pode executar o gerente de configuração selecionando "Configurar..." no menu ROX para aplicação ROXTerm ou executando roxterm-config se o ROXTerm foi instalado de forma convencional.

Os arquivos de configurações podem ser facilmente trocados com outros usuários. Cada perfil, esquema de cores e atalhos do teclado tem um único arquivo associado a ele, salvando um arquivo valido no diretório adequado criara um perfil com os mesmo nome como o arquivo.

Os locais do diretório onde se armazenam os arquivos de configurações, seguem as especificações XDG Base Directory. Em ordem descendente de importância, são eles:

1. ${XDG_CONFIG_HOME}/roxterm.sourceforge.net por padrão ~/.config/roxterm.sourceforge.net
2. ${XDG_CONFIG_DIRS}/roxtem.sourceforge.net por padrão /etc/xdg/roxtem.sourceforge.net
3. ROXTerm/Configuração para usuários ROX, ou ${datadir}/roxterm/Configuração para os outros; ${datadir} normalmente é /usr/share para pacotes ou /usr/local/share quando compilado a partir do código de fonte

Files will be loaded from any and all the above locations; files in high priority locations shadow ones with the same name in lower priority locations. Files are only saved in the first location.

Dentro de qualquer ou cada um desse locais, perfis são salvos em um subdiretório "Perfis", esquema de cor em "Cores" e esquema de atalhos de teclado em "Atalhos". Um arquivo chamado "Global" contem varias opções que não cai nas categorias anteriores, incluindo o perfil padrão para novos terminais.

## Opções de linha de comando :

ROXTerm aceita várias opções por linha de comando. Executar:

roxterm --help

para uma lista completa.

Desde a versão 1.1.0 ROXTerm por padrão ele usa somente um processo para todos os terminais, de modo que você possa arrastar abas entre janelas. Se executa o comando novamente, ele envia uma mensagem D-BUS para o processo existente para sinalizar que abra um novo terminal e o segundo processo termina. Para fazer um comando roxterm executar em seu próprio processo independente use a opção --separate.

Note que as opções --colour_scheme e --shortcut_scheme foram substituídas por --colour-scheme e --shortcut-scheme respectivamente em 1.7.0 (mudou sublinhado para hifens) mas as versões antigas permanece utilizável para versões anteriores para manter compatibilidade.

## Uso avançado do D-Bus :

A partir da versão 1.14.0 usuários avançados podem usar D-Bus para configurar terminais para outras aplicações e scripts. Existem três métodos D-Bus especialmente para este fim, eles exigem um código de identificação para atingir um terminal especifico, cada código de identificação de terminal podem ser lidos de um ambiente variável ROXTERM_ID executando na aplicação/shell. O caminho do objeto D-Bus e métodos para interface são "net.sf.roxterm.Options" e "net/sf/roxterm/Options" respectivamente. Os métodos são:

SetProfile("identificação", "nome_do_perfil")

Peça ao terminal para usar o perfil definido. Note que quaisquer outras abas na mesma janela será atualizada para a mesmo perfil novo. Todas as abas de uma janela deve ter o mesmo perfil para que o tamanho da fonte permaneça com o temanho do terminal consistente.

SetColourScheme("identificador", "nome_do_esquema")

Peça ao terminal para usar um esquema de cores definidos. Abas que compartilham a mesma janela podem haver esquemas de cores diferentes das outras.

SetShortcutScheme("identificação", "Nome_do_esquema")

Peça ao terminal para usar um esquema definido de atalhos de atalhos. Abas que compartilham a mesma janela, compartilham os mesmo esquemas de atalho do teclado.

Exemplo utilizando dbus-send num shell script:

dbus-send --session /net/sf/roxterm/Options \ net.sf.roxterm.Options.SetColourScheme string:$ROXTERM_ID string:GTK

Você poderá enviar sinais D-Bus para mudar opções individuais dentro de um perfil definido ou esquemas de cores usando os métodos StringOption (também usada para opções boolean) e FloatOption. Todos os terminais usando o perfil chamado ou o esquema de cores, são afetados, mas somente temporariamente As opções não são salvas para novos terminais. Os métodos tem 3 argumentos.

- Nome do perfil completo, incluindo um prefixo de "Profiles/" ou "Colours/"
- Nome da opção
- Valor

Para ver quais nomes de opção você pode usar, cheque o arquivo de configuração, de quais tipos podem ser deduzidas.

Exemplo utilizando dbus-send num shell script:

dbus-send --session /net/sf/roxterm/Options \ net.sf.roxterm.Options.StringOption \ string:Colours/GTK string:background 'string:#ffffff'

Um terceiro uso possível é para notificar o roxterm que um perfil, esquema de cores ou esquemas de atalhos do teclado, foram mudados por um programa externo e todos os terminais utilizando esse perfil, etc. Precisam ser recarregados:

OptionsChanged("família", "nome_do_perfil")

onde nome_de_família é um dos "Perfis", "Cores" ou "Atalhos". Por exemplo:

dbus-send --session /net/sf/roxterm/Options \ net.sf.roxterm.Options.OptionsChanged \ string:Profiles string:Default