### $Id: README,v 1.20 2001/01/20 02:10:47 jessen Exp $

DEFINIO

  Este documento  um exemplo de uso de LaTeX2e.  O objetivo  ser,
  atravs de exemplos, um guia para o usurio de LaTeX iniciante e
  intermedirio.  Pode servir tambm como um guia de referncia rpida
  para usurios avanados.

ONDE OBTER A VERSO MAIS ATUAL DESSE DOCUMENTO

  Homepage do LaTeX-demo
  http://biquinho.furg.br/tex-br/doc/LaTeX-demo/

  Todos os arquivos fonte:
  http://biquinho.furg.br/tex-br/doc/LaTeX-demo/LaTeX-demo.tar.gz

  Apenas os documentos em formato PDF:
  http://biquinho.furg.br/tex-br/doc/LaTeX-demo/LaTeX-demo.pdf
  http://biquinho.furg.br/tex-br/doc/LaTeX-demo/LaTeX-demo-src.pdf

  Apenas os documentos em formato PostScript:
  http://biquinho.furg.br/tex-br/doc/LaTeX-demo/LaTeX-demo-ps.tar.gz

COMO USAR O LaTeX-Demo

  * Se voc for um usurio iniciante de LaTeX comece olhando o
  contedo do diretrio `templates'.  H esqueletos paras as classes
  `article', `report', `book', `letter' e `slides' que voc pode usar
  como base para seus prprios documentos.

  * Compare a verso formatada (demo.{dvi,ps,pdf}) com os arquivos
  fonte que geraram o documento (demo-src.{dvi,ps,pdf}).

  * Consulte o ndice Remissivo por tpicos do seu interesse.

  * Leia os comentrios dos arquivos .tex.

  * Use este documento como base para os seus prprios documentos,
  simplesmente removendo as partes que no interessam.

DESCRIO

  So mostrados exemplos de:

  * Gerao de PDF com pdftex
     Uso de fontes Type 1, package ae, compilao condicional
     dependendo da sada, DVI ou PDF;
     Criao de links e bookmarks no documento com o package hyperref;
     Incluso de figuras no formato PNG, JPEG e PDF;

  * Acentuao e hifenizao correta em Portugus
     Package babel, font encoding T1 e acentos em latin1.

  * Definio das dimenses do documento
     Margens, header, footer, etc, atravs do package geometry.

  * Criao de um package com definies do usurio
     Comandos \newcommand, \newenvironment, etc.

  * Sumrio
     Acrescentando lista de figuras/tabelas, ndice, apndice e
     referncias no sumrio;
     Reservando mais espao para entradas com nmero de seo/subseo
     muito longas.

  * Processamento condicional com o package version

  * Processamento condicional com o package ifthen
     Comandos \ifthenelse e \whiledo.

  * Footnotes
     Uso de footnotes no ttulo, dentro de seo, tabelas e em
     captions;
     Footnote em verbatim;
     Alterando numerao dentro de minipage;
     Eliminando a linha horizontal que separa os footnotes;
     Duas (ou mais) entradas usando o mesmo ncice de footnote.

  * Espaamento
     Entre linhas: Duplo, Um e meio, etc;
     Alterao do espaamento entre pargrafos.

  * Sublinhado, sobrescrito, tracejado, etc. com o package ulem

  * Notas nas Margens

  * Smbolos especiais usando fontes Text Companion, Wasy, AMS, etc
     Uso de grau, graus Celsius, ordinal masculino e feminino, etc.

  * Listas
     Enumerate usando numerais romanos e letras minsculas e
     maisculas;
     Enumerate encadeado mostrando a profundidade de cada item
     (2.1.1., etc);
     Package enumerate.

  * Mltiplas colunas com o package multicol

  * Troca de tamanho, estilo e tipo de fontes

  * Quotation e poesia

  * Epgrafo
     Citao/frase no incio de uma seo/captulo.

  * Colunas

  * Length commands
     Comandos \the, \setlength, \addtolength, etc.

  * Espaamento vertical, horizontal e boxes

  * Counters
     Criando, mostrando e redefinindo counters;
     Mudando o estilo de footnotes, numerao de figuras e tabelas,
     etc;
     Exemplo de um environment que usa counters.

  * Tabelas
     Posicionamento [H] com o package float;
     Diminuio do tamanho e do espaamento entre colunas;
     Tabelas lado a lado;
     Aumento da espessura das linhas da tabela;
     Alterao da distncia entre a tabela e seu caption;
     Repetindo entradas em tabelas;
     Alinhamento de colunas com `.' e `:';
     Elevando uma entrada no meio de duas linhas com \raisebox;
     Tabela muito longa com quebra de pgina usando o package
     longtable;
     Aumento do espaamento entre as linhas da coluna;
     Tabela com rotao de 90 graus com o package lscape.

  * Grficos
     Incluso de grficos EPS com rotao, espelhamento, alteracao das
     dimenses e a escala;
     Posicionamento [H] com o package float;
     Figura dentro de figura com o package subfigure;
     Figuras lado a lado;
     Figuras ao lado de texto com o package wrapfig;
     Incluso de figuras geradas no gnuplot;
     Alterao da distncia entre a figura e seu caption;
     Substituio de texto em figuras EPS com o package
     psfrag. (apenas na verso DVI)

  * Cores

  * Referncias com \label, \ref e \pageref
     Uso do label LastPage definido no package lastpage.

  * Comandos \vref e \vpageref com o package varioref
     Uso de referncias como `na prxima pgina', `nesta pgina',
     etc.

  * Urls, pathnames e emails com o package url

  * Incluso de material verbatim
     Uso de material verbatim dentro de \newenvironment.

  * Pseudocdigo, Cdigo Fonte e Algoritmos
     Criao de um novo environment para incluso de cdigo fonte com
     os packages float e fancyvrb;
     Pseudocdigo com o package alltt;
     Algoritmo com os packages algorithm e algorithmic.

  * Formulas Matemticas
     Fraes, razes, mdulo, fatoriais, binmios,
     trigonometria, vetores, matrizes, determinantes, limites,
     somatrios, produtrios, derivadas, integrais;
     Ajuste manual de espaamento em formulas matemticas;
     Teorema;
     Unidades fsicas em frmulas e uso de \ensuremath em macros;
     Uso de acentuao em math mode com o comando \text definido pelo
     package amstext;
     Uso dos comandos \left. e \right. para criar delimitadores
     invisveis possibilitando abertura e o fechamento de
     parnteses/colchetes em linhas distintas;
     Mnimos quadrados;
     Multiplicao de matrizes;
     Transformadas de Fourier e Laplace.

  * Reaes Qumicas
     Macro para representar istopos.

  * Referncias bibliogrficas com BibTeX
     Uso de \cite, \nocite e \nocite{*};
     Obtendo referncias on-line em formato BibTeX.

  * Construo de ndice Remissivo
     Uso de \index e makeindex;
     Customizao do formato do ndice com introduo da letra a que
     se refere cada seo;
     Colocao de pontos entre a entrada e o nmero da pgina, no
     mesmo estilo do sumrio;
     Customizao de `Symbols' e `Numbers' para Portugus.

  * Construo de Glossrio
     Definio de um package simples para a criao de glossrio que
     define os comandos \Glossary, \printglossary e o environment
     theglossary;
     So usados tambm os comandos \makeglossary bem como o programa
     makeindex.

  * Descrio de vrios packages

DISTRIBUIO

  Este documento pode ser livremente copiado e modificado desde que
  atendidas as seguintes condies:

   permitido fazer e distribuir cpias inalteradas deste documento,
  completo ou em partes, contanto que a mensagem de copyright e esta
  nota sobre a distribuio sejam mantidas em todas as cpias.  Se
  este documento for distribudo apenas em partes, instrues de como
  obt-lo por completo devem ser includas.

   permitido fazer e distribuir cpias modificadas deste documento
  sob as mesmas condies do item anterior, contanto que todo o
  trabalho derivado seja distribudo sob estas mesmas condies.

   permitida a incluso de exemplos de cdigo LaTeX mostrados neste
  trabalho em qualquer documento.  Tal uso  completamente livre e no
  est sujeito  nenhuma restrio.

  Por questes de convenincia e compatibilidade com distribuies
  mais antigas de LaTeX alguns packages foram includos aos fontes
  desse documento.  Os termos de distribuio acima no cobrem tais
  packages -- nesses casos as licensas de seus autores devem ser
  respeitadas.

DESCRIO DOS ARQUIVOS

  Cada arquivo disponvel para download possui duas cpias: com e sem
  nmero de verso.  O arquivo sem nmero de verso  sempre um link
  simblico para o seu correspondente mais atual com nmero de
  verso.

  O arquivo CHECKSUM contm assinaturas SHA-1 e MD5 dos arquivos
  disponveis para download para que se possa verificar a integridade
  dos mesmos.

  O arquivo `LaTeX-demo.tar.gz' contm todos os arquivos fonte para se
  criar a verso final do documento:

  README                  Este texto.
  INSTALL                 Instrues para a gerao do documento.

  Makefile                Makefile para a criao de todos os documentos.
                          Deve gerar os arquivos: demo.dvi, demo.ps,
                          demo-src.dvi e demo-src.ps.

  demo.tex                Arquivos principais do LaTeX-demo.  Estes
  demo.sty                arquivos usam os demais arquivos que seguem.

  demo-version.sty
  makeglo.sty
  makeglo.ist
  demo-distrib.tex
  demo-apendice.tex
  demo-apendice-packages.tex
  demo-biblio.tex
  demo-boxes.tex
  demo-center.tex
  demo-codigo.tex
  demo-colunas.tex
  demo-cores.tex
  demo-counter.tex
  demo-espacamento.tex
  demo-espaco.tex
  demo-fontes.tex
  demo-graphics.tex
  demo-pdf-graphics.tex
  demo-index.ist
  demo-length.tex
  demo-lists.tex
  demo-matematica.tex
  demo-quimica.tex
  demo-package-fontes.tex
  demo-poesia.tex
  demo-quotation.tex
  demo-referencias.tex
  demo-simbolos.tex
  demo-tables.tex
  demo-texto.tex
  demo-thanks.tex
  demo-typed.tex
  demo-url.tex
  refs.bib

  demo-src.tex            Documento que mostra todos os arquivos fonte
  demo-src.sty            usados no documento LaTeX-demo.

  gnuplot/                Diretrio que contm o cdigo que gera as
                          figuras com gnuplot.  As figuras j esto
                          geradas, portando no  necessrio o uso do
                          gnuplot.

  xfig/                   Diretrio que contm o cdigo que gera as
                          figuras com xfig.  As figuras j esto
                          geradas, portando no  necessrio o uso do
                          xfig.

  figures/                Diretrio que contm as figuras (eps, jpg,
                          png e pdf) includas pelo LaTeX-demo.

  code/                   Diretrio que contm os fragmentos de cdigo
                          includos pelo LaTeX-demo.

  auto/                   Diretrio usado pelo AUC TeX.  No 
                          necessrio para a criao dos documentos.

  templates/              Este diretrio possui templates de vrias
  templates/README        classes de documentos LaTeX: article, book,
  templates/Makefile      report, letter e slides.  Um template de
  templates/report.tex    arquivo de referencias BibTeX tambem est
  templates/article.tex   disponvel.
  templates/articletwocolumn.tex
  templates/book.tex
  templates/letter.tex
  templates/slides.tex
  templates/template.bib

  fancyvrb.sty            O package fancyvrb no faz parte do
                          documento, apenas foi includo por questes
                          de compatibilidade com distribuies mais
                          antigas de LaTeX, onde geralmente ele no
                          est presente.   usado nos documentos
                          `demo' e `demo-src'.

  psfrag.sty              Esses dois arquivos fazem parte do package
  psfrag.pro              psfrag, que foi includo por questes de
                          compatibilidade com distribuies mais
                          antigas de LaTeX.

  hyperref.sty            Verso recente do hyperref (6.71a) que corrige
  pd1enc.def              vrios bugs.  Estes arquivos foram includos
  hpdftex.def             por questes de compatibilidade com
                          distribuies mais antigas.

  Todos os packages acima podem ser obtidos no CTAN, em
  http://www.ctan.org/.

POSSVEIS PROBLEMAS

  Caso voce obtenha, durante a gerao da verso PDF desse documento,
  o seguinte erro:

    ! TeX capacity exceeded, sorry [pool size=xxxxx]

    (onde xxxxx depende do seu sistema)

  edite o arquivo `texmf.cnf', aumentando o valor de `pool_size' para
  150000, por exemplo.

  A fonte mais comum de problemas  a falta de packages, usados por
  este documento, no seu sistema.  A soluo  a instalao de uma
  distribuio completa, como a teTeX.  Note que tambm  possvel
  copiar apenas os packages que esto faltando para o diretrio onde
  se encontram os arquivos deste documento.  Voc encontra uma lista
  de packages em:

  ftp://ftp.dante.de/tex-archive/help/Catalogue/catalogue.html

  Se voc j usa teTeX e mesmo assim ocorre um erro informando que o
  arquivo `a4wide.sty' no  encontrado, provavelmente sua verso  a
  0.3.4.  Faa um upgrade para a verso 0.4 ou maior ou copie apenas
  este arquivo.  Outra alternativa  pegar uma verso mais recente
  deste documento.  As verses mais novas (> 1.4) usam por default o
  package geometry para especificar as margens do documento.

  Caso voc obtenha os erros:

    ! LaTeX Error: Command \square already defined.
                   Or name \end... illegal, see p.192 of the manual.

    ! Undefined control sequence.
    <recently read> \textcentigrade

  provavelmente voc est usando uma verso mais nova de
  LaTeX/packages (possivelmente teTeX 0.9) com uma verso antiga do
  LaTeX-demo (< 1.11).  Pegue a verso mais recente do LaTeX-demo para
  evitar esse erro.

  Ao tentar visualizar os arquivos `.dvi' com o `xdvi'  possvel que
  voc obtenha os seguintes warnings:

    Note:  overstrike characters may be incorrect.
    xdvi.bin:  special "papersize=597.50787pt,845.04684pt" not implemented
    xdvi.bin:  special "papersize=597.50787pt,845.04684pt" not implemented

  Esses warnings so normais em verses mais antigas de `xdvi' e no
  devem trazer maiores problemas.  Voc pode elimina-los instalando
  uma verso mais recente de `xdvi'.

  Se voc est rodando LaTeX pela primeira vez ou no costuma usar as
  fontes referenciadas neste documento  normal que a primeira vez que
  for roda-lo o LaTeX demore muito tempo no processo de criao de
  fontes.  Nas prximas vezes a compilao do documento ser muito
  mais rpida.

  Note que para a criao de fontes ser efetuada com sucesso voc
  precisa que o diretrio de fontes do seu sistema esteja com
  permisses de escrita e leitura.  No caso do teTeX voc pode
  descobrir onde esse diretrio reside rodando `texconfig'.  Alguns
  diretrios tpicos so `/var/tmp/texfonts', `/var/texfonts', etc.

  As verses j formatadas, em PostScript e PDF, esto disponveis
  para o caso de voc ter problemas na gerao dos documentos.

MODIFICANDO AS DIMENSES DOS DOCUMENTOS GERADOS

  Por default os documentos so gerados para impresso em papel `A4'.
  Se voc desejar mudar essas dimenses para papel `letter', faa as
  seguintes modificaes nos arquivos `demo.sty' e `demo-src.sty':

  Comente a linha:
  \geometry{a4paper,left=1in,right=1in,top=1in,bottom=1in}

  Descomente a linha:
  %\geometry{letterpaper,left=1in,right=1in,top=1in,bottom=1in}

  Depois disso  s refazer os documentos.

DVIDAS/DIFICULDADES/SUGESTES/BUGS

  Dvidas, sugestes e bug reports so bem-vindos.  Se voc usa algum
  recurso nos seus documentos LaTeX que no  discutido aqui por favor
  mande sua contribuio, assim como recursos que gostaria de
  utilizar.

  Por favor mande mail para: jessen@acm.org

Happy LaTeXing,
Klaus Steding-Jessen

### README ends here.
