%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Contents: Things you need to know
% $Id: things.tex 9927 2011-05-20 15:19:46Z ambs $
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
\chapter{Coisas Que Precisa de Saber}
\begin{intro}
Na primeira parte deste capítulo, será apresentada uma visão geral
sobre a filosofia e história do \LaTeXe. A segunda parte foca as
estruturas básicas de um documento \LaTeX. Depois de ler este
capítulo, terá uma ideia geral de como o \LaTeX{} funciona. O seu
principal objectivo é ajudar a integrar toda a informação que é
dada nos capítulos seguintes.
\end{intro}

\section{O Nome do Jogo}
\subsection{\TeX}
 
O \TeX{} é um programa de computador criado por \index{Knuth, Donald
E.}Donald E. Knuth \cite{texbook}. É devoto à tipografia de texto e
fórmulas matemáticas. O motor tipográfico começou a ser escrito em
1977 para explorar os potenciais de equipamento digital de impressão
que estava a infiltrar na indústria de publicação naquele tempo,
especialmente na esperança de poder alterar o rumo da deterioração de
qualidade tipográfica que ele viu a afectar os seus próprios livros e
artigos. Tal como o usamos hoje, o \TeX{} foi disponibilizado em 1982
com pequenos melhoramentos adicionados em 1989 para suportar da melhor
forma os caracteres de 8-bits, e múltiplas linguagens. Tem recebido
muitos elogios por ser extremamente estável, funcionar em muitos tipos
diferentes de computadores, e virtualmente não ter qualquer
\textit{bug}. A versão do \TeX{} está a convergir para $\pi$ e de
momento é $3.141592653$.

Pronunciamos \TeX{} como ``Tech,'' com um ``ch'' idêntico à palavra
alemã ``Ach''\footnote{Em alemão existem na verdade duas formas de
  pronunciar ``ch'' e devemos assumir que a forma mais macia como se
  usa para ``Pech'' é a mais apropriada. Depois de alguém perguntar ao
  Knuth sobre isto, ele escreveu na Wikipedia alemã: \emph{Eu não fico
    zangado quando as pessoas pronunciam \TeX{} da sua forma
    favorita\ldots{} e em alemão muitos usam uma forma leve de ``ch''
    porque o X segue a vogal e, e não a forma brusca que segue a vogal
    a.  Na Rússia, `tex' é uma palavra muito comum, pronunciada
    `tyekh'. Mas acredito que a forma mais correcta de pronunciar é
    ouvida na Grécia, onde existe a forma mais áspera de ch como ach e
    Loch.}}  ou à escocesa ``Loch.'' O ``ch'' teve origem no alfabeto
grego onde o X é a letra ``ch'' ou ``chi''. \TeX{} também é a primeira
sílaba da palavra grega {\greektext texnolog'ia} (tecnologia).  Em
ambientes ASCII, \TeX{} deve ser escrito como \texttt{TeX}.
                                                                       
\subsection{\LaTeX}

O \LaTeX{} permite aos autores preparar e imprimir o seu trabalho ao
mais alto nível de qualidade tipográfica, usando um modelo
profissional pré-definido. O \LaTeX{} foi escrito originalmente pelo
\index{Lamport, Leslie}Leslie Lamport~\cite{manual}. Usa o formatador
do \TeX{} como motor tipográfico. Actualmente, o \LaTeX{} é mantido
por \index{Mittelbach, Frank}Frank Mittelbach.


%In 1994 the \LaTeX{} package was updated by the \index{LaTeX3@\LaTeX
%  3}\LaTeX 3 team, led by \index{Mittelbach, Frank}Frank Mittelbach,
%to include some long-requested improvements, and to re\-unify all the
%patched versions which had cropped up since the release of
%\index{LaTeX 2.09@\LaTeX{} 2.09}\LaTeX{} 2.09 some years earlier. To
%distinguish the new version from the old, it is called \index{LaTeX
%2e@\LaTeXe}\LaTeXe. This documentation deals with \LaTeXe. These days you
%might be hard pressed to find the venerable \LaTeX{} 2.09 installed
%anywhere.

\LaTeX{} é pronunciado  ``Lay-tech'' ou ``Lah-tech.'' Se se referir ao
\LaTeX{} num ambiente  ASCII, deve escrever \texttt{LaTeX}.
\LaTeXe{} é pronunciado ``Lay-tech two e'' e escrito \texttt{LaTeX2e}.

%A figura~\ref{components} acima % on page \pageref{components} 
%mostra como o \TeX{} e o \LaTeXe{} trabalham juntos. Esta figura foi retirada
%do documento \texttt{wots.tex} escrito por Kees van der Laan.

%\begin{figure}[btp]
%\begin{lined}{0.8\textwidth}
%\begin{center}
%\input{kees.fig}
%\end{center}
%\end{lined}
%\caption{Componentes de um sistema \TeX{}.} \label{components}
%\end{figure}

\section{Bases}
 
\subsection{Autor, Paginadores e Tipógrafo}

Para publicar alguma coisa, os autores dão um manuscrito
dactilografado à companhia de publicação. Um dos seus paginadores
decide o formato do documento (largura da coluna, tipos de letra,
espaços antes e após os cabeçalhos,~\ldots). Este escreve as suas
instruções no manuscrito, que é entregue ao tipógrafo que imprime o
livro de acordo com estas instruções.

Um paginador humano tenta imaginar o que o autor tinha em mente
enquanto escrevia o manuscrito. Tem de decidir os cabeçalhos de
capítulos, exemplos, fórmulas, etc.\ baseado nos seus conhecimentos
profissionais e no conteúdo do manuscrito.

Num ambiente \LaTeX{}, o paginador é o \LaTeX, que usa o \TeX{} como
seu tipógrafo. Mas o \LaTeX{} é ``apenas'' um programa e portanto
precisa de algum apoio. O autor tem de dar informação adicional
descrevendo a estrutura lógica do seu trabalho. Esta informação é
escrita no texto como ``comandos \LaTeX{}.''

Esta é uma grande diferença da abordagem \wi{WYSIWYG}\footnote{What
  you see is what you get --- O que vês é o que recebes.} que a maior
parte dos processadores de texto modernos, tais como o \emph{Microsoft
  Word} ou \emph{LibreOffice}, usam. Com estas aplicações, os autores
especificam o formato do documento de uma forma interactiva enquanto
vão escrevendo o texto no computador. Durante esse processo, podem ver
no ecrã como o resultado final vai aparecer quando impresso.

Ao usar o \LaTeX{}, normalmente não é possível ver o resultado final
enquanto se digita o texto. No entanto, o resultado final pode ser
pré-visualizado no ecrã depois de processar o ficheiro com o
\LaTeX. Então, podem ser feitas correcções para enviar posteriormente
o documento para a impressora.

\subsection{Desenho do Formato}

O desenho relacionado com a tipografia é bastante trabalhoso. Autores
não qualificados cometem frequentemente erros sérios de formatação
assumindo que o desenho de livros é, na sua maior parte, uma questão
estética --- ``Se um documento é artisticamente bonito, então está bem
desenhado.'' Mas, como um documento tem de ler lido e não pendurado
numa galeria de pinturas, a leitura e compreensão é de muito maior
importância do que a sua forma.  Exemplos:
\begin{itemize}
\item O tamanho e a numeração dos cabeçalhos devem ser escolhidos 
  para fazer a estrutura de capítulos e secções clara ao leitor.
\item O comprimento das linhas tem de ser suficientemente curto para
não fazer o leitor trocar os olhos, mas suficientemente longo para
preencher uma página de uma forma esteticamente bela.
\end{itemize}

Com sistemas \wi{WYSIWYG}, os autores criam documentos esteticamente
agradáveis sem estrutura, ou em que esta se apresenta de uma forma
inconsistente.  O \LaTeX{} previne este tipo de erros de formatação ao
obrigar os autores a declarar a estrutura \emph{lógica} do seu
documento, escolhendo depois o formato mais adequado.

\subsection{Vantagens e Desvantagens}

Quando as pessoas do mundo \wi{WYSIWYG} conhecem pessoas que usam
\LaTeX{}, frequentemente discutem ``as \wi{vantagens do \LaTeX{}} em
relação a um processador de texto normal'' ou o contrário. A melhor
coisa que se pode fazer quando uma discussão inicia é manter a calma,
porque este tipo de discussões saem facilmente dos limites. Mas por
vezes não se pode escapar\ldots

\medskip\noindent Então, aqui estão algumas munições. As principais
vantagens do \LaTeX{} sobre um processador de texto ``normal'' são as
seguintes:

\begin{itemize}
  
\item Formatos criados profissionalmente estão disponíveis, que fazem
  com que um documento pareça realmente impresso numa tipografia;

\item A escrita de fórmulas matemáticas é suportada de uma forma conveniente;

\item O utilizador apenas precisa de aprender uma dúzia de comandos facilmente
  compreensíveis que especificam a estrutura lógica de um documento. Quase nunca
  se precisa de atormentar com o formato real do documento;

\item Até estruturas complexas, tais como notas de rodapé, referências,
  tabelas de conteúdos e bibliografias podem ser facilmente geradas;

\item Pacotes gratuitos podem ser aplicados a tarefas tipográficas não
  suportadas pelo \LaTeX{} básico. Por exemplo, existem pacotes para incluir
  gráficos \PSi{} e para imprimir bibliografias conforme os
  \textit{standards}. Muitos destes pacotes estão descritos no \companion;

\item O \LaTeX{} encoraja os autores a escrever textos bem estruturados
  porque é assim que o \LaTeX{} funciona --- especificando a estrutura;

\item \TeX, o motor de formatação do \LaTeXe, é extremamente portável e
  livre. Desta forma, o sistema funciona em quase todas as plataformas de
  \textit{hardware} existentes.

%
% Add examples ...
%
\end{itemize}

\medskip

\noindent O \LaTeX{} também tem algumas desvantagens, e penso que é um pouco 
difícil para mim encontrar alguma, mas parece-me que outras pessoas podem
indicar centenas \texttt{;-)}

\begin{itemize}
\item \LaTeX{} não funciona bem para pessoas que tenham vendido a sua alma\ldots

\item Apesar de alguns parâmetros poderem ser ajustados num formato pré-definido,
  o desenho de todo um novo formato é difícil e demora muito tempo
  \footnote{Rumores dizem que este é um dos pontos chave a ser abordado
    na versão 3 do \LaTeX.}\index{LaTeX3@\LaTeX 3}

\item É difícil de escrever documentos mal estruturados e desorganizados;

\item Embora o seu hamster demonstre alguma dedicação durante os
  primeiros passos, nunca conseguirá digerir completamente o conceito
  de marcação lógica.
\end{itemize}
 
\section{Ficheiros \LaTeX{}}

Os ficheiros \LaTeX{} são ficheiros de texto. Em Unix/Linux são
bastante comuns. Em Windows, pode criá-los usando o Notepad.  O
ficheiro contém o texto do documento assim como os comandos que dizem
ao \LaTeX{} como formatar o texto. Se estiver a usar um IDE para
\LaTeX, ele já incluirá um programa para a criação de ficheiros de
texto.

\subsection{Espaços}

Caracteres ``brancos'' como espaços ou caracteres de tabulação
(\textit{tabs}) são tratados uniformemente como ``\wi{espaços}'' pelo
\LaTeX{}. Caracteres \wi{brancos} \emph{consecutivos} são tratados como
\emph{um} ``espaço''. Os espaços no início de uma linha são geralmente ignorados,
e uma simples mudança de linha é tratada da mesma forma que um espaço.
\index{espaço!no início de uma linha}

Uma linha em branco entre duas linhas de texto define o fim de um
parágrafo. \emph{Várias} linhas vazias são tratadas da mesma forma que
\emph{uma} linha vazia. O texto que se segue é um exemplo. Do lado
esquerdo apresenta-se o texto do ficheiro a escrever, e do lado direito
o resultado depois de processado.

\begin{example}
Não interessa se introduz apenas
um ou vários     espaços depois
de uma palavra.

Uma linha em branco inicia um novo
parágrafo.
\end{example}
 
\subsection{Caracteres Especiais}

Os símbolos que se seguem são \wi{caracteres reservados} que ou têm um
significado especial para o \LaTeX{} ou não estão disponíveis em todos
os tipos de letras. Se os introduzir directamente no seu texto, não
serão impressos, mas causarão o \LaTeX{} a fazer coisas que não
deseja.
\begin{code}
\verb.#  $  %  ^  &  _  {  }  ~  \ . %$
\end{code}

Como irá ver, estes caracteres podem ser utilizados nos seus documentos
todos da mesma forma, adicionando uma barra invertida como prefixo:

\begin{example}
\# \$ \% \^{} \& \_ \{ \} \~{}
\textbackslash
\end{example}

Outros símbolos e muitos mais podem ser impressos com comandos
especiais em fórmulas matemáticas ou como acentos. O carácter de barra
invertida (\textbackslash{}) \emph{não} deve ser introduzido
adicionando uma outra barra antes (\verb!\\!), porque esta sequência é
utilizada para quebrar linhas de texto. Use antes o
\ci{textbackslash}.

\subsection{Comandos \LaTeX{}}

Os \wi{comandos} \LaTeX{} são sensíveis às maiúsculas/minúsculas, e
têm um de dois formatos:

\begin{itemize}
\item Começam com um \wi{backslash}\footnote{NT: a partir de agora
utilizaremos o termo inglês em vez de \emph{barra invertida}}
(\verb|\|) e têm um nome que consiste apenas de letras. Os nomes de
comandos terminam com um espaço, um número ou qualquer outro símbolo
``não-letra''.

\item Consistem num \textit{backslash} e exactamente um carácter não letra.
\item Muitos comandos existem numa ``versão estrelada'', onde um asterisco é
  adicionado ao nome do comando.
\end{itemize}

%
% \\* doesn't comply !
%

%
% Can \3 be a valid command ? (jacoboni)
%
\label{whitespace}

O \LaTeX{} ignora espaços em branco após os comandos. Se deseja um
\index{espaço!depois de comandos}espaço depois de um comando, deve
colocar um parâmetro vazio \verb|{}| e um espaço, um carácter
especial, ou um comando de espaçamento especial depois do nome do
comando. O parâmetro vazio \verb|{}| faz com que o \LaTeX{} pare de
comer todos os espaços após o nome do comando.

\begin{example}
Li que o Knuth divide as
pessoas que trabalham com o \TeX{}
em \TeX{}nicos e \TeX pertos.\\
Hoje é \today.
\end{example}

Alguns comandos precisam de um \wi{parâmetro} que deve ser introduzido
entre \wi{chavetas} (\verb|{ }|) depois do nome do comando. Alguns 
suportam \wi{parâmetros opcionais} que são adicionados depois do nome
do comando, entre \wi{parêntesis rectos}~(\verb|[ ]|).
\begin{code}
\verb|\|\textit{comando}\verb|[|\textit{parâmetro opcional}\verb|]{|\textit{parâmetro}\verb|}|
\end{code}
Os exemplos seguintes utilizam alguns comandos \LaTeX. Não se preocupe
com eles, pois serão explicados mais tarde.

\begin{example}
Pode \textsl{apoiar-se} em mim!
\end{example}
\begin{example}
Por favor, comece uma nova linha
exactamente aqui!\newline
Obrigado!
\end{example}

\subsection{Comentários}
\index{comentários}

Quando o \LaTeX{} encontra um carácter \verb|%| ao processar o ficheiro,
ignora todo o resto dessa linha, a mudança de linha e todos os
espaços no início da linha seguinte.

Pode ser utilizado para escrever notas nos ficheiros de código, que
não aparecerão nas versões impressas.

\begin{example}
Este é um % estúpido
% Melhor: instrutivo <----
exemplo: Supercal%
              ifragilist%
    icexpialidocious
\end{example}

O carácter \texttt{\%} também pode ser utilizado para quebrar linhas longas onde 
não são permitidos espaços nem mudanças de linha.

Para comentários mais longos, pode utilizar o ambiente \ei{comment}
disponibilizado pelo pacote \pai{verbatim}. Adicione a linha
\verb|\usepackage{verbatim}| ao preâmbulo do seu documento, como
explicado abaixo, para poder utilizar este comando.

\begin{example}
Este é outro
\begin{comment}
bastante estúpido,
mas instrutivo
\end{comment}
exemplo de como embeber
comentários nos seus documentos.
\end{example}

Note que isto não funciona dentro de ambientes complexos tal como o
matemático.

\section{Estrutura do Ficheiro}

Quando o \LaTeXe{} processa um ficheiro, espera que ele respeite uma
certa \wi{estrutura}. Desta forma, todos os ficheiros devem começar
com o comando
\begin{code}
\verb|\documentclass{...}|
\end{code}
Isto especifica o tipo de documento que tenciona escrever. Em seguida,
pode incluir comandos que influenciam o estilo de todo o documento, ou
pode incluir \wi{pacote}s que adicionarão novas propriedades ao
sistema \LaTeX. Para incluir este tipo de pacote, utilize o comando
\begin{code}
\verb|\usepackage{...}|
\end{code}

Quando todo o trabalho de configuração estiver feito,\footnote{A área
    entre \texttt{\bs documentclass} e \texttt{\bs
    begin$\mathtt{\{}$document$\mathtt{\}}$} é chamado de
    \emph{\wi{preâmbulo}}.} inicie o corpo do texto com o comando

\begin{code}
\verb|\begin{document}|
\end{code}

Agora introduza o texto misturado com comandos \LaTeX{} úteis. No fim 
do documento adicione o comando
\begin{code}
\verb|\end{document}|
\end{code}
que indica ao \LaTeX{} o fim do seu serviço. Tudo o que siga este
comando será ignorado pelo \LaTeX.

A figura~\ref{mini} mostra o conteúdo de um ficheiro \LaTeXe{} mínimo.
Um ficheiro um pouco mais complexo é mostrado na
figura~\ref{document}.

\begin{figure}[!bp]
\begin{lined}{6cm}
\begin{verbatim}
\documentclass{article}

% esta linha é específica para 
% o Português e outras línguas
% com caracteres acentuados.
\usepackage[latin1]{inputenc}

\begin{document}
Pequeno é belo.
\end{document}
\end{verbatim}
\end{lined}
\caption{Um ficheiro \LaTeX{} mínimo.} \label{mini}
\end{figure}
 
\begin{figure}[!bp]
\begin{lined}{10cm}
\begin{verbatim}
\documentclass[a4paper,11pt]{article}
% Esta linha é necessária para
% documentos em línguas que incluam
% caracteres acentuados.
\usepackage[latin1]{inputenc}

% Define o autor e título
\author{H.~Partl}
\title{Minimalista}

\begin{document}
% Gera o título
\maketitle 
% Insere a tabela de conteúdos
\tableofcontents
\section{Algumas Palavras Interessantes}
Bem, e aqui está o inicio do meu adorado artigo.
\section{Adeus, Mundo!}
\ldots{} e aqui ele acaba.
\end{document}
\end{verbatim}
\end{lined}
\caption[Exemplo de um Artigo Real.]{Exemplo de um artigo
   de jornal real. Note que os comandos que vê neste exemplo
   serão explicados mais tarde, nesta introdução.} \label{document}
\end{figure}

\section{Uma Sessão de Edição Típica}

Aposto que deve estar a morrer por poder testar o pequeno exemplo
de \LaTeX{} mostrado na página~\pageref{mini}. Aqui está alguma ajuda:
o \LaTeX{}, por si só, não contém um interface gráfico, ou botões
para clicar. É apenas um programa que mastiga o seu documento.
Algumas instalações do \LaTeX{} providenciam um programa gráfico
para interagir com o \LaTeX{} clicando em certos menus. Outros
sistemas podem exigir um pouco mais de dactilografia, portanto aqui
apresentamos como obrigar o \LaTeX{} a compilar o seu documento
num sistema baseado em texto. Note que esta
descrição assume que existe uma instalação \LaTeX{} a funcionar
no seu computador.\footnote{Este é o caso de qualquer sistema
Unix, e \ldots{} Homens a sério usam Unix}

\begin{enumerate}
\item 

  Edite/Crie o seu documento \LaTeX{}. Este ficheiro deve ser texto
  ASCII sem qualquer tipo de formatação. Em Unix, todos os editores
  vão fazer o que deseja. Em Windows, deve ter a certeza que vai
  gravar o ficheiro em ASCII ou em formato \emph{texto}. Ao escolher
  um nome para o seu ficheiro, tenha a certeza de lhe colocar a
  extensão \eei{.tex}.

\item 
  
  Abra um terminal (\emph{shell} ou \emph{command prompt}), mude para
  a pasta onde o seu ficheiro está (use o comando \texttt{cd}), e
  execute o \LaTeX{} no seu ficheiro. Se correr tudo bem, irá acabar
  com um ficheiro \texttt{.dvi}. Poderá ser necessário correr o
  \LaTeX{} várias vezes para obter um índice de conteúdos e todas as
  referências internas correctamente. Sempre que o seu ficheiro tenha
  um erro o \LaTeX{} irá dizer-lhe que erro cometeu e irá parar o seu
  processamento. Pressione \texttt{ctrl-D} para voltar à linha de
  comandos.

\begin{lscommand}
\verb+latex foo.tex+
\end{lscommand}
 
\item Agora pode ver o ficheiro DVI. Existem várias formas de o
  fazer. Veja o ficheiro no ecrã com
\begin{lscommand}
\verb+xdvi foo.dvi &+
\end{lscommand}
Isto funciona apenas em Unix com X11. Se está em Windows, poderá
tentar usar o \texttt{yap} (ainda outro pré-visualizador---yet another
previewer).

 Também pode converter o ficheiro dvi em \PSi{} para imprimir ou ver com o \wi{Ghostscript}.
\begin{lscommand}
\verb+dvips -Pcmz foo.dvi -o foo.ps+
\end{lscommand}
 Se tiver sorte, o seu sistema \LaTeX{} até trás a ferramenta \texttt{dvipdf}, que lhe permite
converter o seu ficheiro \texttt{.dvi} directamente em pdf.
\begin{lscommand}
\verb+dvipdf foo.dvi+
\end{lscommand}
\end{enumerate}
 
\section{O Formato do Documento}
 
\subsection {Classes de Documentos}\label{sec:documentclass}

A primeira informação que o \LaTeX{} precisa de saber quando processa
um ficheiro é o tipo de documento que o autor quer criar. Este tipo 
é especificado pelo comando \ci{documentclass}.
\begin{lscommand}
\ci{documentclass}\verb|[|\emph{opções}\verb|]{|\emph{classe}\verb|}|
\end{lscommand}
\noindent Aqui, \emph{classe} especifica o tipo do documento a ser
criado.  A tabela~\ref{documentclasses} lista as classes de documento
explicadas nesta introdução. A distribuição do \LaTeXe{} permite
classes adicionais para outros documentos, incluindo cartas e
slides. O parâmetro \emph{\wi{opções}} caracteriza o comportamento da
classe do documento. As opções devem ser separadas por vírgulas. As
opções mais comuns para os documentos padrão estão listadas na
tabela~\ref{options}.

\begin{table}[!bp]
\caption{Classes de Documentos.} \label{documentclasses}
\begin{lined}{\textwidth}
\begin{description}
 
\item [\normalfont\texttt{article}] para artigos em jornais científicos, pequenos
relatórios, documentação de programas, convites, \ldots
  \index{article!classe}\index{article}
\item [\normalfont\texttt{report}] para relatórios mais longos contendo vários
capítulos, pequenos livros, teses de doutoramento, \ldots\index{report!classe}\index{report}

\item [\normalfont\texttt{book}] para livros verdadeiros \index{book!classe}\index{book}
\item [\normalfont\texttt{slides}] para slides. Esta classe usa letras grandes
do tipo \textsf{sans serif}. Deve considerar utilizar o pacote Beamer.
em vez do \texttt{slides}.
        \index{slides!classe}\index{slides}
% \item [\normalfont\texttt{proc}] para actas (\emph{proceedings}) baseadas na classe
%   artigo.\index{proc!classe}
% \item [\normalfont\texttt{minimal}] é a classe mais pequena que pode obter. Só define
%   um tamanho de papel, e um tamanho de letra base. É usado especialmente para detecção 
%   de problemas. \index{minimal!classe}

\end{description}
\end{lined}
\end{table}

\begin{table}[!bp]
\caption{Opções das Classes de Documentos.} \label{options}
\begin{lined}{\textwidth}
\begin{flushleft}
\begin{description}
\item[\normalfont\texttt{10pt}, \texttt{11pt}, \texttt{12pt}] \quad Define o tamanho
  principal das letras do documento. Caso não especifique uma delas, é assumido
  \texttt{10pt}.  \index{tamanho de letra}
\item[\normalfont\texttt{a4paper}, \texttt{letterpaper}, \ldots] \quad Define
  o tamanho do papel. Por omissão, é utilizado o \texttt{letterpaper}. Além destes,
  existem \texttt{a5paper}, \texttt{b5paper}, \texttt{executivepaper},
  e \texttt{legalpaper}.  
  \index{tamanho do papel}\index{papel!A4}\index{papel!letter} \index{papel!A5}
    \index{papel!B5}\index{papel!executivo}\index{A4}\index{A5}

\item[\normalfont\texttt{fleqn}] \quad Alinha as fórmulas à
esquerda em vez de as centrar.

\item[\normalfont\texttt{leqno}] \quad Coloca a numeração nas fórmulas
do lado esquerdo em vez do lado direito.

\item[\normalfont\texttt{titlepage}, \texttt{notitlepage}] \quad Especifica
  se se deve criar uma nova página depois do \wi{título do documento}
  ou não. A classe \texttt{article} não inicia uma nova página por omissão, 
  enquanto que o \texttt{report} e o \texttt{book} o fazem. \index{título}
  
\item[\normalfont\texttt{twocolumn}] \quad Instrue o \LaTeX{} a
  escrever o documento em \wi{duas coluna}s.

\item[\normalfont\texttt{twoside, oneside}] \quad Indica se deve ser gerado
  resultado para impressão dos dois lados. As classes
  \texttt{article} e \texttt{report} são impressas apenas de um lado e a
  classe \texttt{book} é impressa dos dois lados por omissão.
  Note que esta opção muda apenas o estilo do documento. A opção 
 \texttt{twoside} \emph{não} diz à impressora que deve fazer
  a impressão de ambos os lados.

\item[\normalfont\texttt{openright, openany}] \quad Faz os capítulos começar
  apenas nas páginas do lado direito ou na próxima disponível. Esta opção
  não funciona com a classe \texttt{article} uma vez que ela não sabe o que
 são capítulos. A classe \texttt{report} inicia por omissão os capítulos na
  primeira página disponível e a classe \texttt{book} inicia nas páginas do
  lado direito.
  
\item[\normalfont\texttt{landscape}]\quad Muda o formato do documento
  para ser impresso numa folha deitada.

\end{description}
\end{flushleft}
\end{lined}
\end{table}

Exemplo: Um ficheiro para um documento \LaTeX{} pode começar com a linha
\begin{code}
\ci{documentclass}\verb|[11pt,twoside,a4paper]{article}|
\end{code}
que instrue o \LaTeX{} a escrever o documento como sendo um artigo
(\emph{article}) com um tamanho base de letra de onze pontos
(\emph{11pt}), e para gerar um formato adequado para impressão de
ambos os lados (\emph{twoside}) em papel A4 (\emph{a4paper}).
\pagebreak[2]

\subsection{Pacotes}
\index{pacote} \index{package} Ao escrever o seu documento,
provavelmente encontrará algumas áreas onde o \LaTeX{} básico não
conseguirá resolver os seus problemas. Se deseja incluir
\wi{gráficos}, \wi{texto colorido} ou código fonte de um ficheiro no
seu documento, irá precisar de melhorar as capacidades do \LaTeX. Este
tipo de melhoramentos são chamados pacotes (\textit{packages}), e são
activados com o comando
\begin{lscommand}
\ci{usepackage}\verb|[|\emph{opções}\verb|]{|\emph{pacote}\verb|}|
\end{lscommand}
\noindent onde \emph{pacote} é o nome do pacote e \emph{opções} é uma
lista de palavras chave que activam (ou desactivam) propriedades
especiais no pacote.  Alguns pacotes vêm com a distribuição base do
\LaTeXe{} (Veja a tabela~\ref{packages}), outros são distribuidos
separadamente. Poderá encontrar mais informação sobre os pacotes
instalados no \guide.  A primeira fonte de informação sobre os pacotes
\LaTeX{} é o \companion, que contém descrições de centenas de pacotes
juntamente com informação sobre como escrever as suas próprias
extensões para o \LaTeXe.

As distribuições de \TeX{} modernas incluem um grande número de
pacotes já instalados. Se está a trabalhar num sistema Unix, use o
comando \texttt{texdoc} para aceder à documentação existente.

\begin{table}[btp]
\caption{Alguns Pacotes Distribuídos com o \LaTeX.} \label{packages}
\begin{lined}{\textwidth}
\begin{description}
\item[\normalfont\pai{doc}] Permite a documentação de programas \LaTeX.\\
  Descrito em \texttt{doc.dtx}\footnote{Este ficheiro deve estar
    instalado no seu sistema, e deve conseguir convertê-lo para um
    ficheiro \texttt{dvi} digitando \texttt{latex doc.dtx} em qualquer
    directoria em que tiver permissões. Isto também é verdade para
    todos os outros ficheiros mencionados nesta tabela.} e no
  \companion.

\item[\normalfont\pai{exscale}] Fornece versões das letras do modo matemático 
  reguláveis em tamanho\\
  Descrito em \texttt{ltexscale.dtx}.

\item[\normalfont\pai{fontenc}] Especifica que \wi{codificação de caracteres}
  \index{font encoding} o \LaTeX{} deve usar.\\
  Descrito em \texttt{ltoutenc.dtx}.

\item[\normalfont\pai{ifthen}] Fornece comandos da forma\\
  `if\ldots then do\ldots otherwise do\ldots.'\\ Descrito em
  \texttt{ifthen.dtx} e no \companion.

\item[\normalfont\pai{latexsym}] Permite aceder ao tipo de letra \emph{symbol}
  do \LaTeX. Descrito em
  \texttt{latexsym.dtx} e no \companion.
 
\item[\normalfont\pai{makeidx}] Fornece comandos para produzir índices.
  Descrito na secção~\ref{sec:indexing} e no \companion.
  
\item[\normalfont\pai{syntonly}] Processa um documento sem escrever o
  resultado do processamento.
  
\item[\normalfont\pai{inputenc}] Permite a especificação de uma codificação
  como seja ASCII, ISO Latin-1, ISO Latin-2, páginas de código 437/850 IBM,
  Apple Macintosh, Next, ANSI-Windows ou definido pelo utilizador.
  Descrito em \texttt{inputenc.dtx}.
\end{description}
\end{lined}
\end{table}


\section{Ficheiros que provavelmente encontrará}

Quando trabalhar com o \LaTeX, rapidamente se encontrará num labirinto
de ficheiros com várias \wi{extensões} e provavelmente sem pista
alguma sobre o seu conteúdo. Em seguida apresentamos uma lista
indicando os vários \wi{tipos de ficheiros} que possivelmente
encontrará ao trabalhar com \TeX. Note que esta tabela não pretende
ser uma lista completa de extensões, mas se encontrar uma que falte e
que lhe pareça importante, avise!

\begin{description}
  
\item[\eei{.tex}] Ficheiros \LaTeX{} ou \TeX{}. Podem ser compilados com o
  \texttt{latex}.

\item[\eei{.sty}] Pacote de macros \LaTeX. Inclua o pacote no seu
  documento \LaTeX{} utilizando o comando \ci{usepackage}.

\item[\eei{.dtx}] \TeX{} documentado. Este é o formato base para a distribuição
  de ficheiros de estilo \LaTeX. Se processar um destes ficheiros ficará
  com documentação do pacote contido no ficheiro .dtx.

\item[\eei{.ins}] É o instalador para os ficheiros contidos nos ficheiros
  .dtx com o mesmo nome. Se fizer \textit{download} de um pacote \LaTeX{}
  da Internet, normalmente ficará com um ficheiro .dtx e um .ins. Corra
  o \LaTeX{} no ficheiro .ins para descompactar o ficheiro .dtx.

\item[\eei{.cls}] Ficheiros de classe que definem como o seu documento vai
  aparecer. Podem ser seleccionados com o comando \ci{documentclass}.
  
\item[\eei{.fd}] Ficheiros de descrição de tipos de letra que comunica
  ao \LaTeX{} novos tipos disponíveis.
\end{description}
Os ficheiros seguintes são gerados quando corre o \LaTeX{} no seu documento:

\begin{description}
\item[\eei{.dvi}] Device Independent file. Este é o resultado
  principal da utilização do \LaTeX. Veja o seu conteúdo com um
  programa de visualização de DVI ou converta-o para outro formato,
  por exemplo com a aplicação \texttt{dvips}.

\item[\eei{.log}] Contém informação detalhada sobre o que aconteceu da última
  vez que correu o \LaTeX{} no seu documento.

\item[\eei{.toc}] Guarda todos os cabeçalhos. Será lido da próxima vez que 
  correr o \LaTeX{} para produzir a tabela de conteúdos.

\item[\eei{.lof}] Idêntico ao .toc mas para a lista de figuras.

\item[\eei{.lot}] Mais uma vez o mesmo para a lista de tabelas.

\item[\eei{.aux}] Outro ficheiro que transporta informação de uma utilização
  do \LaTeX{} até à próxima. Entre outras coisas, o ficheiro .aux é utilizado
  para guardar informação associada com referências cruzadas.

\item[\eei{.idx}] Se o seu documento incluí um índice, o  \LaTeX{} guarda todas
  as palavras que vão para o índice neste ficheiro. Este ficheiro deve ser
  processado com o \texttt{makeindex}. Visite a secção~\ref{sec:indexing} na
  página \pageref{sec:indexing} para mais informação sobre indexação.

\item[\eei{.ind}] É o ficheiro processado do .idx, pronto para inclusão
  no seu documento no próximo ciclo de compilação.
        
\item[\eei{.ilg}] Ficheiro com os resultados sobre o processamento do \texttt{makeindex}.
\end{description}




\subsection{Estilo de Páginas}
 
O \LaTeX{} suporta três combinações pré-definidas de \wi{cabeçalho}/\wi{rodapé}
--- chamados de \wi{estilo de páginas} \index{page style}. O parâmetro \emph{estilo}
pode ser um dos %
\index{estilo de páginas!plain@\texttt{plain}}%
\index{plain@\texttt{plain}}%
\index{estilo de páginas!headings@\texttt{headings}}%
\index{headings@texttt{headings}}%
\index{estilo de páginas!empty@\texttt{empty}}%
\index{empty@\texttt{empty}}%
definidos pelo comando
\begin{lscommand}
\ci{pagestyle}\verb|{|\emph{estilo}\verb|}|
\end{lscommand}

A tabela~\ref{pagestyle} lista os estilos de páginas pré-definidos.

\begin{table}[!hbp]
\caption{Os Estilos de Páginas Pré-definidos no \LaTeX.} \label{pagestyle}
\begin{lined}{\textwidth}
\begin{description}

\item[\normalfont\texttt{plain}] imprime o número da página no fundo da página, no 
  centro do rodapé. Este é o estilo por omissão.

\item[\normalfont\texttt{headings}] imprime o nome do capítulo actual e o
  número da página no cabeçalho de cada página, enquanto que o rodapé se
  mantém vazio. (Este é o estilo usado neste documento)

\item[\normalfont\texttt{empty}] coloca quer o cabeçalho quer o rodapé vazios.

\end{description}
\end{lined}
\end{table}

É possível alterar o estilo da página actual com o comando
\begin{lscommand}
\ci{thispagestyle}\verb|{|\emph{estilo}\verb|}|
\end{lscommand}
Uma descrição sobre como criar os seus próprios cabeçalhos e rodapés pode ser
encontrado no \companion{} e na secção~\ref{sec:fancy} da página~\pageref{sec:fancy}.
%
% Pointer to the Fancy headings Package description !
%


%
% Add Info on page-numbering, ...
% \pagenumbering

\section{Grandes Projectos}
Quando trabalha com documentos grandes, possivelmente gostava de
separar os ficheiros de código em várias partes. O \LaTeX{} tem dois
comandos que ajudam a atingir este objectivo.

\begin{lscommand}
\ci{include}\verb|{|\emph{nomedoficheiro}\verb|}|
\end{lscommand}
\noindent este comando é usado no corpo de um documento para incluir o
conteúdo de outro ficheiro (chamado \emph{nomedoficheiro.tex}). O
\LaTeX{} irá iniciar uma nova página antes de processar o conteúdo
deste ficheiro.

O segundo comando pode ser utilizado no preâmbulo. Ele permite indicar 
ao \LaTeX{} que apenas os ficheiros especificados podem ser incluídos:
\begin{lscommand}
\ci{includeonly}\verb|{|\emph{nomedoficheiro}\verb|,|\emph{nomedoficheiro}%
\verb|,|\ldots\verb|}|
\end{lscommand}
Depois deste comando ser executado no preâmbulo do documento, apenas
os comandos \ci{include} para os ficheiros listados no argumento do
comando \ci{includeonly} serão realmente incluídos. Note que não podem
existir espaços entre os nomes dos ficheiros e as vírgulas.

O comando \ci{include} inicia o texto, incluído numa nova página. Isto
é útil quando usa o \ci{includeonly}, porque as mudanças de página não
se  moverão, mesmo quando alguns \ci{include}'s são omitidos.
Algumas vezes isto pode não ser desejável. Neste caso, deve utilizar o
comando
\begin{lscommand}
\ci{input}\verb|{|\emph{nomedoficheiro}\verb|}|
\end{lscommand}
\noindent que incluí simplesmente o ficheiro especificado, sem fatos
brilhantes, nem cordas agarradas!

Para fazer o \LaTeX{} verificar rapidamente o seu documento pode
utilizar o pacote \pai{syntonly} que faz com que o \LaTeX{} percorra o
ficheiro verificando apenas a sintaxe e utilização de comandos, mas
não produz nenhum ficheiro.  Como o \LaTeX{} corre mais depressa neste
modo, pode poupar-lhe muito do seu precioso tempo.  A sua utilização é
muito simples:

\begin{verbatim}
\usepackage{syntonly}
\syntaxonly
\end{verbatim}

Quando precisar de produzir páginas, adicione um comentário à segunda
linha (adicionando um símbolo de percentagem).

%
 
% TeX-master: "lshort"
% mode: latex

