Download aqui

Link externo para este artigo:

https://www.manjaro-linux.com.br/forum/a=102.html

7.1. Sintaxe Básica

Todos os arquivos de configuração do pekwm, exceto o arquivo localizado em ~/.pekwm/start, segue uma sintaxe comum, como é mostrado no exemplo a seguir.

Código: Selecionar todos

# comment
// another comment
/*
   yet another comment
*/

$VARIABLE = "Value"
$_ENVIRONMENT_VARIABLE = "Value"
INCLUDE = "another_configuration.cfg"
COMMAND = "program to execute and add the valid config syntax it outputs here"

# Normal format
Section = "Name" {
   Event = "Param" {
      Actions = "action parameter; action parameter; $VAR $_VARIABLE"
   }
}

// Compressed format
Section = "Name" { Event = "Param" { Actions = "action parameters; action parameters; $VAR $_VARIABLE" } }

Normalmente você pode modificar os espaçamentos e quebras de linha, porém essa é a sintaxe “correta”, então a documentação mostrará a maneira certa de se fazer isso.

Os “Event” podem ser combinados na mesma linha sendo separados por ponto e vírgula. As “Actions” também podem ser combinadas na mesma linha sendo separadas por ponto e vírgula, já o “INCLUDE” pode ser usando em qualquer lugar do arquivo.

Pekwm tem um arquivo chamado vars que serve para definir variáveis comuns entre os arquivos de configuração. Posteriormente esse será o arquivo a ser referenciado em “INCLUDE”.

Comentários são permitidos ao longo de todos os arquivos de configuração, entretanto devem ser iniciados com #, ou / / , também podendo vir entre /* e */.

7.2. Arquivos modelos

O analisador de configurações do pekwm suporta o uso de arquivos modelos para reduzir a digitação. O modelo está atualmente disponível em autopropriedades e arquivos de configuração dos temas. A configuração do modelo não é totalmente compatível com a sintaxe não-modelo e, portanto, requer ativação para não ter problemas com a compatibilidade com versões anteriores. Para habilitar o modelo de análise deve-se iniciar o arquivo de configuração com o seguinte:

Código: Selecionar todos

Require {
              Templates = true
}

Definir modelos é como criar uma seção comum, porém usa-se o nome especial Define. Abaixo está um exemplo com a definição de um modelo chamado NAME.

Código: Selecionar todos

Define = “NAME” {
       Section  = “Sub” {
           ValueSub = “Sub valor”
       }
       Value  = “Valor”
}

O modelo acima pode ser usado posteriormente, utilizando o caractere @. O exemplo abaixo mostra o uso do modelo NAME em duas seções chamadas Name e NameOverride substituindo um dos valores do modelo.

Código: Selecionar todos

Section = “Name” {
    @NAME
}
Section = “NameOverride” {
    @NAME
     Value = “valor a ser substituído”

O exemplo acima é equivalente a escrever o seguinte:

Código: Selecionar todos

Section = “Name” {
      Section = “Sub” {
          ValueSub = “Sub Valor”
      }
      Value = “Valor”
}
Section = “Name” {
      Section = “Sub” {
          ValueSub = “Sub Valor”
      }
}

7.3. Uso das variáveis nos arquivos de configuração do pekwm

O pekwm permite que você use, para sua configuração, tanto as variáveis locais ou internas, bem como as variáveis globais do sistema. Variáveis locais ou internas são prefixados com um $, já as variáveis globais são prefixadas com $_.

Código: Selecionar todos

# examples of how to set both type of variables
$INTERNAL = "this is an internal variable"
$_GLOBAL = "this is a global variable"

# examples of how to read both type of variables
RootMenu = "Menu" {
   Entry = "$_GLOBAL" { Actions = "xmessage $INTERNAL" }
}

Há uma variável global especial em pekwm chamada de $_PEKWM_CONFIG_FILE. Essa variável global é lida quando pekwm começa e seu conteúdo é usado como arquivo de configuração padrão. Se necessário, essa variável será atualizada para apontar os arquivos de configuração ativos no momento.

As variáveis podem ser definidas praticamente em qualquer lugar, mas provavelmente a melhor ideia é colocá-las no inicio do arquivo, fora de quaisquer seções.

Localização do original

http://www.pekwm.org/files/pekwm/doc/0. ... yntax.html

Modificado por

- Holmes, 03-04-14, inclusão do texto.
- Holmes, 03-04-14, revisão e ajuste do texto.

Conteúdo distribuído sob a licença GNU FDL