%% $Header: /home/cvsroot/abntex/texmf/doc/bibtex/abntex/abnt-bibtex-alf-doc.tex,v 1.19 2002/11/22 18:23:37 gweber Exp $
%% name of this file abnt-bibtex-alf-doc.tex
%% Copyright 2001-2002 by the abnTeX group at http://codigolivre.org.br/projects/abntex
%%
%% This file is distributed under the LaTeXProject Public License (LPPL) http://www.latex-project.org/lppl.html
%% You are free to modify this file under the LPPL.
%%

%% command line for latex2html :
%% latex2html -split 0 -toc_depth 8 -noinfo -noaddress -nonavigation -show_section_numbers -html_version 4.0 abnt-bibtex-alf-doc.tex

\documentclass[12pt,a4paper]{article}

\ifx\pdfoutput\undefined
\else
%from /usr/share/texmf/doc/pdftex/base/pdftexman.pdf
\pdfinfo{
  /Title        (Estilo bibtex compativel com a `norma' 6023/2000 da ABNT: Questoes especificas da `norma' 10520/2001)
  /Author       (Grupo abnTeX)
  /Subject      (referencias bibliograficas)
  /Keywords     (ABNT, bibliografia, 6023/2000, 10520/2001)}
\fi

\usepackage[portuges]{babel}
\usepackage[latin1]{inputenc}

\usepackage{html}

\def\abnTeX{{\sf abn}\TeX}
\def\Versao$#1 #2${#2}


%\usepackage{showtags}

\usepackage[alf]{abntcite}
%\usepackage{bibtex}
\usepackage[margin=2cm]{geometry}
\begin{document}
%se for usar citeoption não esqueça de comentar o \nocite{*} no final
\citeoption{abnt-experimental=no}
%begin{latexonly}
\begin{titlepage}
\begin{center}
{\bf\huge Estilo bibtex compatível com a `norma' 6023/2000 da ABNT}\\
{\bf\large Questões específicas da `norma' 10520/2001}\vspace{2cm}\\
{\Large Grupo \abnTeX }\\
{\tt abntex.codigolivre.org.br}\vspace{2cm}\\
{\Large \Versao$Revision: 1.19 $}\\
{Data do processamento \today}\\
{\bf Atenção: esse documento é preliminar.}  \\
\end{center}
\end{titlepage}
%end{latexonly}

\begin{htmlonly}

\title{Estilo bibtex compatível com a `norma' 6023/2000 da ABNT:\\ Questões específicas da `norma' 10520/2001}

\author{Grupo \abnTeX\\\htmladdnormallink{\tt abntex.codigolivre.org.br}{http://abntex.codigolivre.org.br}}

\date{Versão 1.12\\Atenção: esse documento é preliminar.}

\maketitle

\tableofcontents

\end{htmlonly}

\section*{Aviso I}

Se você está usando \LaTeX\  devemos presumir que está usando um
computador.\footnote{\LaTeX\ foi portado para tantos sistemas que
correm rumores de que haja implementações de \LaTeX\ para ábacos,
vídeo-cassetes, fornos de micro-ondas e máquinas de fazer café.
No entanto, temos razões para acreditar que
se trata de um pouco de exagero. Por isso achamos que é razoável a nossa
afirmação acima.}
Neste caso a citação no esquema auto-data é uma coisa tão arcaica e desnecessária
quanto uma régua-de-cálculo. Você não tem absolutamente nenhum motivo para
não usar o sistema de citação numérico, já que a ABNT
``autorizou'' o seu uso por um cochilo qualquer.

Por outro lado, há aqueles
que se dão ao trabalho de te dar trabalho de seguir regras esdrúxulas na hora
de escrever teses.
Estes podem estar exigindo que você use o arcaico sistema
autor-data. Também pode acontecer que os examinadores da banca, seja por que
não leram a sua tese ou porque não entenderam nada realmente (ou ambos),
acabem se enroscando
em picuinhas.
Aí mandam você colocar todas as suas referências numéricas em formato
autor-data.
Comentamos isso porque tudo isso já aconteceu com outras pessoas.
Portanto: \emph{esteja preparado}.

\section*{Aviso II}

O estilo \LaTeX\ {\tt abnt-alf.sty} está em desenvolvimento, é experimental e
tem muita coisa por fazer. Diferente do estilo bibtex {\tt abnt-alf.bst} que
já tem uma maturidade razoável.

\section{Como usar a citação alfabética (sistema autor-data)}

\subsection{Como chamar os pacotes e estilos}

Se você quiser ou precisar usar o estilo de citação alfabético
(seção 9.2 em 6023/2000~\cite{6023:2000})
utilize no preâmbulo
\begin{verbatim}
\usepackage[alf]{abntcite}
\end{verbatim}
Você \emph{não precisa} selecionar o comando \verb+\bibliographystyle+
e a base bibliográfica \verb+abnt-options+ também estará automaticamente
selecionada.

Se você quiser usar apenas o estilo bibliográfico
selecione com o comando
\begin{verbatim}
\bibliographystyle{abnt-alf}
\end{verbatim}
mas esteja avisado que nesse caso as chamadas no texto não vão estar
em conformidade com a `norma'.

\subsection{Como usar a citação no sistema autor-data}

Este sistema de citação é descrito em \citeonline{10520:2001}, note que
essa `norma' entrou em vigor em agosto de 2001 substituindo a
\citeonline{10520:1988}.
Esse sistema aceita básicamente duas formatações para a citação
dependendo da maneira como ocorre a citação no texto.

\subsubsection{Referências explicítas ({\tt citeonline}) }

É o caso em que você menciona \emph{explicitamente} o autor da referência na sentenca, algo
do tipo ``Fulano (1900)". Neste caso o nome do autor é escrito
normalmente. Para isso use o comando \verb+\citeonline+.

Exemplos apresentadas em \citeonline{10520:2001}:

%\def\Exemplo#1#2{\noindent\begin{minipage}[t]{8cm}\small#1%
%\end{minipage}\begin{minipage}[t]{9cm}\small#2%
%\end{minipage}\vspace{5mm}}

\vspace{3mm}
\noindent\begin{minipage}[t]{10cm}\latex{\small}\begin{verbatim}
A ironia será assim uma \ldots\  proposta por
\citeonline{10520:4.1-1}.
\end{verbatim}\end{minipage}\begin{minipage}[t]{7cm}\latex{\small}
A ironia será assim uma \latexhtml{\ldots\ }{...} proposta por \citeonline{10520:4.1-1}.
\end{minipage}\vspace{5mm}\\

\noindent\begin{minipage}[t]{10cm}\latex{\small}\begin{verbatim}
\citeonline[p.~146]{10520:4.2-2}
dizem que \ldots\ 
\end{verbatim}\end{minipage}\begin{minipage}[t]{7cm}\latex{\small}
\citeonline[p.~146]{10520:4.2-2} dizem que \latexhtml{\ldots\ }{...}
\end{minipage}\vspace{5mm}\\

\noindent\begin{minipage}[t]{10cm}\latex{\small}\begin{verbatim}
Segundo \citeonline[p.~27]{10520:4.2-3}
\ldots\ 
\end{verbatim}\end{minipage}\begin{minipage}[t]{7cm}\latex{\small}
Segundo \citeonline[p.~27]{10520:4.2-3}  \latexhtml{\ldots\ }{...}
\end{minipage}\vspace{5mm}\\

\subsubsection{Referências implicitas ({\tt cite})}

São aquelas referências que não fazem parte do texto. Use com \verb+\cite+.

Exemplos:

\vspace{5mm}
\noindent\begin{minipage}[t]{10cm}\latex{\small}\begin{verbatim}
para que \ldots\  à sociedade
\cite[p.~46, grifo nosso]{10520:4.8}  \ldots\ 
\end{verbatim}\end{minipage}\begin{minipage}[t]{7cm}\latex{\small}
para que \latexhtml{\ldots\ }{...} à sociedade \cite[p.~46, grifo nosso]{10520:4.8}  \latexhtml{\ldots\ }{...}
\end{minipage}\vspace{5mm}\\

\noindent\begin{minipage}[t]{10cm}\latex{\small}\begin{verbatim}
b) desejo de \ldots\  passado colonial
\cite[v.~2, p.~12, grifo do autor]{10520:4.8.1}
\ldots\ 
\end{verbatim}\end{minipage}\begin{minipage}[t]{7cm}\latex{\small}
b) desejo de \latexhtml{\ldots\ }{...} passado colonial
\cite[v.~2, p.~12, grifo do autor]{10520:4.8.1}  \latexhtml{\ldots\ }{...}
\end{minipage}\vspace{5mm}\\

\noindent\begin{minipage}[t]{10cm}\latex{\small}\begin{verbatim}
``Apesar das \ldots\  da filosofia''
\cite[p.~293]{10520:4.1-2}.
\end{verbatim}\end{minipage}\begin{minipage}[t]{7cm}\latex{\small}
``Apesar das \latexhtml{\ldots\ }{...} da filosofia'' \cite[p.~293]{10520:4.1-2}.
\end{minipage}\vspace{5mm}\\

\noindent\begin{minipage}[t]{10cm}\latex{\small}\begin{verbatim}
Depois, \ldots\  que prefiro
\cite[p.~101--114]{10520:4.1-3}.
\end{verbatim}\end{minipage}\begin{minipage}[t]{7cm}\latex{\small}
Depois, \latexhtml{\ldots\ }{...} que prefiro \cite[p.~101--114]{10520:4.1-3}.
\end{minipage}\vspace{5mm}\\

\noindent\begin{minipage}[t]{10cm}\latex{\small}\begin{verbatim}
A produção de \ldots\  em 1928
\cite[p.~513]{10520:4.2-1} .
\end{verbatim}\end{minipage}\begin{minipage}[t]{7cm}\latex{\small}
A produção de \latexhtml{\ldots\ }{...} em 1928 \cite[p.~513]{10520:4.2-1} .
\end{minipage}\vspace{5mm}\\


\subsubsection{Referências múltiplas}
\label{mult-ref}

Frequentemente queremos citar diversas referências de uma vez.
Utilize {\tt cite}  ou {\tt citeonline} separando cada chave
por uma vírgula sem espaços e sem mudança de linha.

\vspace{5mm}
\noindent\begin{minipage}[t]{10cm}\latex{\small}\begin{verbatim}
\cite{10520:5.1.4-98,10520:5.1.4-99,%
10520:5.1.4-00}
\end{verbatim}\end{minipage}\begin{minipage}[t]{7cm}\latex{\small}
\cite{10520:5.1.4-98,10520:5.1.4-99,10520:5.1.4-00}
\end{minipage}\vspace{5mm}\\

\noindent\begin{minipage}[t]{10cm}\latex{\small}\begin{verbatim}
\citeonline{10520:5.1.4-98,%
10520:5.1.4-99,10520:5.1.4-00}
\end{verbatim}\end{minipage}\begin{minipage}[t]{7cm}\latex{\small}
\citeonline{10520:5.1.4-98,10520:5.1.4-99,10520:5.1.4-00}
\end{minipage}\vspace{5mm}\\

\noindent\begin{minipage}[t]{10cm}\latex{\small}\begin{verbatim}
\cite{10520:1988,6023:2000,10520:2001}
\end{verbatim}\end{minipage}\begin{minipage}[t]{7cm}\latex{\small}
\cite{10520:1988,6023:2000,10520:2001}
\end{minipage}\vspace{5mm}\\

\noindent\begin{minipage}[t]{10cm}\latex{\small}\begin{verbatim}
\citeonline{10520:1988,6023:2000,10520:2001}
\end{verbatim}\end{minipage}\begin{minipage}[t]{7cm}\latex{\small}
\citeonline{10520:1988,6023:2000,10520:2001}
\end{minipage}\vspace{5mm}\\

\subsubsection{Múltiplas referências com mesmo autor-data}
\label{mult-abc}
Quando há várias referências com o mesmo autor-data o {\tt abnt-alf.sty}
gera automáticamente um `a', `b' etc adicional. Isto atende ao ítem
5.1.3 da `norma' \cite{10520:2001}.

\noindent\begin{minipage}[t]{10cm}\latex{\small}\begin{verbatim}
\cite{10520:5.1.3a,10520:5.1.3b}
\end{verbatim}\end{minipage}\begin{minipage}[t]{7cm}\latex{\small}
\cite{10520:5.1.3a,10520:5.1.3b}
\end{minipage}\vspace{5mm}\\

\noindent\begin{minipage}[t]{10cm}\latex{\small}\begin{verbatim}
\citeonline{10520:5.1.3a,10520:5.1.3b}
\end{verbatim}\end{minipage}\begin{minipage}[t]{7cm}\latex{\small}
\citeonline{10520:5.1.3a,10520:5.1.3b}
\end{minipage}\vspace{5mm}\\

\subsubsection{Mais de três autores e o uso de et al.}

A `norma' \cite{10520:2001} é omissa sobre o caso de chamadas a obras
com mais de três autores. Mesmo entre os 204 exemplos da `norma' \cite{6023:2000}
ocorre um único caso usado nos exemplos a seguir.

\noindent\begin{minipage}[t]{10cm}\latex{\small}\begin{verbatim}
Segundo \citeonline{8.1.1.2}
entende-se que \ldots\ 
\end{verbatim}\end{minipage}\begin{minipage}[t]{7cm}\latex{\small}
Segundo \citeonline{8.1.1.2}
entende-se que \latexhtml{\ldots\ }{...}
\end{minipage}\vspace{5mm}\\

\noindent\begin{minipage}[t]{10cm}\latex{\small}\begin{verbatim}
Em recente estudo \cite{8.1.1.2}
entende-se que \ldots\ 
\end{verbatim}\end{minipage}\begin{minipage}[t]{7cm}\latex{\small}
Em recente estudo \cite{8.1.1.2}
entende-se que \latexhtml{\ldots\ }{...}
\end{minipage}\vspace{5mm}\\

Você pode desativar esse comportamento usando a opção {\tt abnt-no-etal-label},
veja mais informacões em \cite{abnt-bibtex-doc}.

\subsubsection{Citações de partes da referência}

Às vezes você pode se ver na necessidade de citar apenas uma parte
da referência, como apenas o autor ou apenas o ano.
Para isso foram implementados diversos comandos.

\subsubsection*{Citar apenas o autor ({\tt citeauthoronline}), forma explícita}

\noindent\begin{minipage}[t]{10cm}\latex{\small}\begin{verbatim}
A produção de \ldots\  em 1928 mencionada por
\citeauthoronline{10520:4.2-1}.
\end{verbatim}\end{minipage}\begin{minipage}[t]{7cm}\latex{\small}
A produção de \latexhtml{\ldots\ }{...} em 1928  mencionada por
\citeauthoronline{10520:4.2-1}.
\end{minipage}\vspace{5mm}\\

\noindent\begin{minipage}[t]{10cm}\latex{\small}\begin{verbatim}
A produção de \ldots\  em 1928
(\citeauthor{10520:4.2-1} 1928).
\end{verbatim}\end{minipage}\begin{minipage}[t]{7cm}\latex{\small}
A produção de \latexhtml{\ldots\ }{...} em 1928
(\citeauthor{10520:4.2-1} 1928).
\end{minipage}\vspace{5mm}\\

\subsubsection*{Citar apenas o ano ({\tt citeyear})}

\vspace{3mm}
\noindent\begin{minipage}[t]{10cm}\latex{\small}\begin{verbatim}
Em \citeyear{10520:4.1-1} a ironia
será assim uma \ldots\  proposta por.
\end{verbatim}\end{minipage}\begin{minipage}[t]{7cm}\latex{\small}
Em \citeyear{10520:4.1-1} a ironia será assim uma \latexhtml{\ldots\ }{...} proposta por.
\end{minipage}\vspace{5mm}\\

\section{Ítens que ainda não foram implementados}

\subsection{Autores com mesmo sobrenome e nome diferente}

A `norma' \cite{10520:2001} no seu ítem 5.1.2 sugere que se coloque o nome por extenso quando
o sobrenome+data forem igual. Isto em geral não é possível pois raramente
se conhece o primeiro nome de um autor. Em todo caso veja a seção~\ref{mult-abc}
para ver como é resolvido o caso de autor-data igual.

\subsection{Referências em notas de roda-pé}

Não há intenção, a curto prazo, em implementar referências em notas de roda-pé
conforme sugerido no ítem 6 da `norma' 10520.

\section{Problemas com a `norma' 10520}

Como já foi dito, a `norma' 10520 \cite{10520:2001} é incompleta e
inconsistente. Aqui apresentamos uma descrição dos principais problemas
encontrados e como foram resolvidos (quando possível).

\subsection{Referências múltiplas}

As referências a vários autores simultâneamente, ou várias obras de um
mesmo autor são um verdadeiro mistério na ``norma'' \cite{10520:2001}.
No exemplo da seção 5.1.4 diz a ``norma'''
\begin{quote}
As citações de diversos documentos de um mesmo autor, publicados em anos diferentes
e mencionados simultaneamente, têm as suas datas separadas por vírgula.\\
Exemplo: (CRUZ; CORREA; COSTA; 1998, 1999, 2000)\footnote{Transcrição exata, esta
chamada não foi gerada automaticamente.}
\end{quote}
Podemos então entender que Cruz, Correa e Costa são os três autores e 1998, 1999
e 2000 são os três anos de publicação referindo-se a três documentos separados?
Antes de responder sim, veja o que diz a seção seguinte, 5.1.5:
\begin{quote}
As citações de diversos documentos de vários autores, mencionados simultaneamente,
devem ser separadas por ponto e vírgula.\\
Exemplo: (FONSECA; PAIVA; SILVA, 1997)\footnote{Transcrição exata, esta
chamada não foi gerada automaticamente.}
\end{quote}
E agora? Trata-se de três autores separados, Fonseca, Paiva, Silva? Ou um
autor Fonseca e outro documento com dois autores, Paiva e Silva? Ou um
documento com dois autores Fonseca e Paiva seguido de um autor Silva?
Quem não lê a descrição da seção 5.1.5 pode inclusive achar que se trata
de um único documento. Ou o exemplo da seção 5.1.5 está errado:
faltam datas aos outros autores, ou foi uma tentativa
desastrada de agrupar três documentos com o mesmo ano de publicação.
Já exemplo anterior, da seção 5.1.4,  tem problemas também
há um ponto-e-vírgula após o COSTA quando deveria ter apenas uma vírgula.
Veja na seção~\ref{mult-ref} como fica a nossa solução.

Exemplo da seção 5.1.5:\\
\noindent\begin{minipage}[t]{10cm}\latex{\small}\begin{verbatim}
\cite{10520:5.1.5a,10520:5.1.5b,%
10520:5.1.5c}
\end{verbatim}\end{minipage}\begin{minipage}[t]{7cm}\latex{\small}
\cite{10520:5.1.5a,10520:5.1.5b,10520:5.1.5c}
\end{minipage}\vspace{5mm}\\
\noindent\begin{minipage}[t]{10cm}\latex{\small}\begin{verbatim}
\citeonline{10520:5.1.5a,10520:5.1.5b,%
10520:5.1.5c}
\end{verbatim}\end{minipage}\begin{minipage}[t]{7cm}\latex{\small}
\citeonline{10520:5.1.5a,10520:5.1.5b,10520:5.1.5c}
\end{minipage}\vspace{5mm}\\

ou, supondo que Fonseca e Paiva sejam co-autores,\\
\noindent\begin{minipage}[t]{10cm}\latex{\small}\begin{verbatim}
\cite{10520:5.1.5ab,10520:5.1.5c}
\end{verbatim}\end{minipage}\begin{minipage}[t]{7cm}\latex{\small}
\cite{10520:5.1.5ab,10520:5.1.5c}
\end{minipage}\vspace{5mm}\\
\noindent\begin{minipage}[t]{10cm}\latex{\small}\begin{verbatim}
\citeonline{10520:5.1.5ab,10520:5.1.5c}
\end{verbatim}\end{minipage}\begin{minipage}[t]{7cm}\latex{\small}
\citeonline{10520:5.1.5ab,10520:5.1.5c}
\end{minipage}\vspace{5mm}\\

%comente a linha seguinte se for usar \citeoption
%\nocite{*}
%descomente a linha seguinte, e comente a outra, se for usar \citeoption
\bibliography{abnt-options,abnt-def,abnt-test,abnt-bibtex-doc}
%\bibliography{abnt-def,abnt-test}

%\bibliographystyle{abnt-alf}

%\bibliographystyle{plain}
\end{document}
