Ferramentas de Construção

Compilar, converter e visualizar
Para ver o resultado do seu trabalho, você precisa primeiro compilar o código. Todas as ferramentas de compilação estão agrupadas nos menus Criar Compilar, Criar Converter e Criar Exibir.
Para compilar o seu código-fonte para os visualizadores como o ou outras conversões, você poderá usar o atalho 2. Aí, poderá ver o arquivo com o seu visualizador padrão com o 3, converter o para um arquivo PS com o 4 e ver o arquivo PS com o 5.

BibTEX
Se estiver usando o BibTEX para os seus elementos bibliográficos, terá normalmente que seguir um esquema de compilação especial. Isto significa a invocação do LATEX, do BibTEX e depois do LATEX de novo. Felizmente, o Kile é suficientemente inteligente para detectar automaticamente se é necessário invocar as ferramentas adicionais, como o BibTEX, o makeidx e o Asymptote. Essa lógica está ativada por padrão e poderá ser modificada na opção Configurações Configurar o Kile... Ferramentas Compilação da página Geral das ferramentas LATEX e PDFLATEX.

MetaPost e o Asymptote
Se você quiser compilar o seu documento com o MetaPost ou o Asymptote, os programas de desenho de imagens, poderá fazer isso com a opção Criar Compilar Metapost ou Criar Compilar Asymptote.

PDFLATEX
Existe também outra forma de compilar o seu documento, se quiser um PDF: você poderá executar o PDFLATEX, que irá compilar o código diretamente para um arquivo PDF, com o 6: poderá então ver o arquivo compilado se pressionar 7.
Em alternativa, poderá converter um PS num PDF com o 8 ou um diretamente para um PDF com o 9.
Usar o PDFLATEX em substituição ao LATEX, pode ser uma questão de simplicidade ou hábito, mas em algumas ocasiões, o comportamento dos dois programas poderá ser diferente.

O LATEX para a Web
Finalmente, você poderá querer publicar o seu trabalho na Web e não apenas no papel. Poderá então, neste caso, usar o programa latex2html, que poderá ser invocado a partir do menu do Kile em Criar Converter LaTeX para Web. O resultado será colocado numa subpasta da pasta de trabalho, sendo para você possível ver o resultado da conversão com o item Criar Ver Ver o .

Passando parâmetros da linha de comando
Se você quiser passar alguns parâmetros específicos da linha de comando para as ferramentas de compilação, conversão ou visualização, poderá configurar as invocações das mesmas em Configurações Configurar o Kile... Ferramentas Compilar.

Previsão Rápida
Quando trabalhar com LATEX, você sempre precisará de algum tempo para ver o resultado. O LATEX precisa compilar o código e o visualizador terá que ser invocado. Isso pode ser incômodo, caso tenha alterado apenas algumas letras de uma equação, o que é difícil de escrever. O Kile oferece agora um modo de Previsão Rápida, onde poderá compilar apenas uma parte de um documento e poupar bastante tempo. Ele tem suporte a quatro modos diferentes, que poderão ser combinados com sete configurações.
Previsão Rápida
Previsão Rápida
Todas as configurações deverão ser feitas em Configurações Configurar o Kile... Ferramentas Previsão.
Configuração da Previsão Rápida
Configuração da Previsão Rápida

Modo de Seleção
O usuário terá que selecionar uma parte do documento. O item do menu Compilar Previsão Rápida Seleção ou o atalho de teclado P,S irá iniciar os programas selecionados. O Kile usa o preâmbulo do texto original, de modo que todos os pacotes e os comandos definidos pelo usuário serão incluídos. O usuário poderá então escolher uma das oito configurações predefinidas:
LaTeX+ (visualizador incorporado)
LaTeX+ ()
LaTeX+PS (visualizador incorporado)
LaTeX+PS ()
PDFLaTeX+PDF (visualizador incorporado)
PDFLaTeX+PDF ()
XeLaTeX+PDF (visualizador incorporado)
XeLaTeX+PDF ()
Isto deve ser suficiente para todas as situações necessárias numa previsão rápida.

Modo do Ambiente
Muitas das vezes, você poderá querer antever o ambiente atual. Especialmente no caso de ambientes matemáticos, o que poderá ser difícil de escrever. O Kile oferece uma forma muito rápida para o fazer. Não é necessária qualquer seleção, bastando para tal escolher Compilar Previsão Rápida Ambiente ou o atalho de teclado P,E, para que o ambiente atual seja compilado e apresentado.

Modo de subdocumento
Também é frequente que você tenha projetos com vários documentos. Compilar todo o projeto não será uma boa ideia, caso tenha feito alterações em apenas um único documento. O Kile será capaz de compilar e mostrar uma previsão do subdocumento atual. Ele retira o preâmbulo de um documento-mestre definido e compila apenas esta parte, quando você escolher a opção Compilar Previsão Rápida Subdocumento ou o atalho de teclado P,D.

Modo de Grupo Matemático
O modo de previsão do grupo matemático permite-lhe antever o grupo matemático que está editando no momento. O Kile obtém o preâmbulo do documento-mestre e só compila o grupo matemático sobre o qual o cursor se encontra, quando escolher o Construir Previsão Rápida Grupo Matemático ou escolher o atalho de teclado P,M.

Previsão Rápida na barra inferior
Em vez de mostrar a previsão num documento novo, o Kile poderá também ser configurado para usar a barra inferior para as compilações da previsão. Você poderá ativar essa funcionalidade no painel de configuração da previsão rápida.

Formatos de Arquivos Gráficos

LATEX e PDFLATEX
O PDFLATEX, quando for usado com os pacotes graphics ou o graphicx, poderá compilar corretamente os arquivos PNG e JPG num ou PDF, mas não é capaz de lidar com arquivos EPS. Por outro lado, o processo de compilação para um e a conversão para PS e, eventualmente, PDF suporta os EPS, mas não os arquivos PNG e JPG.
Diversos usuários desejam criar documentos PDF mas, por exemplo, aproveitam o excelente pacote Pstricks para criar imagens ; ou, por outro lado, desejam usar o resultado em do software matemático/científico, como o Mathematica, o Maple ou o MuPAD. Esses usuários de LATEX têm que selecionar o formato , mesmo que desejem criar documentos PDF, uma vez que esses programas produzem código que não pode ser gerido pelo PDFLATEX. Todavia, não é assim tão complicado como parece, uma vez que o Kile irá ajudar.

Conversão de imagens
Para superar esse ciclo frustrante, quando desejar incluir tanto o código em como os arquivos PNG ou JPG, você tem um conjunto de soluções alternativas:
Se necessitar de um arquivo no formato PS, mas se tiver imagens JPG ou PNG, poderá também usar simplesmente o PDFLATEX com o resultado em e depois usar a instrução da linha de comando dvips. Irá ver que o PDFLATEX é uma escolha muito boa, se o seu código não tiver qualquer código em .
Você poderá converter os arquivos EPS para PNG ou outros formatos com alguns utilitários como o Gimp ou o ImageMagick e usar o PDFLATEX.
Uma das formas preferidas é converter as imagens EPS para imagens PDF com o epstopdf, que vem com cada distribuição do TEX e então usar o PDFLATEX. Ele produz imagens de alta qualidade e você poderá até controlar o resultado com algumas das opções seguintes:

-dAutoFilterColorImages=false
        -dAutoFilterGrayImages=false
        -sColorImageFilter=FlateEncode
        -sGrayImageFilter=FlateEncode
        -dPDFSETTINGS=/prepress
        -dUseFlateCompression=true

Melhor ainda: se o seu sistema permitir o shell-escape, a conversão poderá ser feita em tempo real. Tudo o que terá que fazer é incluir o pacote epstopdf, que faz parte de todas as distribuições do TEX, com o comando \usepackage{epstopdf}. Assumindo que o seu código é

        \includegraphics[width=5cm]{teste.eps}

Ao executar o PDFLATEX com a opção pdflatex --shell-input, a imagem teste.eps é convertida automaticamente para teste.pdf.
Essa conversão irá ocorrer cada vez que você executar o PDFLATEX. Se o seu comando gráfico é dado implicitamente

        \includegraphics[width=5cm]{teste}

, o epstopdf verifica se o teste.pdf já está disponível, de modo que o passo de conversão poderá ser ignorado.
Você poderá converter da forma inversa e usar o LATEX e a conversão PS-PDF; esta nem sempre é uma boa ideia, uma vez que o encapsulamento em EPS dos JPGs ou PNGs poderá criar arquivos maiores, que por sua vez geram documentos desnecessariamente grandes; isto é, contudo, altamente dependente do utilitário gráfico que usar, dado que o EPS pode encapsular outros gráficos, mas nem todos os aplicativos tem suporte adequado a isto; alguns poderão, de fato, tentar criar a sua imagem JPG com vetores e programação diversa, o que irá resultar em arquivos enormes. A conversão de todos os formatos gráficos para EPS poderá ser conseguida com o ImageMagick. Outro programa simples que faz este processo corretamente é o jpg2ps.
Você poderá também usar uma forma automática de conversão. Todos os arquivos gráficos são convertidos na compilação para EPS e inseridos no documento PS. Esta é uma forma confortável, mas o usuário terá que configurar o seu sistema convenientemente. Isso é discutido na seção das Imagens EPS.

Use o arquivo correto para a imagem correta
EPS é uma espécie de linguagem de scripts para criação de gráficos vetoriais, que descreve todas as linhas e pontos que constituem o gráfico; parece muito bom, mesmo quando é ampliado além do seu tamanho padrão, e se adapta bem a diagramas e imagens vetoriais produzidas nativamente em EPS, parecendo bastante claro e definido e mantendo ainda um tamanho de arquivo bastante pequeno.
PNG (ou o obsoleto ) é um formato de arquivo sem perdas, com boa compressão e qualidade. É muito bom para diagramas, digitalização de desenhos ou todo o tipo de imagem em que queira manter a definição. Ele pode se tornar um exagero quando usado para fotos.
JPG é um formato com perdas, que comprime melhor os arquivos do que o PNG, mas perde alguns detalhes das imagens. Isso é normalmente irrelevante para fotos, mas poderá causar uma má qualidade para diagramas, desenhos e poderá fazer com que algumas linhas finas desapareçam. Nesses casos, use os formatos EPS ou PNG.
Mas lembre-se sempre: entra lixo, sai lixo! Não há nenhuma conversão que transforme uma imagem ruim em boa.

Imagens EPS
Os arquivos gráficos EPS são a forma tradicional de inserir arquivos gráficos em documentos do LATEX. Uma vez que as listas de correio estão cheias de dúvidas no que diz respeito às imagens EPS, serão discutidos alguns aspectos importantes e será demonstrada a forma como o Kile irá suportar essa tarefa.

O LATEX e as imagens EPS
Se você optou por usar o LATEX tradicional para produzir resultados em PS ou PDF, é provável que tenha alguns problemas com as imagens. Será preciso usar imagens EPS (Encapsulated ) e não arquivos JPEG ou PNG. Isso não deverá ser um problema, pois existem vários conversores, como o convert, do excelente pacote ImageMagick. Contudo, é necessário algum tempo, obviamente.
Os arquivos EPS são usados tanto pelo LATEX como pelos conversores -PS:
O LATEX procura no arquivo EPS pela linha da caixa envolvente, a qual indica ao LATEX quanto espaço deverá reservar para a imagem.
O conversor -PS lê então o arquivo EPS e insere a imagem no arquivo PS.
Isso tem algumas implicações:
O LATEX nunca lê o arquivo EPS se os parâmetros da caixa envolvente forem indicados no comando de inserção da imagem.
Uma vez que o LATEX não consegue ler arquivos que não sejam ASCII, ele não consegue ler a informação da caixa envolvente a partir de arquivos comprimidos ou que não sejam EPS.
As imagens EPS não são incluídas no arquivo . Uma vez que os arquivos EPS deverão estar presentes quando o arquivo for convertido para PS, os arquivos EPS deverão acompanhar os arquivos , sempre que estes forem movidos.
Agora você poderá invocar o LATEX, e um conversor -PS como o dvips para criar o seu documento em . Se o seu objetivo for um documento PDF, deverá executar o dvips com a opção -Ppdf e depois executar o ps2pdf. Você irá encontrar vários documentos que descrevem esta solução.

Formato do Kile
O Kile ajuda-o a obter a informação da Caixa Envolvente. Se você tiver instalado o ImageMagick, o Kile irá extrair essa informação do arquivo EPS e inseri-la como uma opção. Isto é feito automaticamente, quando você selecionar o arquivo de imagem. Existem duas vantagens desse procedimento:
A informação já está extraída na janela e não é preciso fazer isso de novo pelo LATEX.
Ainda mais importante é também o fato de a largura e a altura da imagem poderem ser calculadas, quando a resolução da imagem for conhecida. Essa informação será apresentada perto do topo da janela e poderá servir como uma pista, sempre que o usuário desejar dimensionar as imagens.
O Kile poderá também suportar arquivos EPS comprimidos com o 'zip' ou 'gzip', os quais são muito menores que os arquivos EPS não comprimidos. Contudo, essa funcionalidade só poderá ser usada com uma configuração especial do sistema e com uma alteração na sua configuração local de imagens, como descrito na seção Imagens Rasterizadas.

Formato e as Imagens Rasterizadas
Se o seu sistema permitir o shell-escape, o Kile também suporta uma forma simples de incluir imagens rasterizadas, se você configurar o seu sistema TEX convenientemente. Não há necessidade de converter as imagens JPEG ou PNG, sendo que isto pode ser feito automaticamente quando o arquivo for convertido para PS.
O LATEX precisa de algumas informações sobre os sufixos de arquivos. O pacote graphicx irá procurar por um arquivo graphics.cfg, que deverá estar em algum lugar no seus locais de procura de documentos LATEX. Procure por itens como estes:

\DeclareGraphicsRule{.pz}{eps}{.bb}{}%
   \DeclareGraphicsRule{.eps.Z}{eps}{.eps.bb}{}%
   \DeclareGraphicsRule{.ps.Z}{eps}{.ps.bb}{}%
   \DeclareGraphicsRule{.ps.gz}{eps}{.ps.bb}{}%
   \DeclareGraphicsRule{.eps.gz}{eps}{.eps.bb}{}%

e substitua essas linhas por:

\DeclareGraphicsRule{.pz}{eps}{.bb}{}%
   \DeclareGraphicsRule{.eps.Z}{eps}{.eps.bb}{}%
   \DeclareGraphicsRule{.ps.Z}{eps}{.ps.bb}{}%
   \DeclareGraphicsRule{.ps.gz}{eps}{.ps.bb}{}%
   % changed or new graphic rules
   \DeclareGraphicsRule{.eps.zip}{eps}{.eps.bb}{`unzip -p #1}%   zipped EPS
   \DeclareGraphicsRule{.eps.gz}{eps}{.eps.bb}{`gunzip -c #1}%   gzipped EPS
   \DeclareGraphicsRule{.jpg}{eps}{}{`convert #1 eps:-}%         JPEG
   \DeclareGraphicsRule{.gif}{eps}{.bb}{`convert #1 eps:-}%      GIF
   \DeclareGraphicsRule{.png}{eps}{.bb}{`convert #1 eps:-}%      PNG
   \DeclareGraphicsRule{.tif}{eps}{.bb}{`convert #1 eps:-}%      TIFF
   \DeclareGraphicsRule{.pdf}{eps}{.bb}{`convert #1 eps:-}%      PDF-graphics

No Debian, por exemplo, você encontrará esse arquivo em /etc/texmf/latex/graphics.cfg. A melhor forma de proceder é copiar este arquivo para o caminho do seu 'tex' e então alterar essa cópia. Veja o manual do TEX da sua distribuição para saber como obter uma lista das suas pastas do TEX.
Com este arquivo de configuração, você poderá ser capaz de inserir imagens rasterizados e EPS comprimidos no LATEX. O comando de conversão é dado pelo dvips. Quando você olhar para o comando de conversão, irá ver que não será criado qualquer arquivo extra. O resultado do processo de conversão é diretamente encaminhado para o arquivo PS. A única coisa que o LATEX precisa saber é o tamanho da imagem e, como tal, é necessária a Caixa Envolvente, que é fornecida pelo Kile.
Algumas pessoas dizem que essa forma é insegura; você precisa decidir como irá funcionar. Em qualquer um dos casos, não será necessária a caixa envolvente, uma vez que o Kile irá extrair essa informação de todos os tipos de imagens.

O PDFLATEX e as imagens EPS
Como já foi dito, o PDFLATEX não é capaz de lidar com arquivos EPS, mas os conversores, como o epstopdf poderão ajudar. A melhor forma é incluir o pacote epstopdf, o que deverá ser feito após carregar o pacote graphicx.

\usepackage[pdftex]{graphicx}
   \usepackage{epstopdf}

Agora você já pode incluir imagens EPS, se executar o pdflatex com a opção --shell-escape. Mas poderemos fazer ainda melhor e lidar também com arquivos EPS comprimidos com o 'zip' e o 'gzip'. Mais uma vez, você terá que alterar o arquivo de configuração de imagens graphics.cfg, como descrito acima. Dessa vez, o texto a procurar será:

% pdfTeX is running in pdf mode
   \ExecuteOptions{pdftex}%

e simplesmente adicione algumas linhas:

% pdfTeX is running in pdf mode
   \ExecuteOptions{pdftex}%
   \AtEndOfPackage{%
      \g@addto@macro\Gin@extensions{.eps.gz,.eps.zip}%
      \@namedef{Gin@rule@.eps.gz}#1{{pdf}{.pdf}{`gunzip -c #1 | epstopdf -f 
>\Gin@base.pdf}}%
      \@namedef{Gin@rule@.eps.zip}#1{{pdf}{.pdf}{`unzip -p #1 | epstopdf -f 
>\Gin@base.pdf}}%
   }%

Com essas linhas, o PDFLATEX será capaz de lidar com arquivos EPS e, provavelmente, não existirão mais dúvidas em relação a imagens.

Documento mestre
Definir o seu documento como mestre permite-lhe trabalhar com arquivos separados, o que lhe concede um documento-pai (ou documento-mestre) e os documentos-filhos, compondo assim um trabalho completo. Depois de ter definido o seu documento-mestre, com o comando respectivo no menu Configurações, todos os comandos do menu Ferramentas serão aplicadas apenas a esse documento, mesmo que esteja lidando com os documentos-filhos. Você poderá até fechar o documento mestre.

Tratamento de erros
Depois de ter compilado algo, o Kile verifica as mensagens de erros que foram geradas. Se existirem alguns erros ou avisos, eles serão mostrados brevemente na janela de Registro e Mensagens. Você pode dar uma olhada com atenção às mensagens ao selecionar a opção Criar Visualizar o arquivo de registro ou usando o atalho de teclado 0. O registro gerado é então apresentado na janela de Registro e mensagens; os erros e os avisos ficam então realçados.
Visualizando o registro
Visualizando o registro
Visualizando o registro
Você poderá saltar facilmente de uma mensagem no arquivo de registro para outra com as opções Criar Aviso / Erro de LaTeX Anterior / Seguinte ou usando os botões correspondentes na barra de ferramentas.
Para saltar para a linha do arquivo de LATEX onde ocorreu o erro ou o aviso, clique neste na janela de Log e mensagens. O Kile irá levá-lo automaticamente para a linha correspondente.

Modo Visão de Arquivo
Quando invocar a Construção Rápida, irá aparecer um visualizador depois da compilação. Se você não estiver usando um visualizador incorporado, será aberta uma nova janela de cada vez.
Se você estiver ajustando a aparência do seu documento, poderá invocar a Construção Rápida com bastante frequência e ter várias janelas de visualização abertas na sua tela; para evitar esta confusão, poderá ativar o modo Visão de Arquivo, o que irá evitar que a Construção Rápida lance um visualizador.
Esse modo é obviamente inútil com os visualizadores incorporados, uma vez que você deve ainda fechá-los antes de voltar a editar o documento e a recompilar.