# 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: a 'tag' é inserida (opcionalmente com uma 'tag' de fecho) (p.ex. a 'tag' de negrito em HTML), é activa uma janela da 'tag' para que possa preencher as várias funcionalidades da mesma (p.ex., a 'tag' de âncora de HTML) e, por último, é activada uma acção que faça algo de útil no seu projecto/ficheiro/o que for. 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.

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 &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 'tags'. 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 'tags'.

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

Neste momento, os modelos estão limitados a ser de um dos seguintes tipos de objectos:

- Documento
- Texto a inserir num documento
- Um ficheiro a ligar de forma a criar um documento

Os documentos poderão ser de qualquer tipo. Geralmente, o utilizador deverá querer associar os documentos mais específicos e diversos em sub-pastas. 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. A introdução de texto poderá ser desde um excerto de código até o que quiser utilizar. Isto sobrepõe-se à capacidade de introduzir blocos de texto como uma acção despoletada a partir da barra de ferramentas. Os ficheiros associados poderão ser binários, bibliotecas de classes de &PHP; ou o que se desejar.

### 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

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.

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.

### 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 o Comportamento dos 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:

ficheiros/tudo

- os binários e todos os itens que são introduzidos através do seu &URL; (p.ex., as imagens num `img src=/src/url`).

texto/tudo

- O texto que pode introduzir no documento actual do &quantaplus;, como por exemplo blocos repetitivos.

modelos/tudo

- Os modelos de documentos a partir dos quais poderá criar novos documentos. Estes criam uma nova janela no &quantaplus;.

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 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 `blah` irá indicar algo do género `text/all`. 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.

## 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; & 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!