# Trabalhar Com...

Este capítulo descreve as partes do &quantaplus; com as quais você irá interagir mais vezes. Estas não só o tornam mais produtivo, mas também lhe permitem personalizar o &quantaplus; de acordo com o seu ritmo de trabalho.

## Barras de Ferramentas

Como foi referido anteriormente, as barras de ferramentas no &quantaplus; são geridas em primeiro lugar no menu Barras de Ferramentas. A sua utilização e criação são feitas de forma diferente. A criação vai ser deixada para uma secção posterior chamada Criar Barras de Ferramentas.

A utilização das barras de ferramentas é muito simples. Carregue no ícone da 'tag' desejada para que aconteça uma de três possibilidades: o elemento é inserido (opcionalmente com um elemento de fecho) (p.ex. o elemento de negrito em HTML), é activada uma janela do elemento para que possa preencher as várias funcionalidades do mesmo e, por último, é activada uma acção que faça algo de útil no seu projecto ou ficheiro. Se você achar que está a fazer trabalho cansativo e redundante para um determinado elemento que não se encontre no &quantaplus;, então poderá adicioná-lo. Veja em dtep-intro-3-2 como obter mais informações.

A configuração das barras de ferramentas e dos elementos destas poderá ser feita com o menu de contexto (se carregar com o botão direito numa barra de ferramentas), onde poderá criar uma Nova Acção, uma Nova Barra de Ferramentas; poderá efectuar outras acções como Remover a Barra de Ferramentas, Mudar o Nome da Barra de Ferramentas ou Configurar as Barras de Ferramentas, a qual irá obter a janela, onde poderá indicar as acções que deverão estar visiveis nesta ou noutras barras de ferramentas.

Se invocar o menu de contexto numa acção (ícone) de uma barra de ferramentas, para além das acções acima, irá ver os itens Remover a Acção e Editar a Acção, que falam por si próprias.

As barras de ferramentas e as acções das mesmas poderão ser configuradas se usar a opção do menu Configuração Configurar as Barras de Ferramenta... e Configuração Configurar as Acções....

Poderá ler mais sobre as acções definidas pelo utilizador em user-actions.

Uma janela de 'tags' ou marcas assemelha-se à seguinte:

Um exemplo de uma janela de marca.

A imagem acima é a janela para as marcas de âncoras. Se você perceber de &HTML;/&XHTML;, então deverá já ter reparado que todos os atributos que você pode usar, num elemento de âncora, estão disponíveis. Repare nas páginas em cima para o Principal, Básico e i18n, Eventos e Foco; todas elas contêm os outros atributos, de acordo com o seu fim, que estão disponíveis para o elemento de âncora. Tudo o que você tem a fazer é: preencher os campos em branco para os atributos que deseja na sua âncora, omitir os atributos que não deseja e carregar em OK. A partir de agora passará a ter uma âncora configurada na posição actual do cursor.

&quanta-projects;

## Modelos

Os modelos não são mais do que documentos-esqueleto, pedaços de código e ficheiros com os quais fazer a associação. O &quanta; usa os modelos fundamentalmente como um sistema de ficheiros padrão com uma organização e interface melhorada. O utilizador poderá copiar, mover ou criar uma ligação a qualquer repositório do seu sistema para a árvore de modelos. Pense nos modelos do &quantaplus; como tendo, em sentido lato, as limitações à sua imaginação que o seu sistema de ficheiros tenha.

Os modelos existem em pastas aninhadas. Não existe nenhum limite de profundidade para a colocação dos modelos dentro de uma pasta; todavia, para qualquer pasta indicada, o &quantaplus; espera uma acção consistente para o tipo de modelo de base descrito em baixo. Para além disso, os modelos permitem concatenar o pré-texto e o pós-texto aos modelos que não tenham tipo definido de documento. Isto facilita a criação de marcas. A próxima actualização depois da introdução pretende adicionar a capacidade de passar variáveis ao texto, como por exemplo a informação do tamanho da imagem, de modo a assistir à criação das marcas.

O nosso objectivo em relação aos modelos é extendê-los de modo a incluir o conceito de modelos multi-ficheiro para as coisas do tipo "criar um pedido" ou a criação de uma secção "acerca". Idealmente, isto seria uma ferramenta para tornar o seu trabalho ainda mais produtivo e dinâmico. Um objectivo eventual será ter um modo de desenho estrutural dos modelos, o qual o utilizador poderia usar para desenhar e actualizar interactivamente os seus 'sites'. Se se quiser envolver, veja a nossa página de pedido de ajuda.

Alguns dos modelos que vêm com o &quantaplus; têm condições para a sua utilização. Veja com atenção as condições de utilização no topo de cada modelo antes de o usar.

### Tipos de Modelo

Existem vários tipos de modelos que são suportados pelo &quantaplus;. Estes são:

- Modelos binários
- Modelos de documentos
- Excertos de texto
- Modelos de 'sites'

Os exemplos para estes tipos são fornecidos com o &quantaplus;.

Modelos binários

- Os binários são tudo o que não é identificado de forma pura como texto. Poderão ser qualquer ficheiro, excepto de texto, o que inclui as imagens, &PDF;s, ficheiros de Flash, etc. Os modelos binários são normalmente incluídos no seu documento através de hiperligações (&ie; as imagens, como um `img src=/url/origem`). Alguns exemplos poderão ser encontrados na árvore de Modelos, nos Modelos Globais. Por favor veja o qit-3-2 para mais informações sobre a árvore de Modelos.

Modelos de documentos

- Os documentos poderão ser de qualquer tipo. Geralmente, o utilizador deverá querer associar os documentos mais específicos e diversos em subpastas. Aqui poderá criar uma arquitectura básica para o que faz e passá-la para o seu trabalho de uma forma organizada, para poder obter uma maior eficiência. Alguns exemplos poderão ser encontrados na árvore de Modelos, nos Modelos Globais. Por favor veja em qit-3-2 para mais informações sobre a árvore de Modelos.

Excertos de texto

- Este tipo de modelo é útil quando você não quer criar um novo documento com base num modelo, mas pretende introduzir a mesma área de texto em todo o lado nos seus documentos. Eles poderão conter de tudo, começando por um comentário e acabando mesmo num método de JavaScript de tratamento de menus ou um programa em Perl. Alguns exemplos poderão ser encontrados na árvore de Modelos, nos Modelos Globais. Por favor veja em qit-3-2 mais informações sobre a árvore de Modelos.

Modelos de 'sites'

- Como o nome indica, estes modelos são úteis para criar um 'site' inteiro a partir de um modelo. Estes são uma colecção de vários documentos que poderão estar organizados numa estrutura em pastas, estando tudo reunido num pacote TAR comprimido. Na altura em que este documento foi escrito, não existem modelos de 'sites' no &quantaplus;.

### Validade dos Modelos

Os modelos estão acessíveis de acordo com o seu espaço de trabalho estabelecido no &quantaplus;

### Criação de Modelos

#### Criação de modelos de documentos

Crie a estrutura do documento que desejar (&XML;, &HTML;, DocBook, &etc;.) e carregue em Ficheiro Gravar Como um Modelo Gravar Como um Modelo Local/do Projecto .

Logo que isso tenha sido feito, irá reparar que (mesmo que tenha sido gravado como um modelo do projecto), o modelo não aparece na página do projecto. Veja na página dos modelos do Projecto para o encontrar.

#### Criar excertos de texto

Seleccione algum texto no seu documento e carregue em Ficheiro Gravar Como um Modelo Gravar a Selecção Como um Ficheiro de Modelo Local/do Projecto . Em alternativa, poderá simplesmente usar o 'drag and drop' para arrastar a selecção para a árvore de Modelos.

#### Criar modelos binários

A criação de um modelo binário é simples: basta copiar o ficheiro para uma pasta de modelo. Você pode usar funções de gestão de ficheiros normais para o fazer, como o 'drag and drop' ou a cópia e colagem no Konqueror ou na Árvore de Ficheiros.

#### Criar modelos de 'sites'

Nas árvores de Ficheiros ou de Ficheiros do Projecto, carregue com o botão direito numa pasta e seleccione a opção Criar um Modelo do 'Site', escolha um nome para o modelo e grave-o. Por omissão, irá tentar gravar na pasta de modelos do projecto, mas obviamente poderá optar por gravá-lo também como um modelo local ou global.

### Utilizar Modelos nos Projectos

Os modelos dos projectos permitem-lhe estar focado mais estritamente. Poderá criar cabeçalhos, rodapés ou mesmo conteúdos dinâmicos ao fazer a inclusão de ficheiros de &PHP; e ligá-los. Para além disso, poderão existir algumas coisas interessantes a ter em consideração ao usar os modelos nos projectos.

Ao criar um projecto poderá optar por copiar todos os modelos locais e globais. Um projecto legado poderão obter as capacidades de modelos predefinidas, como tal nada se perde. Poderá escolher onde quer localizar os seus ficheiros de modelo, de modo a que possam estar na base do seu servidor, e poder-se-á tornar fácil enviar os ficheiros, mas também poderá torná-los seguros para se ligar à raiz do servidor em baixo, o que acaba por ser um truque útil. Ao ligar-se a um ficheiro que não conste nos modelos do projecto ser-lhe-á questionado se quer copiar o ficheiro para os modelos do projecto antes de efectuar a associação. Isto irá evitar as ligações quebradas no envio. O utilizador terá sempre o controlo onde coloca os seus modelos, por isso poderá optar por movê-los. O &quantaplus;, contudo, não regista isto, por isso terá de alterar as ligações.

### Gerir os Modelos

A estrutura dos modelos na página de modelos baseia-se nos ficheiros existentes nas pastas `$`KDEDIR`/share/apps/quanta/templates` e `$`HOME`/.kde/share/apps/quanta/templates`. Cada uma destas pastas corresponde a um dos tipos de gestão, tal como é explicado acima.

Para definir o comportamento de cada pasta, carregue com o &RMB; na janela dos modelos na respectiva pasta e carregue em Propriedades. Irá aparecer uma janela como a seguinte:

Janela de propriedades.

Tipo

- Uma lista com os três tipos definidos anteriormente: ficheiros, texto e modelo. Esta lista ficará desactivada se tiver assinalado a opção para Herdar as propriedades do pai.

Herdar atributo do pai (`foo`)

- Esta opção vem assinalada por omissão e é a óptima para todos as pastas, excepto a de topo, na sua árvore de modelos. Se a pasta de topo tiver esta opção assinalada, isto irá desactivar os modelos para essa pasta e para todas as que não estejam assinaladas para baixo. Se esta não for uma pasta de topo, então o `blá` irá indicar algo do género `Excerto de texto`. Se não disser nada, então é provável que esteja numa pasta do nível de topo.

Usar o texto prefixo/sufixo

- Permite usar o texto prefixo e sufixo nesta pasta. Este poderá ser um cabeçalho/rodapé comum para todos os seus modelos de um dado projecto e para que possa então copiar os modelos de conteúdo para essa pasta, de modo a ter uma página completa com o cabeçalho e rodapé personalizados como ponto de partida.

Texto prefixo:

- O texto a introduzir antes do seu conteúdo-modelo.

Texto sufixo:

- O texto a introduzir após o seu conteúdo-modelo.

Para além disso, se olhar para as opções do menu do &RMB;, irá ver as ferramentas completas de gestão de ficheiros para criar as pastas ou copiar e colar os modelos de um lado para o outro.

## Disposição Visual da Página

### Modos &VPL;

O editor da Disposição Visual da Página (&VPL;) (também conhecido por WYSIWYG (What You See Is What You Get) ) permite-lhe editar um documento de &HTML; ou &XHTML; enquanto observa as alterações na altura. Tal como acontece no seu processador de texto favorito, você poderá carregar no seu documento para aparecer um cursor, o que lhe permitirá introduzir texto, imagens, aplicar decorações de texto, &etc;. O intuito do &VPL; é permitir criar páginas Web impecáveis e válidas sem ter nenhum conhecimento de linguagens de formatação da Internet.

O &quantaplus; oferece dois modos: o Editor de &VPL; e o &VPL; & Editor de Código, os quais estão acessíveis no menu Ver. O primeiro substitui o Editor de Código com o Editor de &VPL; e o segundo divide a janela de edição em duas partes: o Editor de Código e o Editor de &VPL;.

O Editor de &VPL; funciona da seguinte maneira: Carrega um documento como uma página &HTML; ou &XHTML; normal e aparece um cursor. Aí, você poderá editá-lo e voltar ao Editor de Código; você poderá então ver que as alterações que fez no Editor de &VPL; foram reunidas com o Editor de Código.

Ao trabalhar no Editor de &VPL; com um documento que contenha &PHP;, você verá um pequeno ícone verde que representa o código de &PHP;. Você não o poderá editar directamente com o Editor de &VPL;. Para editar o &PHP;, você irá necessitar à mesma de usar o Editor de Código. Não existem planos para alterar esta funcionalidade.

O segundo modo comporta-se exactamente da mesma forma que o primeiro, excepto que você poderá ver imediatamente o impacto que as suas alterações terão feito, quer no Editor de Código quer no Editor de &VPL;; para além disso, os cursores do editor de código e do Editor de &VPL; estão sincronizados. Se carregar em F9 carrega este modo mas, se já estiver carregado, irá passar o primeiro plano de uma vista para a outra, enquanto que fica na mesma localização do documento.

Os intervalos de actualização entre o Editor de &VPL; e o Editor de Código são configuráveis. Vá a Configuração Configurar o Quanta... . Seleccione a página Vista &VPL;. Aí poderá escolher se deseja actualizar uma das vistas só quando carregar nela ou se o quer automaticamente. Se optar pelo modo automático, então poderá definir um intervalo de actualização. A recomendação geral é: Um valor baixo para os computadores rápidos e um valor mais elevado para os computadores mais lentos.

O modo de Editor de &VPL; & Editores de Código.

### Edição &VPL;

#### A Janela Propriedades do Documento

Agora, imagine-se que você deseja editar o título da sua página Web. Como é que faz isso? Basta carregar em Ferramentas Propriedades do Documento . Esta ferramenta permite a edição das marcas invisíveis ao usar o Editor de &VPL;. A janela de Propriedades do Documento também é lançada quando você cria um novo documento enquanto permanece no Editor de &VPL;. Isto serve para reduzir a quantidade de código escrito à mão necessário para definir essa propriedade. Com isto, você poderá editar:

Título

- O título do documento.

Meta itens

- As meta-marcas ou 'meta-tags' permitem-lhe guardar informações acerca do documento em si ⪚ as palavras-chave para os motores de busca da Internet. Você poderá adicionar ou remover os Meta-itens ao carregar nos dois botões em baixo, e editá-los na lista, ⪚, pondo as palavras-chave no campo do nome e a palavra-chave1 palavra-chave2 na coluna de conteúdo.

Regras CSS

- As Regras de CSS são a única forma de indicar ao seu navegador Web como apresentar a página. Você poderá adicionar ou remover as Regras de CSS ao carregar nos botões em baixo. Você também poderá preencher os campos da mesma forma que os Meta-itens. A edição das Regras do CSS ainda não é suportada.

Ligar Folha de Estilo CSS

- Você poderá também associar ou ligar uma folha de estilo ('stylesheet') CSS externa. Basta carregar no botão Escolher e seleccionar o seu ficheiro.

#### O Editor &VPL;

Você poderá usar o seu cursor como num processador de texto, movendo-o com as teclas correspondentes. Poderá acontecer que o cursor não queira ir para onde você deseja (um erro chato). A selecção também funciona de forma normal. Você poderá introduzir texto se o escrever ou removê-lo se carregar nas teclas &Backspace; ou Delete.

Agora vamos para a introdução de marcas. Você poderá introduzir imagens, 'applets', decorações do texto como negrito ou itálico, e assim por diante, se usar as mesmas barras de ferramentas que utiliza no editor de código. Repare que a introdução de marcas não remove as marcas idênticas anteriores, ⪚ se introduzir uma âncora à volta de determinado texto, então você terá de remover as outras âncoras à volta do mesmo.

Alguns dos itens da barra de ferramentas irão estar desactivados, como o Assistente de Tabelas ou o Assistente de Listas Rápido. Eles irão funcionar mais tarde na &VPL;, mas, para esta versão, você deverá usar as barras de Tabelas ou de Listas.

Para editar uma marca (seja ela uma imagem, uma 'applet' ou o que for), mude para a Árvore de Atributos, a qual está acessível através da opção Ver Vistas em árvore . Carregue na marca que deseja editar ou, se não lhe conseguir aceder, carregue num objecto que esta contenha. A Árvore de Atributos irá mostrar o nome da marca actual, assim como uma lista de todos os seus elementos-pais e atributos. De momento, o &VPL; não suporta, por exemplo, o &XHTML;+MathML, mas você verá que pode editar os espaços de nomes com esta janela. Basta você carregar no campo Valor e modificar o que quiser. Se quiser aceder a um elemento-pai da marca actual, então seleccione-o para que a Árvore de Atributos o carregue.

Para remover uma marca, nós iremos usar a Árvore de Atributos. Já reparou nas duas pequenas cruzes vermelhas no canto superior direito? A primeira apaga apenas a marca seleccionada e, se a especificação de &HTML;/&XHTML; não permitir que alguns dos filhos da marca a ser removida possam pertencer aos pais da mesma, então estes filhos serão removidos também, e assim por diante. A segunda cruz irá remover a marca seleccionada e todos os seus filhos, por isso tenha cuidado!