herbstluftwm - Online na nuvem

PROGRAMA:

NOME

herbstluftwm - um gerenciador de janela de tiling manual para X

SINOPSE

herbstluftwm [OPÇÃO ...]

DESCRIÇÃO

Inicia o herbstluftwm gerenciador de janelas ligado DISPLAY. Ele também ouve chamadas de
cliente de ervas(1) e os executa. A lista de disponíveis COMANDOS está listado abaixo.

OPÇÃO pode ser:

-c, --começo automático PATH
usar PATH como arquivo de inicialização automática em vez de um em $ XDG_CONFIG_HOME

-v, --versão
versão impressa e saída

-l, - bloqueado
Defina inicialmente a configuração monitores_locked para 1

--verbose
imprimir informações detalhadas para stderr

Este manual documenta o script e a interface de configuração. Para um mais prolixo
introdução ver tutorial de ervastluftwm(7).

REVESTIMENTO ALGORITMO

O conceito básico de tiling é que o layout é representado por uma árvore binária. No arranque
você vê um grande quadro em toda a tela. Um quadro cumpre exatamente um dos
seguintes condições:

1. O quadro contém janelas:

Mostra alguns clientes e os organiza. Os algoritmos de layout atuais são:

· 0: vertical - os clientes são colocados abaixo uns dos outros

· 1: horizontal - os clientes são colocados lado a lado

· 2: max - todos os clientes são maximizados neste quadro

· 3: grade - os clientes são organizados em uma grade quase quadrática

2. O quadro é dividido em subtramas:

É dividido em exatamente dois subquadros em um configurável fração ou em uma vertical
ou forma horizontal. Portanto, produz dois quadros que preenchem as mesmas condições (novo
frames sempre estão prestes a conter Windows) Se você dividir um quadro que já
contém janelas, as janelas são herdadas pelo primeiro novo quadro filho.

Se uma nova janela aparecer, ela será colocada no quadro atualmente em foco. Apenas as folhas do
a árvore de quadros pode ser focalizada.

Um quadro pode ser removido e, em seguida, mesclado com o quadro vizinho. Devido ao layout
estrutura de uma árvore binária, cada quadro (ou seja, nó na árvore binária) tem exatamente um
vizinho.

A analogia com uma árvore binária é explicada da melhor maneira com um pequeno exemplo: Na inicialização
você tem uma árvore binária simples, com um quadro que pode conter clientes:

C

Ao dividi-lo (por exemplo, com o comando divisão vertical 0.5) você receberá isto:

V
/\
CC

Você também pode dividir o quadro esquerdo horizontalmente e obterá:

V
/\
HC
/\
CC

Se você mudar o foco para o cliente à direita e remover este quadro, será
mesclado com a subárvore esquerda e você obterá:

H
/\
CC

A traçado O comando imprime o layout atual de todas as tags como uma árvore.

QUADRO ÍNDICE

A posição exata de um quadro na árvore de layout pode ser descrita por seu índice que é
apenas uma seqüência de caracteres. O algoritmo de pesquisa começa no quadro raiz e seleciona um
de suas duas subárvores de acordo com cada caractere no índice.

Os personagens são interpretados da seguinte forma:

· 0: selecione a primeira subárvore

· 1: selecione a segunda subárvore

·.: Selecione a subárvore com o foco

· /: Selecione a subárvore sem o foco

Assim, uma string vazia se refere ao quadro raiz, e "00" se refere à primeira subárvore do
primeira subárvore da estrutura raiz.

Como um caso especial, a string "@" sempre se refere ao quadro atualmente em foco.

TAGS

As tags são muito semelhantes a áreas de trabalho, áreas de trabalho virtuais ou grupos de janelas. Cada tag tem um
layout. Existe uma lista de tags. Você pode adicionar ou remover tags dinamicamente.

MONITORES

Monitores em herbstluftwm são totalmente independentes das telas físicas reais. Esse
significa que você pode, por exemplo, dividir sua tela em dois monitores virtuais para visualizar duas tags em
uma vez em uma tela grande.

Cada monitor exibe exatamente uma tag em um retângulo especificado na tela.

Cada monitor pode ter um nome, que pode ser definido via add_monitor e renomear_monitor. Pode
não estar definido com o renomear_monitor comando. Um nome de monitor é uma string não vazia arbitrária
que não deve começar com +, - ou qualquer dígito.

Um monitor pode ser referenciado de diferentes maneiras:

· Por seu índice absoluto, conforme listado no lista_monitores comando.

· Por seu índice relativo: a + ou - seguido por um delta, por exemplo: +3

· Por sua posição relativa ao monitor em foco. -l denota o monitor à esquerda do
monitor focalizado, -r à direita de, -u acima de e -d abaixo de, respectivamente.

· Por "" (uma string vazia) que representa o monitor atual.

· Por seu nome.

COMANDOS

herbstluftwm é controlado por comandos internos, que podem ser executados via cliente de ervas(1)
ou através de atalhos de teclado.

desistir
Sai do herbstluftwm.

recarregar
Executa o arquivo de inicialização automática.

versão
Imprime a versão da instância herbstluftwm em execução.

eco [ARGS ...]
Imprime todos os dados ARGS separados por um único espaço e uma nova linha depois.

verdadeiro
Ignora todos os argumentos e sempre retorna sucesso, ou seja, 0.

falso
Ignora todos os argumentos e sempre retorna falha, ou seja, 1.

lista_comandos
Lista todos os comandos disponíveis.

lista_monitores
Lista os monitores atualmente configurados com seu índice, área (como retângulo), nome (se
nomeado) e a tag atualmente visualizada.

lista_regras
Lista todas as regras ativas. Cada linha consiste em todos os parâmetros que a regra foi chamada
com, mais seu rótulo, separados por tabulações.

lista_keybinds
Lista todas as chaves associadas com seus comandos associados. Cada linha consiste em uma chave
combinação e o comando com seus parâmetros separados por tabulações.

Aviso
As guias nos parâmetros de comando não têm escape!

trancar
Aumenta o monitores_bloqueados configuração. Use isto se você quiser fazer janelas múltiplas
ações de uma vez (ou seja, sem pintar novamente entre as etapas individuais). Veja também: destravar

destravar
Diminui o monitores_bloqueados contexto. Se monitores_bloqueados é alterado para 0, então todos
os monitores são repintados novamente. Veja também: trancar

atalho de teclado KEY COMANDO [ARGS ...]
Adiciona uma ligação de chave. Quando KEY é pressionado, o interno COMANDO (com sua ARGS) é
executado. Uma ligação de tecla é uma lista (possivelmente vazia) de modificadores (Mod1, Mod2, Mod3,
Mod4, Mod5, Alt, Super, Control / Ctrl, Shift) e uma tecla (veja keysymdef.h para uma lista
das chaves). Os modificadores e a chave são concatenados com - or + como separador. Se houver
já um enlace para este KEY, ele será substituído. Exemplos:

· Teclado Mod4 + Ctrl + q sair

· Keybind Mod1-i toggle always_show_frame

· Keybind Mod1-Shift-space cycle_layout -1

chave desvinculada KEY|-F|--tudo
Remove a ligação de chave para KEY. A sintaxe para KEY é definido em atalho de teclado. Se -F or
--tudo for fornecido, todas as combinações de teclas serão removidas.

ratoeira BOTÃO AÇÃO [COMANDO ...]
Adiciona um vínculo de mouse para o modo flutuante. Quando BOTÃO é pressionado, o especificado
AÇÃO será realizado. BOTÃO tem uma sintaxe semelhante ao KEY argumento de keybind:
Consiste em uma lista de modificadores (separados por - or +, modificadores válidos são listados em
a descrição de atalho de teclado) e exatamente um nome de botão:

· B1 ou Botão1

· B2 ou Botão2

· B3 ou Botão3

· B4 ou Botão4

· B5 ou Botão5

AÇÃO deve ser uma das seguintes ações:

· Mover: move a janela arrastando o cursor.

· Redimensionar: redimensiona a janela arrastando um canto.

· Zoom: redimensiona a janela em todas as quatro direções, mantendo o centro do
constante da janela.

· Ligar: Apenas liga para o especificado COMANDO enquanto client.dragged se conecta ao cliente em
qual o BOTÃO foi desempenhado.

Enquanto um AÇÃO é executado, client.dragged é o cliente que é arrastado. Por exemplo:

· Mousebind Mod1-Button3 zoom

· Mousebind Mod1-B4 substituto de chamada WID clients.dragged.winid spawn transset-df
--inc -i WID 0.05

· Mousebind Mod1-B5 substituto de chamada WID clients.dragged.winid spawn transset-df
--dec -i WID -m 0.2 0.05

mouse unbind
Remove todas as ligações do mouse.

ovas EXECUTÁVEL [ARGS ...]
Gera um EXECUTÁVEL com a sua ARGS. Para detalhes veja homem 3 execvp. Exemplo:

· Spawn xterm -e man 3 execvp

wmexec[GERENCIADOR DE JANELA [ARGS ...]]
Executa o GERENCIADOR DE JANELA com a sua ARGS. Istoéútil para mudar o gerenciador de janelas
na sessão em execução sem reiniciar a sessão. Se não ou um inválido
GERENCIADOR DE JANELA é fornecido, então herbstluftwm é reiniciado. Para detalhes veja homem 3 execvp.
Exemplo:

· Wmexec openbox

cadeia SEPARADOR [COMANDOS ...]
corrente espera um SEPARADOR e uma lista de COMANDOS com argumentos. Os comandos têm que
ser separado pelo especificado SEPARADOR. O SEPARADOR pode por qualquer palavra e só é
reconhecido como o separador entre os comandos se corresponder exatamente SEPARADOR. "cadeia"
produz as saídas anexadas de todos os comandos e retorna o código de saída do último
comando executado. Exemplos são:

· Crie uma tag chamada "foo" e use-a diretamente:

encadear, adicionar foo, usar foo

· Gire o layout no sentido horário:

cadeia .-. trancar .-. girar .-. girar .-. girar .-. desbloquear

Os contra-exemplos são:

· Isso criará apenas uma tag chamada "foo,":

encadear, adicionar foo, usar foo

· Separador "." definido, mas "," é usado:

cadeia . adicione foo, use foo

e SEPARADOR [COMANDOS ...]
"e" se comporta como o comando em cadeia, mas executa apenas o especificado COMANDOS enquanto
os comandos retornam o código de saída 0.

or SEPARADOR [COMANDOS ...]
"ou" se comporta como o comando em cadeia, mas executa apenas o especificado COMANDOS até um
comando retorna o código de saída 0.

! COMANDO
"!" executa o comando fornecido, mas inverte seu valor de retorno. Se o fornecido
comando retorna um diferente de zero, "!" retorna 0, se o comando retornar zero, "!" retorna
para 1.

tentar COMANDO
"try" executa o comando fornecido, imprime sua saída, mas sempre retorna sucesso,
ou seja, 0.

silencioso COMANDO
"silent" executa o comando fornecido, mas descarta sua saída e só retorna seu
código de saída.

foco_nth ÍNDICE
Foca a enésima janela em um quadro. A primeira janela tem ÍNDICE 0. E se ÍNDICE é negativo
ou maior que o índice da última janela, a última janela é focalizada.

ciclo [DELTA]
Percorre a seleção dentro do quadro atual em DELTA. Se DELTA é omitido, DELTA = 1
será usada. DELTA pode ser negativo; DELTA = -1 significa: ciclo no oposto
direção por 1.

ciclo_todos [--pular invisível] [DIRECÇÃO]
Percorre todas as janelas e frames na tag atual. DIRECÇÃO = 1 significa
para a frente DIRECÇÃO = -1 significa para trás, DIRECÇÃO = 0 não tem efeito. DIRECÇÃO
o padrão é 1. Se houver várias janelas no quadro, ele age de forma semelhante a
que o ciclo comando. (O ciclo_todos comando foca a licença seguinte / anterior no
traçado árvore.). Se --pular invisível é fornecido, então isso apenas percorre todos os
janelas e pula janelas invisíveis no layout máximo. A janela em foco é levantada.

ciclo_frame [DIRECÇÃO]
Percorre todos os quadros na tag atual. DIRECÇÃO = 1 significa para a frente, DIRECÇÃO
= -1 significa para trás, DIRECÇÃO = 0 não tem efeito. DIRECÇÃO o padrão é 1.

ciclo_layout [DELTA [LAYOUTS ...]]
Percorre o algoritmo de layout no quadro atual por DELTA. DELTA o padrão é 1. Você
pode encontrar uma lista de algoritmos de layout acima. Se uma lista de LAYOUTS é dada,
cycle_layout percorrerá aqueles em vez da lista de algoritmos de layout padrão.
Cada nome de layout deve ocorrer no máximo uma vez. Exemplo:

· Cycle_layout -1

· Cycle_layout 1 grade vertical

set_layout LAYOUT
Define o algoritmo de layout no quadro atual para LAYOUT. Para a lista de layouts,
verifique a lista de algoritmos de layout acima.

fechar WINID
Fecha a janela especificada normalmente ou a janela em foco se nenhuma for fornecida
explicitamente. Consulte a seção WINDOW IDS para saber como fazer referência a uma determinada janela.

fechar_ou_remover
Fecha a janela em foco ou remove o quadro atual se nenhuma janela estiver em foco.

fechar_e_remover
Fecha a janela em foco e remove o quadro atual se nenhuma outra janela estiver presente
nesse quadro.

divisão ALINHAR [FRAÇÃO]
Divide o quadro em foco em dois subquadros com um FRAÇÃO entre 0 e 1
cujo padrão é 0.5. ALINHAR é um dos

· topo

· fundo (= vertical)

· esquerda,

· certo (= horizontal)

· explodir

· auto (dividir ao longo do lado mais comprido)

Ele especifica qual das duas metades ficará vazia após a divisão. A outra metade
será ocupada pelo quadro atualmente em foco. Após a divisão, o originalmente
o quadro focuse permanecerá focado. Um especial ALINHAR modo é explodir, que divide
a moldura de forma que os tamanhos e posições das janelas sejam mantidos, tanto quanto
possível. Se não FRAÇÃO é dado a explodir modo, uma fração ideal é escolhida
automaticamente. Exemplo:

· Divisão explodir

· Divisão inferior 0.5

· Split horiz 0.3

· Divisão vertical 0.5

· Dividir h

foco [-i|-e] DIRECÇÃO
Move o foco do quadro atual para o próximo quadro ou cliente em DIRECÇÃO que é
dentro:

· deixou]

· direito]

· acima]

· baixa]

If -i (interno) é fornecido ou default_direction_external_only não está definido, então o próximo
cliente em DIRECÇÃO também pode estar no mesmo quadro. Se não houver nenhum cliente dentro
este quadro ou -e (externo) é fornecido, então o próximo quadro é especificado DIRECÇÃO precisarão
estar focado.

A direção entre os quadros é definida da seguinte forma: O foco está em uma folha do
árvore binária. Cada nó interno na árvore lembra a última direção do foco (filho 0
ou criança 1). O algoritmo usa o caminho mais curto possível a partir da folha (o atual
quadro focado) à raiz até que seja possível alterar o foco no especificado
DIRECÇÃO. A partir daí, o foco volta para a folha.

Exemplo: o foco está no quadro A. Após a execução nas certo o foco estará no quadro
C.

Árvore: V, 0 Tela: ┌─────┐┌─────┐ (antes)
╱ ╲ │ B ││ C │
╱ ╲ └─────┘└─────┘
H, 1 H, 0 ┌──────┐┌─────┐
╱ ╲ ╱ ╲ │ A * ││ D │
A * BCD └─────┘└─────┘

Árvore: V, 0 Tela: ┌─────┐┌─────┐ (após o foco à direita)
╱ ╲ │ B ││ C * │
╱ ╲ └─────┘└─────┘
H, 1 H, 0 ┌──────┐┌─────┐
╱ ╲ ╱ ╲ │ A ││ D │
ABC * D └─────┘└─────┘

Se o cliente atualmente focado estiver flutuando, então a próxima janela flutuante no
a direção especificada é focalizada e elevada.

If focus_crosses_monitor_boundaries é definido e nenhum cliente ou quadro é encontrado no
especificada DIRECÇÃO, então o próximo monitor naquele DIRECÇÃO É focado.

foco_edge [-i|-e] DIRECÇÃO
Foca a janela na borda da tag no especificado DIRECÇÃO. O INSTRUÇÕES
e -e comportar-se conforme especificado no nas comando.

If -i (interno) é fornecido ou default_direction_external_only não está definido, então a janela
na borda da tag será focado. Caso contrário, apenas o quadro na borda da tag
será focalizado, e a janela que foi focada por último nesse quadro será focalizada.

aumentar WINID
Aumenta a janela especificada. Consulte a seção WINDOW IDS sobre como fazer referência a um
determinada janela. Seu resultado só é visível no modo flutuante.

Dica
A WINID também pode especificar uma janela não gerenciada, embora a conclusão do aumento
comando não lista os IDs de janelas não gerenciadas.

pule para WINID
Coloca o foco na janela especificada. Consulte a seção WINDOW IDS para saber como
fazer referência a uma determinada janela.

trazer WINID
Move a janela especificada para o quadro atual e a focaliza. Veja a seção sobre
WINDOW IDS sobre como fazer referência a uma determinada janela.

redimensionar DIRECÇÃO FRAÇÃODELTA
Altera a próxima fração no especificado DIRECÇÃO by FRAÇÃODELTA. DIRECÇÃO se comporta
conforme especificado no nas comando. Você não deve omitir o sinal - or +, porque em
versões futuras, o comportamento pode mudar se o sinal for omitido. Exemplo:

· Redimensionar para a direita +0.05

· Redimensionar para baixo -0.1

shift_edge [-i|-e] DIRECÇÃO
Desloca a janela em foco para a borda de uma tag no especificado DIRECÇÃO. O
INSTRUÇÕES comportar-se conforme especificado no nas comando e -i e -e se comporte como especificado
no foco_edge comando.

mudança [-i|-e] DIRECÇÃO
Muda a janela em foco para o próximo quadro no especificado DIRECÇÃO. O INSTRUÇÕES
e -i|-e comportar-se conforme especificado no nas comando. Se o cliente em foco for flutuante
em vez de ser colocado lado a lado, o cliente é deslocado para a próxima janela ou borda da tela.

shift_to_monitor Monitor
Move a janela em foco para a tag no especificado Monitor.

remover
Remove o quadro em foco e mescla suas janelas com o quadro vizinho.

rodar
Gira o layout na tag em foco no sentido anti-horário em 90 graus. Apenas este
manipula o alinhamento dos quadros, não o conteúdo deles.

conjunto NOME VALOR
Define a configuração especificada NOME para VALOR. Todos DEFINIÇÕES estão listados na seção
abaixo.

ter NOME
Imprime o valor da configuração NOME. Todos DEFINIÇÕES estão listados na seção abaixo.

alternancia NOME
Alterna a configuração NOME se for uma configuração de número inteiro: Se seu valor for diferente de 0, ele
torna-se 0; caso contrário, seu valor anterior (que era diferente de 0) é restaurado.

valor_do_ciclo NOME VALORES ...
Valor dos ciclos da configuração NOME NFT`s VALORES: Ou seja, ele pesquisa a primeira ocorrência
do valor atual em VALORES e muda o valor para o próximo na lista ou para o
o primeiro se o fim for alcançado ou se o valor atual não for encontrado. Exemplo:

· Ciclo_valor frame_gap 0 5 10 15

· Cycle_value frame_bg_normal_color vermelho verde azul

ciclo_monitor [DELTA]
Monitor de ciclos focado por DELTA. DELTA o padrão é 1.

foco_monitor Monitor
Coloca o foco no monitor especificado.

adicionar TAG
Cria uma nova tag vazia chamada TAG.

usar TAG
Muda o monitor em foco para o especificado TAG.

use_index ÍNDICE [--skip-visível]
Muda o monitor focado para o TAG com o especificado ÍNDICE. Se ÍNDICE começa com
+ ou -, então ÍNDICE é tratado em relação ao atual TAG. Se --skip-visível passou
e ÍNDICE é relativo, as tags que já estão visíveis em um monitor são ignoradas.
Por exemplo, isso percorre as tags de trás para frente:

· Use_index -1 --skip-visible

use_anterior
Alterna o monitor em foco para a tag visualizada anteriormente.

mesclar_tag TAG [TARGET]
Remove tag nomeada TAG e move todas as suas janelas para marcar TARGET. Se TARGET é omitido,
a tag em foco será usada.

rebatizar ETIQUETA ANTIGA NOVATAG
Renomeia a tag com o nome ETIQUETA ANTIGA para NOVATAG.

mover TAG
Move a janela em foco para a tag chamada TAG.

move_index ÍNDICE [--skip-visível]
Move a janela em foco para a tag especificada por ÍNDICE. Analógico ao argumento para
use_index: Se ÍNDICE começa com + ou -, então é tratado relativo. Se --skip-visível
é passado com um índice relativo, então as tags já visíveis são ignoradas.

etiqueta_de_bloqueio [Monitor]
Trave a troca de tag no monitor especificado. Se nenhum argumento for fornecido, o
atualmente o monitor focalizado é usado. Quando a troca de tag é desabilitada para um monitor,
os comandos usar e use_index não tem efeito quando executado lá. Quando
swap_monitors_to_get_tag está habilitado, alternando para uma tag que está localizada em um
monitor, muda para aquele monitor em vez de roubá-lo de lá. O estado de bloqueio de
um monitor é indicado por "[LOCKED]" no lista_monitores saída.

desbloqueio_tag [Monitor]
Reativa a comutação de tag no monitor especificado. Se nenhum argumento for fornecido, o
atualmente o monitor focalizado é usado. Esta é a operação reversa para tag_de_bloqueio e tem
sem mais efeitos colaterais, mas removendo este bloqueio.

disjoin_rects RETIRADA ...
Pega uma lista de retângulos e os divide em pedaços menores até que todos os retângulos
são disjuntos, os retângulos resultantes são impressos linha por linha. Este comando não
modifique a lista atual de monitores! Portanto, isso pode ser útil em combinação com o
comando set_monitors.

· Por exemplo, disjoin_rects 600x400 + 0 + 0 600x400 + 300 + 250 imprime isto:

300x150 + 300 + 250
600x250 + 0 + 0
300x150 + 0 + 250
300x150 + 600 + 250
600x250 + 300 + 400

· No exemplo acima, dois monitores são divididos em 5 monitores, que graficamente
significa:

┌──────┐ ┌──────┐
│ │ └──────┘
│ ┌───┼────┐ ┌─┐┌───┐┌──┐
│ │ │ │ separar │ ││ ││ │
└──┼───┘ │ ─────────> └─┘└───┘└───┘
│ │ ┌───────┐
└────────┘ └───────┘

set_monitores RETIRADA ...
Define a lista de monitores exatamente à lista de retângulos fornecidos:

· O i'ésimo monitor existente é movido para o i'ésimo dado RETIRAR

· Novos monitores são criados se houver mais RETIRADA então monitora

· Os monitores existentes são excluídos se houver mais monitores então RETIRADA

detectar_monitores -l|--Lista|--não disjuntar
Define a lista de monitores para os monitores Xinerama disponíveis. Se o Xinerama
a extensão estiver faltando, ele retornará para um monitor em toda a tela. Se
os monitores detectados se sobrepõem, o será dividido em mais monitores separados
mas cubra a mesma área usando disjoin_rects.

If -l or --Lista for passado, a lista de retângulos de monitores físicos detectados é
impresso. Portanto, hc detect_monitors é equivalente ao comando bash hc set_monitors $ (hc
disjoin_rects $ (hc detect_monitors -l)).

add_monitor RETIRAR [TAG [NOME]]
Adiciona um monitor no retângulo especificado RETIRAR e exibe TAG nele. TAG atualmente
não deve ser exibido em nenhum outro monitor. RETIRAR é uma string da forma WxH ± X ± Y. Se
não ou vazio TAG for fornecido, então qualquer tag livre será escolhida. Se um NOME é dado, você
pode fazer referência a este monitor por seu nome em vez de usar um índice. Exemplo:

· Add_monitor 1024x768-20 + 0 mynewtag main

remover_monitor Monitor
Remove o monitor especificado.

mover_monitor Monitor RETIRAR [PADUP [PADRIGHT [ALMOFADA [ESQUERDA]]]]
Move o monitor especificado para um retângulo RETIRAR. RETIRAR é definido como em add_monitor. Se
não ou um bloco vazio é fornecido, ele não é alterado.

levantar_monitor [Monitor]
Gera o monitor especificado ou o atual se Monitor é omitido.

renomear_monitor Monitor NOME
(Re) nomeia um monitor já existente. Se NOME está vazio, ele remove o monitor
nome.

pilha
Imprime a pilha de monitores com as marcas visíveis e suas camadas como uma árvore. o
a ordem da pilha impressa é de cima para baixo. O estilo é configurado pelo estilo_árvore
criação.

monitor_rect [[-p] Monitor]
Imprime o retângulo do monitor especificado no formato: X Y W H Se nenhum Monitor or
burro é fornecido, então o monitor atual é usado. Se -p é fornecido, então o restante
rect sem o pad em torno deste monitor é impresso.

caminho Monitor [PADUP [PADRIGHT [ALMOFADA [ESQUERDA]]]]
Define o preenchimento do monitor especificado para o preenchimento especificado. Se nenhum ou um preenchimento vazio
é fornecido, não é alterado.

list_padding [Monitor]
Lista o preenchimento do monitor especificado, ou o monitor focado no momento, se não
monitor é fornecido.

disposição [TAG [ÍNDICE]]
Imprime o layout da moldura com ÍNDICE on TAG, em um belo estilo de árvore. Seu estilo é
definido pelo estilo_árvore configuração. Se não TAG é fornecido, a tag atual é usada. Se não
ÍNDICE é fornecido, o frame raiz é usado. Especificar ÍNDICE sem especificar TAG (isto é,
use a tag atual), passe uma string vazia como TAG.

Um exemplo de saída é:

╾─┐ seleção horizontal de 50% = 1
├─╼vertical: 0xe00009
└─┐ seleção vertical de 50% = 0
├─╼ vertical: 0xa00009 [FOCO]
└─╼vertical: 0x1000009

jogar fora [TAG [ÍNDICE]]
Imprime as mesmas informações que o traçado comando, mas em um formato legível por máquina.
Sua saída pode ser lida de volta com o carregar comando.

Um exemplo de saída (formatado posteriormente) é:

(divisão horizontal: 0.500000: 1
(clientes verticais: 0 0xe00009)
(divisão vertical: 0.500000: 1
(clientes verticais: 0 0xa00009)
(clientes verticais: 0 0x1000009)))

carga [TAG] LAYOUT
Carrega um dado LAYOUT descrição para especificado TAG ou tag atual se não TAG é dada.

Cuidado
LAYOUT é exatamente um parâmetro. Se você estiver chamando manualmente de seu shell ou
de um script, cite-o corretamente!

completar POSIÇÃO [COMANDO ARGS ...]
Imprime o resultado do preenchimento da guia para o parcial COMANDO com opcional ARGS. Você
geralmente não precisa disso, porque já existe um preenchimento de tabulação para o bash. Exemplo:

· Completar 0 m

imprime todos os comandos começando com m

· Completar 1 chave de alternância

imprime todas as configurações começando com fra que podem ser alternadas

concha_completo POSIÇÃO [COMANDO ARGS ...]
Se comporta como completar com os seguintes extras, úteis para completar no posix
cartuchos:

· Sequências de escape são removidas em COMANDO e ARGS.

· Um espaço é anexado a cada resultado de conclusão completa.

· Caracteres especiais terão escape na saída.

emitir_gancho ARGS ...
Emite um gancho personalizado para todos os clientes ativos.

status_da tag [Monitor]
Imprime uma lista separada por tabulação de todas as marcas para o especificado Monitor índice. Se não Monitor
índice é fornecido, o monitor focalizado é usado. Cada nome de tag é prefixado com um char,
que indica seu estado:

· . a tag está vazia

· : a tag não está vazia

· + a tag é visualizada no especificado Monitor, mas este monitor não está focado.

· # a tag é visualizada no especificado Monitor e está focado.

· - a tag é vista em um diferente Monitor, mas este monitor não está focado.

· % a tag é vista em um diferente Monitor e está focado.

· ! a tag contém uma janela urgente

Aviso
Se você usar uma guia em um dos nomes de tag, então tag_status é provavelmente totalmente inútil
para você.

flutuando [[TAG] on|WOW!|alternancia|estado]
Altera a tag atual para o modo flutuante / lado a lado conforme especificado TAG ou imprime atual
status. Se não TAG é fornecido, a tag atual é usada. Se nenhum argumento for fornecido, flutuante
modo é alternado. Se estado é dado, então on or WOW! é impresso, dependendo do
estado flutuante de TAG.

regra [[--]FLAG| [-]LABEL| [-]CONDIÇÃO| [-]CONSEQUÊNCIA ...]
Define uma regra que será aplicada a todos os novos clientes. Seu comportamento é descrito em
que o REGRAS seção.

desregular LABEL|--tudo|-F
Remove todas as regras nomeadas LABEL. Se --all ou -F for passado, todas as regras serão removidas.

tela cheia [on|WOW!|alternancia]
Define ou alterna o estado de tela inteira do cliente em foco. Se nenhum argumento for dado,
o modo de tela inteira é alternado.

pseudotila [on|WOW!|alternancia]
Define ou alterna o estado do pseudotile do cliente em foco. Se um cliente é
pseudotiled, então no modo de tiling o cliente é apenas movido, mas não redimensionado - o cliente
tamanho permanecerá o tamanho flutuante. A única razão para redimensionar o cliente é garantir
que se encaixa em seu ladrilho. Se nenhum argumento for fornecido, o modo pseudotile é alternado.

objeto_árvore [PATH]
Imprime a árvore de objetos. Se o caminho do objeto PATH é dado, apenas a subárvore
Começando às PATH é impresso. Veja o OBJETOS seção para mais detalhes.

atr [PATH [NOVO VALOR]
Imprime os filhos e os atributos de um determinado objeto endereçado por PATH. Se PATH is
um atributo e, em seguida, imprima o valor do atributo. Se NOVO VALOR é dado, atribuir NOVO VALOR para
o atributo dado por PATH. Veja o OBJETOS seção para mais detalhes.

get_attr ATRIBUTO
Imprime o valor do especificado ATRIBUTO conforme descrito no OBJETOS seção.

set_attr ATRIBUTO NOVO VALOR
Atribuir NOVO VALOR à especificada ATRIBUTO conforme descrito no OBJETOS seção.

novo_attr [bool|cor|int|corda|uint] PATH
Cria um novo atributo com o nome e no objeto especificado por PATH. Seu tipo é
especificado pelo primeiro argumento. O nome do atributo deve começar com my_.

remover_attr PATH
Remove o atributo definido pelo usuário PATH.

substituto IDENTIFICADOR ATRIBUTO COMANDO [ARGS ...]
Substitui todas as ocorrências exatas de IDENTIFICADOR in COMANDO ea sua ARGS pelo valor de
que o ATRIBUTO. Observe que o COMANDO também é substituído pelo valor do atributo se
é igual a IDENTIFICADOR. O comando substituído com seus argumentos é então executado. Exemplo:

· Substituir MYTITLE clientes.focus.title echo MYTITLE

Imprime o título da janela atualmente em foco.

corrida IDENTIFICADOR FORMATO [ATRIBUTOS ...] COMANDO [ARGS ...]
Substitui todas as ocorrências exatas de IDENTIFICADOR in COMANDO ea sua ARGS pela corda
especificado por FORMATO. Cada% s em FORMATO representa o valor do próximo atributo em
ATRIBUTOS, semelhante ao printf(1) comando. O comando substituído com seus argumentos
então é executado. Exemplos:

· Sprintf STR title =% s clientes.focus.title echo STR

Imprime o título da janela atualmente focada prefixada por title =.

· Sprintf X tag =% s tags.focus.name regra uma vez X

Move o próximo cliente que aparece para a tag atualmente em foco.

· Sprintf X% s /% s tags.focus.index tags.count echo X

Diz qual tag está em foco e quantas tags existem

· Sprintf l somelongstring echo lll

Imprime uma corda longa três vezes, separada por espaços.

mktemp [bool|int|corda|uint] IDENTIFICADOR COMANDO [ARGS ...]
Cria um atributo temporário com o tipo dado e substitui todas as ocorrências de
IDENTIFICADOR in COMANDO e ARGS pelo caminho do atributo temporário. O substituído
comando com seus argumentos é executado então. O status de saída de COMANDO é devolvido.

comparar ATRIBUTO OPERADOR VALOR
Compara o valor de ATRIBUTO com VALOR usando o método de comparação OPERADOR. Se
a comparação for bem-sucedida, ele retorna 0, senão 1. Os operadores são:

· =: ATRIBUTOo valor de é igual a VALOR

· !=: ATRIBUTOo valor de não é igual VALOR

· le: ATRIBUTOvalor de <= VALOR

· lt: ATRIBUTOvalor de VALOR

· ge: ATRIBUTOvalor de> = VALOR

· gt: ATRIBUTOvalor de> VALOR

A OPERADORES le,lt,ge,gt só pode ser usado se ATRIBUTO é do tipo inteiro ou
inteiro sem sinal. Observe que o primeiro parâmetro deve ser sempre um atributo e o
em segundo lugar, um valor constante. Se você quiser comparar dois atributos, use o substituto
comando:

substituir tags FC.focus.frame_count \
comparar tags.focus.client_count gt FC

Ele retorna o sucesso se houver mais clientes na tag em foco do que quadros.

getenv NOME
Obtém o valor da variável de ambiente NOME.

Setenv NOME VALOR
Defina o valor da variável de ambiente NOME para VALOR.

indefinido NOME
Desfaz a variável de ambiente NOME.

DEFINIÇÕES

As configurações configuram o comportamento do herbstluftwm e podem ser controladas por meio do conjunto, ter
e alternancia comandos. Existem dois tipos de configurações: Strings e valores inteiros. Um
o valor inteiro é definido, se seu valor for 1 ou outro valor diferente de 0. Um valor inteiro é
não definido, se seu valor for 0.

frame_gap (inteiro)
A lacuna entre os quadros no modo de mosaico.

frame_padding (inteiro)
O preenchimento dentro de um quadro no modo lado a lado, ou seja, o espaço entre a borda de um
moldura e as janelas dentro dela.

window_gap (inteiro)
A lacuna entre as janelas em um quadro no modo de mosaico.

snap_distance (inteiro)
Se um cliente é arrastado em modo flutuante, ele se ajusta aos clientes vizinhos se o
a distância entre eles é menor que snap_distance.

snap_gap (inteiro)
Especifica a lacuna restante se um cliente arrastado se encaixar em uma aresta no modo flutuante. Se
snap_gap é definido como 0, nenhuma lacuna permanecerá.

mouse_recenter_gap (inteiro)
Especifica a lacuna em torno de um monitor. Se o monitor estiver selecionado e a posição do mouse
seria restaurado nesta lacuna, ele é definido para o centro do monitor. Isto é
útil, quando o monitor foi deixado pelo movimento do mouse, mas é selecionado novamente pelo teclado.
Se a lacuna for 0 (padrão), o mouse nunca é recentrado.

frame_border_active_color (String / Cor)
A cor da borda de um quadro em foco.

frame_border_normal_color (string / cor)
A cor da borda de um quadro desfocado.

frame_border_inner_color (string / cor)
A cor da borda interna de uma moldura.

frame_bg_active_color (String / Cor)
A cor de preenchimento de um quadro em foco.

frame_bg_normal_color (String / Cor)
A cor de preenchimento de um quadro desfocado (só é visível se always_show_frame estiver definido).

frame_bg_transparent (inteiro)
Se definido, o plano de fundo dos quadros é transparente. Isso significa que um retângulo foi cortado
do interior de modo que apenas a borda do quadro e uma faixa de largura
frame_transparent_width pode ser visto. Usar frame_active_opacity e frame_normal_opacity
para uma transparência real.

frame_transparent_width (inteiro)
Especifica a largura da moldura restante colorida com frame_bg_active_color if
frame_bg_transparent é definido.

frame_border_width (inteiro)
Largura da borda de um quadro.

frame_border_inner_width (inteiro)
A largura da borda interna de uma moldura. Deve ser menor que frame_border_width, uma vez que
não aumenta a largura da borda do quadro, mas faz parte dela.

focus_crosses_monitor_boundaries (inteiro)
Se definido, o comando de foco cruza os limites do monitor. Se não houver nenhum cliente no
direção dada ao foco, então o monitor na direção especificada é focalizado.

raise_on_focus (inteiro)
Se definido, uma janela é levantada se estiver focada. O valor desta configuração é usado apenas em
modo flutuante.

raise_on_focus_temporously (inteiro)
Se definido, uma janela é levantada temporariamente se estiver focada em sua tag. Temporariamente em
neste caso, significa que a janela irá retornar à sua posição de empilhamento anterior se
outra janela está em foco.

raise_on_click (inteiro)
Se definido, uma janela é levantada se for clicado. O valor desta configuração é apenas notado
em modo flutuante.

window_border_width (inteiro)
Largura da borda de uma janela.

window_border_inner_width (inteiro)
A largura da borda interna de uma janela. Deve ser menor que window_border_width,
uma vez que não aumenta a largura da borda da janela, mas faz parte dela.

window_border_active_color (String / Cor)
Cor da borda de uma janela em foco.

window_border_normal_color (string / cor)
Cor da borda de uma janela desfocada.

window_border_urgent_color (string / cor)
Cor da borda de uma janela desfocada, mas urgente.

window_border_inner_color (string / cor)
Cor da borda interna de uma janela.

always_show_frame (inteiro)
Se definido, todos os quadros são exibidos. Se não estiver definido, apenas os quadros com foco ou com janelas
são exibidos.

frame_active_opacity (inteiro)
Opacidade do quadro focalizado em porcentagem. Requer um gerenciador de composição em execução para tomar
efeito real.

frame_normal_opacity (inteiro)
Opacidade do quadro sem foco em porcentagem. Requer um gerenciador de composição em execução para tomar
efeito real.

default_frame_layout (inteiro)
Índice do layout do quadro, que é usado se um novo quadro for criado (por divisão ou em um
nova tag). Para obter uma lista de índices válidos e seus significados, verifique a lista de layout
algoritmos acima.

default_direction_external_only (inteiro)
Esta configuração controla o comportamento de foco e mudança se não -e or -i argumento é
dado. se definido, o foco e o deslocamento mudam o quadro focalizado, mesmo que haja outros
clientes neste quadro no especificado DIRECÇÃO. Caso contrário, um cliente dentro do quadro atual
é selecionado se estiver no especificado DIRECÇÃO.

gapless_grid (inteiro)
Esta configuração afeta o tamanho do último cliente em um quadro que é organizado por grade
layout. Se definido, o último cliente sempre preenche a lacuna dentro desse quadro. Se não estiver definido,
então, o último cliente tem o mesmo tamanho que todos os outros clientes neste quadro.

smart_frame_surroundings (inteiro)
Se definido, as bordas e as lacunas do quadro serão removidas quando não houver ambigüidade em relação ao
quadro focado.

smart_window_surroundings (inteiro)
Se definido, as bordas e lacunas da janela serão removidas e mínimas quando não houver ambigüidade
em relação à janela em foco. Esta decoração de janela mínima pode ser configurada pelo
objeto theme.minimal.

focus_follows_mouse (inteiro)
Se configurada e uma janela é focada pelo cursor do mouse, esta janela é focada (este recurso
também é conhecido como foco descuidado). Se não estiver definido, você precisa clicar para alterar o foco da janela
pelo mouse.

Se outra janela estiver oculta pela mudança de foco (por exemplo, quando tiver janelas pseudo-organizadas
no layout máximo), um clique extra é necessário para alterar o foco.

focus_stealing_prevention (inteiro)
Se definido, apenas pagers e barras de tarefas têm permissão para alterar o foco. Se não estiver definido, todos
os aplicativos podem solicitar uma mudança de foco.

monitores_locked (inteiro)
Se for maior que 0, os clientes em todos os monitores não serão mais movidos ou redimensionados.
Se for definido como 0, a organização dos monitores é ativada novamente e todos os monitores
são reorganizados se o conteúdo deles tiver mudado nesse meio tempo. Você não deve mudar
esta configuração manualmente devido a problemas de simultaneidade; use os comandos trancar e destravar
ao invés.

swap_monitors_to_get_tag (inteiro)
Se configurado: se você deseja visualizar uma tag, que já está sendo visualizada em outro monitor, então o
o conteúdo do monitor será trocado e você verá a tag desejada no monitor em foco. Se
não definido, o outro monitor é focado se mostrar a tag desejada.

auto_detect_monitors (inteiro)
Se definido, detect_monitors é executado automaticamente sempre que um monitor é conectado,
desconectado ou redimensionado.

tree_style (string)
Ele contém os caracteres que são usados ​​para imprimir uma bela árvore ascii. Deve conter em
pelo menos 8 caracteres. por exemplo, X |: # + * -. produz uma árvore como:

X-.root
# -. criança 0
| # - * criança 01
| + - * criança 02
+ -. criança 1
: # - * criança 10
: + - * criança 01

Valores úteis para estilo_árvore são: ╾│ ├└╼─┐ ou - | | '-. ou ╾│ ├╰╼─╮.

wmname (String)
Ele controla o valor da propriedade _NET_WM_NAME na janela raiz, que especifica
o nome do gerenciador de janelas em execução. O valor desta configuração não é atualizado se
a propriedade _NET_WM_NAME real na janela raiz é alterada externamente. Exemplo
uso:

· Cycle_value wmname herbstluftwm LG3D

pseudotile_center_threshold (Int)
Se maior que 0, especifica a menor distância entre um pseudotila centralizado
janela e a borda da moldura ou bloco ao qual está atribuída. Se esta distância for
mais baixo que pseudotile_center_threshold, ele está alinhado ao canto superior esquerdo da janela do cliente
telha.

update_dragged_clients (Int)
Se definido, o conteúdo da janela de um cliente é redimensionado imediatamente durante o redimensionamento com o
mouse. Se não estiver definido, o conteúdo do cliente será redimensionado após o botão do mouse ser liberado.

REGRAS

As regras são usadas para alterar as propriedades padrão de certos clientes quando aparecem. Cada
regra corresponde a um determinado subconjunto de todos os clientes e define um conjunto de propriedades para
eles (chamados CONSEQUÊNCIAs). Uma regra pode ser definida com este comando:

regra [[--]FLAG| [-]LABEL| [-]CONDIÇÃO| [-]CONSEQUÊNCIA ...]

Cada regra consiste em uma lista de FLAGs, CONDIÇÃOs, CONSEQUÊNCIAse, opcionalmente, um LABEL.
(cada um deles pode ser opcionalmente prefixado com dois travessões (-) para fornecer mais
iptables(8) -como sentimento).

Cada regra pode receber um rótulo personalizado, especificando o LABEL propriedade:

· [-] rótulo =VALOR

Se vários rótulos forem especificados, o último da lista será aplicado. Se nenhum rótulo for
fornecido, a regra receberá um nome inteiro que representa o índice da regra
desde o último desregular -F (que é acionado na inicialização automática padrão).

Dica
Os rótulos de regra são padronizados para um índice incremental. Esses rótulos padrão são únicos, a menos que
você atribui uma regra diferente a um inteiro personalizado LABEL. Rótulos padrão podem ser capturados
com o Etiqueta de impressão bandeira.

Se um novo cliente aparecer, herbstluftwm tenta aplicar cada regra a este novo cliente como
segue: Se cada CONDIÇÃO desta regra corresponde a este cliente, então cada
CONSEQUÊNCIA É executado. (Se não houver condições fornecidas, esta regra é executada para
cada cliente)

Cada CONDIÇÃO consiste numa propriedade nome, um operador e um valor. Os operadores válidos são:

· ~ Corresponde se o cliente propriedade é correspondido pela regex valor.

· = Corresponde se o cliente devidamente string é igual a valor.

Válido Propriedades são:

instância
a primeira entrada no WM_CLASS do cliente.

classe
a segunda entrada no WM_CLASS do cliente.

título
título da janela do cliente.

pid
o id do processo do cliente (Aviso: o pid não está disponível para todos os clientes. Isso apenas
corresponde se o cliente definir _NET_WM_PID para o próprio pid).

máximo
corresponde se a idade da regra medida em segundos não exceder valor. Este
condição só pode ser usada com o operador =. Se maxage já foi excedido (e
nunca corresponderá novamente), então esta regra é removida. (Com isso você pode construir regras
que só vivem por um certo tempo.)

tipo de janela
corresponde à propriedade _NET_WM_WINDOW_TYPE de uma janela.

janela
corresponde à propriedade WM_WINDOW_ROLE de uma janela se ela for definida pela janela.

Cada CONSEQUÊNCIA consiste numa NOME=VALOR par. Válido NOMES são:

etiqueta
move o cliente para a tag VALOR.

monitor
move o cliente para a tag no monitor VALOR. Se a consequência da tag também fosse
especificado, e switchtag é definido para o cliente, mova o cliente para essa tag, então
exibir essa tag no monitor VALOR. Se a consequência da tag foi especificada, mas switchtag
não foi, ignore esta consequência.

nas
decide se o cliente obtém o foco de entrada em sua tag. O padrão é WOW!. VALOR
pode ser on, WOW! or alternancia.

etiqueta de comutação
se o foco é ativado e o cliente é colocado em uma tag não focada, então switchtag diz
se a tag do cliente será mostrada ou não. Se a tag for exibida em qualquer monitor, mas
não está focado, a tag do cliente só é trazida para o monitor atual se
swap_monitors_to_get_tag é ativado. VALOR pode ser on, WOW! or alternancia.

gerencia
decide se o cliente será gerenciado ou não. O padrão é on. VALOR pode ser
on, WOW! or alternancia.

índice
move a janela para um índice especificado na árvore. VALOR é um quadro índice.

pseudotila
define o estado do pseudotile do cliente. VALOR pode ser on, WOW! or alternancia.

pedidos ewmh
define se o estado da janela (o estado de tela inteira e o sinalizador de demanda de atenção)
pode ser alterado pelo aplicativo através do próprio ewmh. Isso não afeta o inicial
estado de tela inteira solicitado pela janela. VALOR pode ser on, WOW! or alternancia, é o padrão
para on.

ewmhnotificar
define se hlwm deve deixar o cliente saber sobre as mudanças EMWH (atualmente apenas o
estado de tela inteira). Se estiver definido, os aplicativos não mudam para o modo de tela inteira
enquanto ainda está em tela cheia. VALOR pode ser on, WOW! or alternancia, o padrão é on.

fullscreen
define o sinalizador de tela inteira do cliente. VALOR pode ser on, WOW! or alternancia.

gancho
emite a regra de gancho personalizada VALOR WINID quando esta regra é acionada por uma nova janela
com o id WINID. Esta consequência pode ser usada várias vezes, o que causará um
gancho a ser emitido para cada ocorrência de uma consequência de gancho.

máscara
Define a máscara de teclado para um cliente. Uma máscara de teclado é uma expressão regular que é correspondida
contra a representação de string (consulte list_keybinds). Se corresponder ao atalho de teclado é
ativo quando este cliente está focado, caso contrário, está desabilitado. A máscara de teclado padrão é
uma string vazia (""), que não desativa nenhum atalho de teclado.

O comportamento de uma regra pode ser configurado por algum BANDEIRAS:

· Não: nega o próximo CONDIÇÃO.

·!: O mesmo que não.

· Uma vez: aplique esta regra apenas uma vez (e apague-a depois).

· Printlabel: imprime o rótulo da regra recém-criada para stdout.

· Prefixar: prefixar a regra à lista de regras em vez de anexá-la. Então é
consequências podem ser substituídas por regras já existentes.

Exemplos:

· Regra --class = Netscape --tag = 6 --focus = off

Move todas as instâncias do Netscape para o tag 6, mas não dá o foco para elas.

· Regra, não classe ~. * [Tt] erm tag = 2

Move todos os clientes para a tag 2, se a classe não terminar com prazo ou Prazo.

· Classe de regra = índice Thunderbird = / 0

Insira todas as instâncias do Thunderbird na árvore que não tem foco e lá no primeiro
criança.

· Regra --windowtype = _NET_WM_WINDOW_TYPE_DIALOG --focus = on

Define o foco para novos diálogos que definem seu _NET_WM_WINDOW_TYPE corretamente.

JANELA IDS

Vários comandos aceitam uma janela como referência, por exemplo, fechar. A sintaxe é a seguinte:

· Uma string vazia - ou argumento ausente - faz referência à janela em foco no momento.

· Referências urgentes alguma janela que é urgente.

· 0xHEXIDO - Onde HEXIDO é algum número hexadecimal - referencia a janela com
id de janela hexadecimal X11 é HEXIDO.

· DECIDIR - Onde DECIDIR é algum número decimal - referencia a janela com o decimal
Id de janela X11 DECIDIR.

OBJETOS

Aviso
A árvore de objetos ainda não é estável, ou seja, sua interface pode mudar até o próximo estável
liberar. Portanto, verifique esta documentação novamente após a próxima atualização.

A árvore de objetos é uma coleção de objetos com atributos semelhantes a / sys conhecido do
Kernel do Linux. Muitas entidades (como tags, monitores, clientes, ...) têm objetos para acessar
seus atributos diretamente. A árvore é impressa pelo comando object_tree e parece mais
ou menos da seguinte forma:

$ herbalstclient object_tree
╾─┐
├─┐ etiquetas
│ ├─┐ por nome
│ │ ├─╼ 1
│ │ ...
│ │ └─╼ 9
│ └─╼ foco
├─┐ clientes
│ ├─╼ 0x1400022
│ └─╼ foco
└─┐ monitores
├─╼ por nome
└─╼ foco

Para imprimir uma subárvore começando em um determinado objeto, passe o PATH do objeto para
object_tree. O objeto PATH é o caminho usando o separador. (ponto), por exemplo, tags.por-nome:

$ ervastclient object_tree tags.by-name.
╾─┐ tags.por nome.
├─╼ 1
├─╼ 2
...
└─╼9

Para consultar todos os atributos e filhos de um objeto, passe seu PATH para atrair:

$herstclient attr tags.
2 filhos:
pelo nome.
foco.

1 atributos:
.---- modelo
| .-- gravável
VV
u - contagem = 9

$ ervastclient attr tags.focus.
0 filhos.
6 atributos:
.---- modelo
| .-- gravável
VV
nome sw = "1"
bw flutuante = falso
eu - contagem_quadros = 2
i - cliente_conta = 1
eu - curframe_windex = 0
eu - curframe_wcount = 1

Isso já dá uma intuição do resultado: attr primeiro lista os nomes dos filhos
objetos e, em seguida, todos os atributos, informando para cada atributo:

· Seu tipo

· S para string

· I para inteiro

· B para booleano

· U para inteiro sem sinal

· Se for gravável pelo usuário: w se sim, - senão.

· O nome do atributo

· Seu valor atual (apenas entre aspas)

Para obter o valor sem aspas de um determinado atributo, aborde o atributo usando o mesmo
sintaxe para caminhos de objeto e passe-a para attr ou get_attr:

$herbstclient attr clients.focus.title
ervastluftwm.txt = (~ / dev / c / herbstluftwm / doc) - VIM
$ ervastclient get_attr clients.focus.title
ervastluftwm.txt = (~ / dev / c / herbstluftwm / doc) - VIM

Para alterar um valor de atributo gravável, passe o novo valor para attr ou set_attr:

$ ervastclient attr tags.focus.floating
falso
$ ervastclient attr tags.focus.floating true
$ ervastclient attr tags.focus.floating
verdadeiro
$ ervastclient set_attr tags.focus.floating false
$ ervastclient attr tags.focus.floating
falso

Basta olhar ao redor para sentir o que está lá. O conteúdo detalhado da árvore é listado como
segue:

· Tags: subárvore para tags.

┌────────────┬─────────────────┐
│u - contagem │ número de tags │
└────────────┴─────────────────┘

· índice: o objeto da tag com índice índice.

· Por-nome

· TAG: um objeto para cada tag com o nome TAG

┌──────────────────────┬───────────────────────────────────────────────────────── ────┐
│sw name │ nome da tag │
├──────────────────────┼───────────────────────────────────────────────────────── ────┤
│bw flutuante │ se estiver em modo flutuante │
├──────────────────────┼───────────────────────────────────────────────────────── ────┤
│i - índice │ índice desta tag │
├──────────────────────┼───────────────────────────────────────────────────────── ────┤
│i - frame_count │ número de frames │
├──────────────────────┼───────────────────────────────────────────────────────── ────┤
│i - client_count │ número de clientes nesta tag │
├──────────────────────┼───────────────────────────────────────────────────────── ────┤
│i - curframe_windex │ índice do cliente em foco em │
│ │ o quadro selecionado │
├──────────────────────┼───────────────────────────────────────────────────────── ────┤
│i - curframe_wcount │ número de clientes no │
│ │ quadro selecionado │
└──────────────────────┴───────────────────────────────────────────────────────── ────┘

· Foco: o objeto da tag em foco

· Clientes

· WINID: um objeto para cada cliente com seu WINID

┌─────────────────────────┬────────────────────────────────────────────────────────────────────── ──────────┐
│s - winid │ id da janela │
├─────────────────────────┼────────────────────────────────────────────────────────────────────── ──────────┤
│s - título │ título da janela │
├─────────────────────────┼────────────────────────────────────────────────────────────────────── ──────────┤
│s - tag │ a tag que está atualmente em │
├─────────────────────────┼────────────────────────────────────────────────────────────────────── ──────────┤
│i - pid │ o id do processo dele (-1 se │
│ │ não definido) │
├─────────────────────────┼────────────────────────────────────────────────────────────────────── ──────────┤
│s - classe │ a classe dele (segunda entrada em │
│ │ WM_CLASS) │
├─────────────────────────┼────────────────────────────────────────────────────────────────────── ──────────┤
│s - instância │ a instância dele (primeira entrada │
│ │ em WM_CLASS) │
├─────────────────────────┼────────────────────────────────────────────────────────────────────── ──────────┤
│bw fullscreen │ │
├─────────────────────────┼────────────────────────────────────────────────────────────────────── ──────────┤
│bw pseudotile │ │
├─────────────────────────┼────────────────────────────────────────────────────────────────────── ──────────┤
│bw ewmhrequests │ se os pedidos ewmh são permitidos │
│ │ para este cliente │
├─────────────────────────┼────────────────────────────────────────────────────────────────────── ──────────┤
│bw ewmhnotify │ se o cliente for informado sobre seu │
│ │ estado via ewmh │
├─────────────────────────┼────────────────────────────────────────────────────────────────────── ──────────┤
│bw urgente │ seu estado urgente │
├─────────────────────────┼────────────────────────────────────────────────────────────────────── ──────────┤
│bw sizehints_tiling │ se sizehints para este cliente │
│ │ deve ser respeitado na telha │
│ │ modo │
├─────────────────────────┼────────────────────────────────────────────────────────────────────── ──────────┤
│bw sizehints_flaoting │ se sizehints para este cliente │
│ │ deve ser respeitado na flutuação │
│ │ modo │
└─────────────────────────┴────────────────────────────────────────────────────────────────────── ──────────┘

· Foco: o objeto do cliente em foco, se houver

· Arrastado: o objeto de um cliente que é arrastado pelo mouse, se houver. Veja o
documentação do comando mousebind para exemplos.

· Monitores

┌────────────┬──────────────────────┐
│u - contagem │ número de monitores │
└────────────┴──────────────────────┘

· ÍNDICE: um objeto para cada monitor com seu ÍNDICE

· Por-nome

· NOME: um objeto para cada monitor nomeado

┌───────────────┬───────────────────────────────────
│s - nome │ seu nome │
├───────────────┼───────────────────────────────────
│i - índice │ seu índice │
├───────────────┼───────────────────────────────────
│s - tag │ a tag exibida atualmente │
├───────────────┼───────────────────────────────────
│b - lock_tag │ │
└───────────────┴───────────────────────────────────

· Foco: o objeto do monitor focado

· Settings tem um atributo para cada configuração. Ver DEFINIÇÕES para uma lista.

· O tema possui atributos para configurar a decoração das janelas. tema e muitos de seus filhos
objetos têm os seguintes atributos

┌───────────────────────┬───────────────────────────────────────────────────────── ─────┐
│iw border_width │ a largura da base da fronteira │
├───────────────────────┼───────────────────────────────────────────────────────── ─────┤
│iw padding_top │ largura adicional da borda no │
│ │ topo │
├───────────────────────┼───────────────────────────────────────────────────────── ─────┤
│iw padding_right │ à direita │
├───────────────────────┼───────────────────────────────────────────────────────── ─────┤
│iw padding_bottom │ na parte inferior │
├───────────────────────┼───────────────────────────────────────────────────────── ─────┤
│iw padding_left │ e à esquerda da borda │
├───────────────────────┼───────────────────────────────────────────────────────── ─────┤
│cw color │ a cor de fundo básica de │
│ │ a fronteira │
├───────────────────────┼───────────────────────────────────────────────────────── ─────┤
│iw interior_width │ largura da borda em torno do │
│ │ conteúdo dos clientes │
├───────────────────────┼───────────────────────────────────────────────────────── ─────┤
│cw inner_color │ sua cor │
├───────────────────────┼───────────────────────────────────────────────────────── ─────┤
│iw outer_width │ largura de uma borda adicional │
│ │ perto da borda │
├───────────────────────┼───────────────────────────────────────────────────────── ─────┤
│cw outer_color │ sua cor │
├───────────────────────┼───────────────────────────────────────────────────────── ─────┤
│cw background_color │ cor atrás do conteúdo da janela │
│ │ visível ao redimensionar │
├───────────────────────┼───────────────────────────────────────────────────────── ─────┤
│sw reset │ Escrevendo isto reseta tudo │
│ │ atributos para um valor padrão │
└───────────────────────┴───────────────────────────────────────────────────────── ─────┘

cor_ interna / largura_ interna
╻ outer_color / outer_width
│ ╻
│ │
┌─────╴│╶─────────────────┷─────┐─────┐ border_width
│ │ cor │ ┝ +
│ ┌──┷───────────────────────┐ │ ╯ padding_top
│ │ ==================== .... │ │
│ │ == conteúdo da janela == .... │ │
│ │ ==================== .. ╾──────── background_color
│ │ ........................ │ │
│ └──────────────────────────┘ │ ⎱ border_width +
└─────────────────────────────────┘ ⎰ padding_bottom

Definir um atributo do objeto do tema apenas propaga o valor para o respectivo
atributo do ladrilho e do objeto flutuante.

· Tiling configura a decoração dos clientes de azulejos, configurando um de seus atributos
propaga o respectivo atributo da criança ativa, normal e urgente
objetos.

· Active configura a decoração de clientes focados e ladrilhados

· Normal configura a decoração de clientes desfocados e ladrilhados

· Urgente configura a decoração de clientes urgentes e ladrilhados

· Flutuante se comporta de forma análoga à telha

· Minimal se comporta de forma análoga ao ladrilho e configura essas decorações mínimas
acionado por smart_window_surroundings.

· Active propaga os valores de atributo para tiling.active e floating.active

· Normal propaga os valores de atributo para tiling.normal e floating.normal

· Urgente propaga os valores de atributo para tiling.urgent e floating.urgent

COMEÇO AUTOMÁTICO ARQUIVO

Não há nenhum arquivo de configuração, mas um arquivo de inicialização automática, que é executado na inicialização. Isto é
também executado sob comando recarregar. Se não for especificado pelo --começo automático argumento, autostart
arquivo está localizado em $ XDG_CONFIG_HOME / herbstluftwm / autostart ou em
~ / .config / herbstluftwm / autostart. Normalmente consiste em alguns cliente de ervas chamadas. Se
executar o arquivo de inicialização automática na casa de um usuário falha no arquivo de inicialização automática global (principalmente
colocado em / etc / xdg / herbstluftwm / autostart) é executado como um fallback.

Para uma instalação rápida, copie o arquivo de inicialização automática padrão para ~ / .config / herbstluftwm /.

HOOKS

Em eventos especiais, herbstluftwm emite alguns ganchos (com parâmetros). Você pode receber ou
espere por eles com cliente de ervas(1). Além disso, ganchos personalizados podem ser emitidos com o emitir_gancho
comando. Os seguintes ganchos são emitidos pelo próprio herbstluftwm:

tela inteira [ligado | desligado] WINID ESTADO
O estado de tela inteira da janela WINID foi alterado para [on | off].

tag_changed TAG Monitor
A etiqueta TAG foi selecionado em Monitor.

foco_alterado WINID IMERSÃO DE INGLÊS
A janela WINID estava focado. O título da janela é IMERSÃO DE INGLÊS.

janela_título_alterado WINID IMERSÃO DE INGLÊS
O título do focado janela foi alterada. Seu id de janela é WINID e seu novo título
is IMERSÃO DE INGLÊS.

tag_flags
Os sinalizadores (ou seja, estado urgente ou preenchido) foram alterados.

tag_added TAG
Uma tag chamada TAG foi adicionado.

tag_removido TAG
A tag chamada TAG foi removido.

urgente [ligado | desligado] WINID
O estado urgente do cliente com dado WINID foi alterado para [on | off].

governar NOME WINID
Uma janela com o id WINID apareceu, o que desencadeou uma regra com a consequência
gancho =NOME.

Existem também outros ganchos úteis, que nunca serão emitidos pelo próprio herbstluftwm, mas
que pode ser emitido com o emitir_gancho comando:

quit_panel
Diz a um painel para sair. O painel.sh padrão é encerrado neste gancho. Muitos scripts estão usando
este gancho.

recarregar
Diz a todos os demônios que o começo automático arquivo é recarregado - e diz a eles para sair. Isto
gancho rede de apoio social ser emitido na primeira linha de cada começo automático arquivo.

EMPILHAMENTO

Cada tag tem sua própria pilha de clientes que estão nesta tag. Semelhante ao EWMH
especificação de cada pilha de tags contém várias camadas, que vão de cima para baixo:

· O cliente em foco (se raise_on_focus_temporously estiver habilitado)

· Clientes em tela cheia

· Clientes normais

· Decorações de moldura

Todos os monitores são gerenciados em uma grande pilha que consiste apenas nas pilhas do
tags visíveis colocadas umas sobre as outras. A ordem de empilhamento desses monitores é independente
de seus índices e podem ser modificados usando o levantar_monitor comando. A pilha atual
é ilustrado pelo pilha comando.

EWMH

Tanto quanto possível, herbstluftwm tenta ser compatível com EWMH. Isso inclui:

· São fornecidas informações sobre nomes de tags e listas de clientes.

· As janelas da área de trabalho de ambientes de área de trabalho não são gerenciadas e mantidas abaixo das outras
janelas.

· As solicitações do cliente, como obtenção de foco, são processadas apenas se a configuração
foco_roubo_prevenção está desabilitado.

MEIO AMBIENTE VARIÁVEIS

DISPLAY
Especifica o DISPLAY para usar.

Use herbstluftwm online usando serviços onworks.net