From 0b8ca6637be94f7814cafa7d01ad4699672ff336 Mon Sep 17 00:00:00 2001 From: Darrell Anderson Date: Tue, 21 Jan 2014 22:06:48 -0600 Subject: Beautify docbook files --- .../docs/tdewebdev/kommander/basics.docbook | 172 ++++----------------- 1 file changed, 33 insertions(+), 139 deletions(-) (limited to 'tde-i18n-pt_BR/docs/tdewebdev/kommander/basics.docbook') diff --git a/tde-i18n-pt_BR/docs/tdewebdev/kommander/basics.docbook b/tde-i18n-pt_BR/docs/tdewebdev/kommander/basics.docbook index 5efcc4da723..9189a381185 100644 --- a/tde-i18n-pt_BR/docs/tdewebdev/kommander/basics.docbook +++ b/tde-i18n-pt_BR/docs/tdewebdev/kommander/basics.docbook @@ -2,175 +2,69 @@ -Fundamentos do &kommander; +Fundamentos do &kommander; -Tamara King
tik@acm.org -
 +Tamara King
tik@acm.org +
 -Eric Laffoon
sequitur@kde.org -
 +Eric Laffoon
sequitur@kde.org +
 -MarcusGama
marcus_gama@uol.com.br
Tradução +MarcusGama
marcus_gama@uol.com.br
Tradução -Fundamentos do &kommander; +Fundamentos do &kommander; -Conceitos - - -O &kommander; foi desenhado originalmente ao redor de um conceito simples que se provou, de qualquer forma, revolucionário entre as ferramentas de desenho visual. Tipicamente, estas ferramentas permitem-lhe criar janelas e, possivelmente, algumas interfaces completas. Claro que uma interface completa corresponde à janela principal do programa que tem tipicamente menus, uma barra de estado e a área do aplicativo. As janelas de diálogo são janelas-filhas que tipicamente não possuem menus e que são assim chamadas porque o seu intuito é estabelecer um diálogo ou trocar informações entre você e o aplicativo principal. Os itens numa janela são chamados de elementos gráficos ou widgets e você interliga o seu programa com estes elementos. O &kommander; é diferente porque é, inerentemente, não-programático aqui. Ele usa o conceito de associar o texto com os elementos gráficos da janela. Inicialmente isto era chamado de Texto Associado mas agora é chamado de Texto do &kommander;. Os elementos gráficos nas janelas do &kommander; poderão incluir o conteúdo de outros elementos através de referências, e um elemento poderá referenciar o seu próprio conteúdo, através da utilização de um Especial que se parece com o seguinte, @widgetText. Os especiais são comandos que possuem um significado particular no &kommander;. Por isso, se você criou uma janela com dois campos de texto e chamou o primeiro campo PrimeiroNome e o segundo UltimoNome, você poderia criar um botão e definir o seu Texto do &kommander; como sendo O meu nome é @PrimeiroNome @UltimoNome. Você teria que definir o @widgetText nos elementos do primeiro e último nomes. Lembra-se? É preciso dizer ao &kommander; para referenciar o texto dentro deles. Você poderia executar isto a partir de um Konsole e ele iria mostrar o texto para você. Por isso, iria referenciar o primeiro nome da seguinte forma: @PrimeiroNome -> obtém o elemento chamado PrimeiroNome (@PrimeiroNome) -> @widgetText -> obtém o conteúdo do campo LineEdit. Por isso, neste caso, o @PrimeiroNome devolve José: @PrimeiroNome -> @widgetText -> José. - -Esta é a base simples do &kommander;. O que você poderá fazer com isto é o que realmente interessa. Antes de mais nada, é importante notar que, comparado com a abordagem normal de uma ferramenta baseada numa linguagem, o &kommander; não necessita de instruções de programação para definir estas operações. Isto torna o &kommander; rápido para os programadores. Para os usuários finais, é muito mais simples do que aprender as bases de uma linguagem. Para todos, isto significa que você poderá focar a sua tarefa, em vez de ter o seu material de referência eternamente à mão. Inicialmente, quando as pessoas ficam expostas a uma ferramenta como o &kommander;, a primeira pergunta é Onde eu poderei usar esta ferramenta legal? À medida que avança, a manipulação de texto é praticamente tudo o que precisa. - -Assim, o que o &kommander; pode fazer? Aqui está uma lista que extrai as operações básicas. O &kommander; pode: +Conceitos + + +O &kommander; foi desenhado originalmente ao redor de um conceito simples que se provou, de qualquer forma, revolucionário entre as ferramentas de desenho visual. Tipicamente, estas ferramentas permitem-lhe criar janelas e, possivelmente, algumas interfaces completas. Claro que uma interface completa corresponde à janela principal do programa que tem tipicamente menus, uma barra de estado e a área do aplicativo. As janelas de diálogo são janelas-filhas que tipicamente não possuem menus e que são assim chamadas porque o seu intuito é estabelecer um diálogo ou trocar informações entre você e o aplicativo principal. Os itens numa janela são chamados de elementos gráficos ou widgets e você interliga o seu programa com estes elementos. O &kommander; é diferente porque é, inerentemente, não-programático aqui. Ele usa o conceito de associar o texto com os elementos gráficos da janela. Inicialmente isto era chamado de Texto Associado mas agora é chamado de Texto do &kommander;. Os elementos gráficos nas janelas do &kommander; poderão incluir o conteúdo de outros elementos através de referências, e um elemento poderá referenciar o seu próprio conteúdo, através da utilização de um Especial que se parece com o seguinte, @widgetText. Os especiais são comandos que possuem um significado particular no &kommander;. Por isso, se você criou uma janela com dois campos de texto e chamou o primeiro campo PrimeiroNome e o segundo UltimoNome, você poderia criar um botão e definir o seu Texto do &kommander; como sendo O meu nome é @PrimeiroNome @UltimoNome. Você teria que definir o @widgetText nos elementos do primeiro e último nomes. Lembra-se? É preciso dizer ao &kommander; para referenciar o texto dentro deles. Você poderia executar isto a partir de um Konsole e ele iria mostrar o texto para você. Por isso, iria referenciar o primeiro nome da seguinte forma: @PrimeiroNome -> obtém o elemento chamado PrimeiroNome (@PrimeiroNome) -> @widgetText -> obtém o conteúdo do campo LineEdit. Por isso, neste caso, o @PrimeiroNome devolve José: @PrimeiroNome -> @widgetText -> José. + +Esta é a base simples do &kommander;. O que você poderá fazer com isto é o que realmente interessa. Antes de mais nada, é importante notar que, comparado com a abordagem normal de uma ferramenta baseada numa linguagem, o &kommander; não necessita de instruções de programação para definir estas operações. Isto torna o &kommander; rápido para os programadores. Para os usuários finais, é muito mais simples do que aprender as bases de uma linguagem. Para todos, isto significa que você poderá focar a sua tarefa, em vez de ter o seu material de referência eternamente à mão. Inicialmente, quando as pessoas ficam expostas a uma ferramenta como o &kommander;, a primeira pergunta é Onde eu poderei usar esta ferramenta legal? À medida que avança, a manipulação de texto é praticamente tudo o que precisa. + +Assim, o que o &kommander; pode fazer? Aqui está uma lista que extrai as operações básicas. O &kommander; pode: -Passar cadeias de caracteres ao programa invocado através do 'stdout'. -Invocar programas executáveis. -Usar o &DCOP; para interagir com os programas do &kde; +Passar cadeias de caracteres ao programa invocado através do 'stdout'. +Invocar programas executáveis. +Usar o &DCOP; para interagir com os programas do &kde; -Se você não for um programador, você poderá querer saber o que é isso em termos mais simples. Em primeiro lugar, se você lançar o &kommander; a partir de um console, então esse console será o programa invocador. Existe uma relação pai-filho aí. O envio de uma mensagem para o console é feito através da 'saída padrão' (stdout) do programa filho, assim chamada porque existe também a 'saída de erros'. Isto é interessante porque alguns programas, como o &quantaplus;, usam a 'stdout' para receber informações dos programas que lançam. Por isso, as janelas do &kommander; podem devolver os seus textos de resultado diretamente no editor do &quantaplus; se forem chamados a partir dele. Isto significa que as janelas do &kommander; podem ser extensões úteis para os programas. - -O segundo caso é a invocação de um executável. Qualquer programa que rode no seu sistema é um executável. Até mesmo um 'script' é executado pelo interpretador dele, por isso também é tecnicamente um executável. O &kommander; poderá executar comandos, tal como o console, mesmo que o execute a partir do menu. Por isso, e por exemplo, se você quiser que ele abra o &GIMP;, você teria um botão do qual derivasse o texto gimp e o colocasse num item especial como por exemplo: @exec(gimp); nesse caso veria o &GIMP; abrindo. Você poderá também executar o ls -l, mas só iria ver o resultado se você o estivesse rodando a partir de um console. - -O terceiro caso é bastante interessante, de fato. O &DCOP; é a abreviatura do Desktop COmmunication Protocol do &kde; e é bastante poderoso. Siga em frente e rode o programa kdcop para dar uma olhada. Você irá ver rapidamente que qualquer aplicativo que seja desenvolvido segundo as normas faz as coisas acontecerem através do &DCOP; e os muito bem desenhados terão bastantes coisas lá. Com o &DCOP; você poderá obter informações de vários tipos, assim como definir os valores dos elementos gráficos, entre outras coisas. Existe uma seção sobre a utilização do &DCOP; neste manual. O &kommander; poderá enviar pedidos de &DCOP; para qualquer aplicativo do &kde;, assim como poderá também ser controlado pelo &DCOP;. De fato, você consegue invocar o &DCOP; na linha de comando para qualquer programa do &kde;. Então, o que há de tão especial? O especial é que, se quiser fazer um volume de comandos, você começa a perceber que o &DCOP; da linha de comando é adequado para comandos curtos, mas poderá provocar atrasos, por exemplo, sendo chamado num ciclo centenas vezes. É por isso que o &kommander; tem um especial @dcop, porque é aproximadamente 1 000 vezes mais rápido. Uma vez que o &kommander; pode enviar e receber pedidos de &DCOP;, o &DCOP; poderá ser usado para criar 'scripts' no &kommander;. É por isso que existe também um especial de &DCOP; local, o @ldcop, que lhe permite escrever muito menos coisas para emitir um comando. - -Isto é tudo sobre os conceitos fundamentais do &kommander;? Não, mas deverá ajudá-lo a perceber um pouco como ele funciona, para que o que for abordado não pareça uma língua estrangeira para você. Existem mais algumas coisas. Os 'signals' e os 'slots' são a forma como o &kommander; lida com os eventos. Um evento num programa basicamente diz que algo aconteceu como, por exemplo, a criação de um elemento gráfico ou a alteração do texto deste. Estas alterações emitem 'signals' e você poderá ligar estes 'signals' a um 'slot' receptor que irá então fazer algo quando o evento ocorrer. Um uso disto no &kommander; é o parente do Text do &kommander;, o Texto de População. O Texto de População irá preencher um elemento gráfico quando for chamado. Tal como o Text do &kommander;, o Texto de População poderá conter sequências de texto ou programas. - -Isto deverá fornecer-lhe os conceitos básicos para começar a usar o &kommander;. Nós tentaremos manter o número de Especiais baixo e usar bastante o &DCOP;. A idéia é que se pretende manter o poder do &kommander; tão consistente e intuitivo quanto possível. Você irá concluir que poderá incorporar qualquer linguagem de 'scripting' no &kommander;, onde quer que precise, e até poderá mesmo usar várias linguagens numa mesma janela. O resto da informação deste documento assume que você está familiarizado com os conceitos e termos aqui apresentados. Os exemplos e tutoriais são também bastante úteis para compreender o que poderá ser feito com o &kommander;. +Se você não for um programador, você poderá querer saber o que é isso em termos mais simples. Em primeiro lugar, se você lançar o &kommander; a partir de um console, então esse console será o programa invocador. Existe uma relação pai-filho aí. O envio de uma mensagem para o console é feito através da 'saída padrão' (stdout) do programa filho, assim chamada porque existe também a 'saída de erros'. Isto é interessante porque alguns programas, como o &quantaplus;, usam a 'stdout' para receber informações dos programas que lançam. Por isso, as janelas do &kommander; podem devolver os seus textos de resultado diretamente no editor do &quantaplus; se forem chamados a partir dele. Isto significa que as janelas do &kommander; podem ser extensões úteis para os programas. + +O segundo caso é a invocação de um executável. Qualquer programa que rode no seu sistema é um executável. Até mesmo um 'script' é executado pelo interpretador dele, por isso também é tecnicamente um executável. O &kommander; poderá executar comandos, tal como o console, mesmo que o execute a partir do menu. Por isso, e por exemplo, se você quiser que ele abra o &GIMP;, você teria um botão do qual derivasse o texto gimp e o colocasse num item especial como por exemplo: @exec(gimp); nesse caso veria o &GIMP; abrindo. Você poderá também executar o ls -l, mas só iria ver o resultado se você o estivesse rodando a partir de um console. + +O terceiro caso é bastante interessante, de fato. O &DCOP; é a abreviatura do Desktop COmmunication Protocol do &kde; e é bastante poderoso. Siga em frente e rode o programa kdcop para dar uma olhada. Você irá ver rapidamente que qualquer aplicativo que seja desenvolvido segundo as normas faz as coisas acontecerem através do &DCOP; e os muito bem desenhados terão bastantes coisas lá. Com o &DCOP; você poderá obter informações de vários tipos, assim como definir os valores dos elementos gráficos, entre outras coisas. Existe uma seção sobre a utilização do &DCOP; neste manual. O &kommander; poderá enviar pedidos de &DCOP; para qualquer aplicativo do &kde;, assim como poderá também ser controlado pelo &DCOP;. De fato, você consegue invocar o &DCOP; na linha de comando para qualquer programa do &kde;. Então, o que há de tão especial? O especial é que, se quiser fazer um volume de comandos, você começa a perceber que o &DCOP; da linha de comando é adequado para comandos curtos, mas poderá provocar atrasos, por exemplo, sendo chamado num ciclo centenas vezes. É por isso que o &kommander; tem um especial @dcop, porque é aproximadamente 1 000 vezes mais rápido. Uma vez que o &kommander; pode enviar e receber pedidos de &DCOP;, o &DCOP; poderá ser usado para criar 'scripts' no &kommander;. É por isso que existe também um especial de &DCOP; local, o @ldcop, que lhe permite escrever muito menos coisas para emitir um comando. + +Isto é tudo sobre os conceitos fundamentais do &kommander;? Não, mas deverá ajudá-lo a perceber um pouco como ele funciona, para que o que for abordado não pareça uma língua estrangeira para você. Existem mais algumas coisas. Os 'signals' e os 'slots' são a forma como o &kommander; lida com os eventos. Um evento num programa basicamente diz que algo aconteceu como, por exemplo, a criação de um elemento gráfico ou a alteração do texto deste. Estas alterações emitem 'signals' e você poderá ligar estes 'signals' a um 'slot' receptor que irá então fazer algo quando o evento ocorrer. Um uso disto no &kommander; é o parente do Text do &kommander;, o Texto de População. O Texto de População irá preencher um elemento gráfico quando for chamado. Tal como o Text do &kommander;, o Texto de População poderá conter sequências de texto ou programas. + +Isto deverá fornecer-lhe os conceitos básicos para começar a usar o &kommander;. Nós tentaremos manter o número de Especiais baixo e usar bastante o &DCOP;. A idéia é que se pretende manter o poder do &kommander; tão consistente e intuitivo quanto possível. Você irá concluir que poderá incorporar qualquer linguagem de 'scripting' no &kommander;, onde quer que precise, e até poderá mesmo usar várias linguagens numa mesma janela. O resto da informação deste documento assume que você está familiarizado com os conceitos e termos aqui apresentados. Os exemplos e tutoriais são também bastante úteis para compreender o que poderá ser feito com o &kommander;. &editor; -O Executor +O Executor -O executor, chamado kmdr-executor, roda os programas do &kommander;. Ele carrega os arquivos .kmdr e produz dinamicamente uma janela completamente funcional. +O executor, chamado kmdr-executor, roda os programas do &kommander;. Ele carrega os arquivos .kmdr e produz dinamicamente uma janela completamente funcional. -O Executor para os Programadores +O Executor para os Programadores -Os programadores de C++ podem usar facilmente a classe KmdrDialogInstance nos seus programas de C++ para que o recurso de execução seja incorporada no seu aplicativo, tornando obsoleta a necessidade de executar o programa externo. Para um diálogo padrão, a sobrecarga da criação do diálogo é mínima, mas a criação do aplicativo do &kde; poderá atrasar o diálogo durante cerca de um segundo. +Os programadores de C++ podem usar facilmente a classe KmdrDialogInstance nos seus programas de C++ para que o recurso de execução seja incorporada no seu aplicativo, tornando obsoleta a necessidade de executar o programa externo. Para um diálogo padrão, a sobrecarga da criação do diálogo é mínima, mas a criação do aplicativo do &kde; poderá atrasar o diálogo durante cerca de um segundo. -Criando um Diálogo +Criando um Diálogo - + -- cgit v1.2.1