summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/abntexto/abntexto-manual.tex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/abntexto/abntexto-manual.tex')
-rw-r--r--macros/latex/contrib/abntexto/abntexto-manual.tex353
1 files changed, 0 insertions, 353 deletions
diff --git a/macros/latex/contrib/abntexto/abntexto-manual.tex b/macros/latex/contrib/abntexto/abntexto-manual.tex
deleted file mode 100644
index 7d9d2b3153..0000000000
--- a/macros/latex/contrib/abntexto/abntexto-manual.tex
+++ /dev/null
@@ -1,353 +0,0 @@
-\documentclass{abntexto}
-
-\makeatletter
-
-\usepackage[brazil]{babel}
-\usepackage[T1]{fontenc}
-\usepackage{newtxtext}
-\usepackage{newtxmath}
-\usepackage{lipsum} \def\lip{\lipsum[1][1-2]}
-\usepackage{graphicx}
-\usepackage[cmyk]{xcolor}
-\usepackage[style=abnt]{biblatex} \addbibresource{abntexto.bib}
-\usepackage[colorlinks]{hyperref}
-%\let\href=\relax \newdimen\bibitemsep \def\textcite#1{{\bfseries#1}}
-
-% MARKUP
-% ================================================
-
-\def\ttnoligs{\ttfamily\@noligs}
-
-\def\cs#1{{\ttnoligs \string#1}}
-\def\meta#1{{\ttnoligs <#1>}} % ⟨⟩
-\def\cc#1{{\ttnoligs \{\meta{#1}\}}}
-\def\kk#1{{\ttnoligs [\meta{#1}]}}
-
-\def\arg{\cc{arg}}
-\def\opt{\kk{opt}}
-\def\ccval#1{{\ttnoligs \{#1\}}}
-\def\kkval#1{{\ttnoligs [#1]}}
-\def\pkg#1{{\ttnoligs #1}}
-
-% VERBATIM
-% ================================================
-
-\def\adef#1{\catcode`#1=13 \begingroup \lccode`\~=`#1\lowercase{\endgroup\def~}}
-\def\dodef#1{\catcode`#1=12 }
-\def\verbcatcodes{\let\do=\dodef \dospecials \catcode`\|=0 }
-
-{\catcode`\^^M=13
- \gdef\verbpercent#1^^M{{\color{graycomment}\itshape\@percentchar#1^^M}}
-}
-
-\long\def\codeon{\par\begingroup \verbcatcodes
- \adef{\^^I}{\ \ \ }%
- \adef{\^^M}{\par\leavevmode}%
- \adef{ }{\ }%
- \adef{\%}{\verbpercent}%
- \startverb
-}
-{\catcode`\ =13 \catcode`\^^M=13 \catcode`\|=0 \catcode`\\=12
- |gdef|startverb^^M#1^^M\codeoff{|verbbox{#1}|par|endgroup |verbreset}
-}
-\def\verbbox#1{\def\tnba@placewidth{\hsize \advance\hsize-3cm}%
- \vskip\placeabovespace
- \parindent=0pt
- \ifx\tnba@savedplace\empty\else\tnba@makelegend\fi
- \nobreak\nointerlineskip\vskip10pt
- {\verbfont{#1}}%
- \nobreak\nointerlineskip\vskip8pt
- \ifx\tnba@savedsrc\empty\else\tnba@makesrc\fi
- \vskip\placebelowspace
-}
-\def\verbreset{%
- \let\tnba@savedplace=\empty
- \let\tnba@savedlegend=\empty
- \let\tnba@savedsrc=\empty
- \let\@currentlabel=\empty
-}
-\def\verbfont{\raggedright\leftskip=6pt\singlesp\small\ttnoligs\leftframed}
-\long\def\leftframed#1{\setbox0=\vtop{#1}%
- \hbox{{\color{graybar}\kern1.5cm\vrule width1pt}\box0}%
-}
-
-% MISC
-% ================================================
-
-\sizeselectordef\large{14.4pt}{17pt}
-\sizeselectordef\Large{20.74pt}{25pt}
-\sizeselectordef\LARGE{25pt}{30pt}
-
-\definecolor{graybar}{gray}{0.75}
-\definecolor{graycomment}{gray}{.2}
-
-\legendplacedef{code}{Código}{Lista de códigos}{cód.\,#1}{loc}
-\def\loclabelwidth{10.6ex}
-\def\me{o autor.}
-
-\tocilowercase
-\sectionlowercase
-
-\clubpenalty=10000
-\widowpenalty=10000
-
-\let\cite=\textcite
-\def\bibfont{\singlesp}
-\bibitemsep=18pt
-
-\def\corrprinton{\begingroup \def\section##1##2{\heading{##2}}}
-\def\corrprintoff{\par\endgroup}
-
-\makeatother
-
-
-
-\begin{document}
-
-\leavevmode\vskip1.9in
-
-{\centering \LARGE\sffamily\bfseries
- abntexto\\[0.4em] \Large\itshape\mdseries
- Classe para {\upshape\LaTeX}\\[2em] \normalfont\large
- Elayson\\[1ex]
- \href{mailto:abntexto.classe@gmail.com}{abntexto.classe at gmail.com}\\[2.5ex]
- \today\par}
-
-\vskip3in
-
-{\centering \large\ttfamily 1.2.1-alpha\par}
-
-\newpage
-
-\maketoc
-
-\textual
-
-\section{Apresentação}
-
-O \pkg{abntexto} é uma classe do \LaTeX\ criada para facilitar a utilização das normas da Associação Brasileira de Normas Técnicas (ABNT) em trabalhos acadêmicos (monografias, dissertações, teses).
-
-Este \emph{não} é um manual sobre \LaTeX\ (ou \TeX, a ferramenta que o constitui) nem tampouco uma descrição detalhada sobre as normas ABNT. Para aprender sobre \LaTeX\ leia \cite{viaexemplos} ou \cite{latex2eunnoficial}, disponível também em francês. Além disso, também se pode ler \cite{texbytopic} para aprender sobre o sistema \TeX\footnote{Note que os livros referenciados não foram realmente citados e isso não é aceito na Norma, no entanto este não é um trabalho acadêmico real, mas um manual.}.
-
-Já existe uma classe para aplicação das normas ABNT cujo nome é \pkg{abntex2}. Mas, diferente desta, o \pkg{abntexto} não depende do \pkg{memoir}, uma classe de código-fonte e manual extensos e que implementa funções as quais, em sua maioria, não são pertinentes a um documento que use as diretrizes da ABNT.
-
-As normas ABNT as quais o \pkg{abntexto} se propõe a seguir são aquelas em vigor até o momento da criação deste manual.
-
-\section{Chamando a classe}
-
-Digite as linhas em \ref{vb:início} e use \pkg{abntexto}.
-
-\legend{code}{Início} \src\me
-\label{vb:início}
-\codeon
-\documentclass{abntexto}
-
-\usepackage[brazil]{babel} % para obter os padrões de hifenização corretos
-\usepackage[T1]{fontenc}
-\usepackage{newtxtext} % fontes New TX, semelhantes a Times
-\usepackage{newtxmath}
-
-\begin{document}
- Texto
-\end{document}
-\codeoff
-
-\section{Fonte tipográfica}
-
-O tamanho da fonte é 12\,pt de imediato e pode ser configurado com o comando \cs\setfontsize\cc{size} sendo que 12\,pt é a única opção disponível. Mas, se você deseja outro tamanho de fonte, crie-o usando \cs\fontsizedef\cc{size}\cc{defs}. Além disso, com os seletores de tamanho \cs\normalsize\ e \cs\small\ que configuram 12\,pt e 10\,pt, nessa ordem, é possível mudar o tamanho da fonte no corpo do documento.
-
-O espaçamento é de um e meio e pode ser alterado para dois com \cs\spacing\ccval{2}, por exemplo. Os atalhos \cs\singlesp, \cs\onehalfsp\ e \cs\doublesp\ estão disponíveis. Note que o espaçamento simples não tem o mesmo valor que o espaçamento um, portanto, \cs\singlesp\ é diferente de \cs\spacing\ccval{1}! Os atalhos \cs\onehalfsp\ e \cs\doublesp\ tem o mesmo significado de \cs\spacing\ccval{1.5} e \cs\spacing\ccval{2}.
-
-\section{\emph{Layout}}
-
-A folha é A4 por padrão e as margens esquerda e direita são de 3\,cm, 2\,cm para páginas ímpares e de 2\,cm, 3\,cm para páginas pares, respectivamente. Além disso, as margens superior e inferior têm, nessa ordem, 3\,cm, 2\,cm para todo o documento. Todas essas medidas podem ser alteradas com a macro \cs\paper\ que deve ser usada assim: \cs\paper\ccval{left=0cm, right=0cm, top=0cm, botttom=0cm}.
-
-Além das chaves anteriores também existe \cs{twoside} que é booleana, ou seja, aceita os valores \cs{true} ou \cs{false} e serve para ativar o modo de impressão em duas folhas aonde as medidas das margens horizontais se invertem nas páginas pares. Ao não informar um valor para \cs{twoside} subentende-se que seja \cs{true}, portanto \cs\paper\ccval{twoside} equivale a \cs\paper\ccval{twoside=true} e esse princípio também se aplica a outras chaves booleanas.
-
-\section{Sumário}
-
-Os comandos que mudam a fonte das entradas no ToC (Table of Contents, em inglês) são \cs\tocifont, \cs\tociifont, \dots, \cs\tocvfont\ (ver \ref{vb:contents}).
-
-\legend{code}{Aparência do sumário} \src\me
-\label{vb:contents}
-\codeon
-\documentclass{abntexto}
-
-\usepackage{color}
-
-\tocifont{\color{red}\itshape}
-\tociifont{\color{blue}\bfseries}
-
-\begin{document}
- \maketoc
-
- \section{Título}
- \subsection{Título}
-\end{document}
-\codeoff
-
-\section{Secionamento}
-
-A personalização das macros de seção (\cs\section, \cs\subsection\ etc.) é análoga a personalização do sumário e deve ser feita com \cs\sectionfont, \cs\subsectionfont, etc. como exemplificado em \ref{vb:sec}.
-
-Também há como alterar o espaço vertical acima e abaixo das seções usando \cs\sectionspaces, \cs\subsectionspaces, etc. Por exemplo, \cs\sectionspaces\ccval{2ex}\ccval{1cm} insere um espaço de 2\,ex acima de \cs\section\ e de 1\,cm abaixo.
-
-\legend{code}{Aparência das seções} \src\me
-\label{vb:sec}
-\codeon
-\documentclass{abntexto}
-
-\usepackage{color}
-
-\sectionfont{\color{blue}\scshape}
-\subsectionfont{\color{red}\slshape}
-\subsubsectionfont{\color{yellow}\sffamily}
-
-\begin{document}
- \maketoc
-
- \section{Texto}
- \subsection{Texto}
- \subsubsection{Texto}
-\end{document}
-\codeoff
-
-\section{Alíneas}
-
-Use o ambiente \cs{topics} para criar alíneas. Ele dispõe de dois níveis sendo que o segundo usa um travessão como marcador conforme o exemplo em \ref{vb:topics}. Naturalmente o uso de \cs\label\ é permitido.
-
-\legend{code}{Alíneas} \src\me
-\label{vb:topics}
-\codeon
-\begin{topics}
- \item \label{al:x} 1
- \begin{topics}
- \item x
- \item y
- \item z
- \end{topics}
- \item \label{al:y} 2
- \item 3
-\end{topics}
-\codeoff
-
-\section{Áreas de legenda}
-
-Use \cs\place\ para inserir áreas de legenda como mostrado em \ref{vb:place}. Mas existem condições: \cs\place\ deve vir por último e \cs\label\ precisa estar depois de \cs\legend. Além disso, existe a possibilidade de alterar o espaço vertical acima e abaixo de uma área de legenda com \cs\placespaces\cc{aboveskip}\cc{belowskip}.
-
-\legend{code}{Áreas de legenda} \src\me
-\label{vb:place}
-\codeon
-\usepackage{graphicx}
-
-\begin{document}
- \legend{figure}{Um título}
- \src{\texttt{www.site.com.br}. Acesso em 01 jan. 2020.}
- \label{fig:teste}
- \place{\includegraphics[width=0.4\linewidth]{example-image}}
-
- Ver \ref{fig:teste}.
-\end{document}
-\codeoff
-
-O leitor pode querer definir uma nova área de legenda usando, por exemplo, a instrução: \cs\legendplacedef\ccval{diagram}\ccval{Diagrama}\ccval{Lista de diagramas}\ccval{diag.\cs\,\cs#1}\ccval{lod} que vai criar o comando \cs\makelod\ para escrever no documento as entradas do arquivo auxiliar .lod.
-
-%*
-
-\section{Formatação de {\ttfamily\protect\textbackslash cite} e referências}
-
-Até o momento o \pkg{abntexto} não possui macros para formatação de \cs\cite\ e referências. Utilize \cs{\usepackage[style=abnt]\{biblatex\}}.
-
-\section{Citações}
-
-Para inserir aspas em citações diretas use \cs\qt\ccval{texto}. Mas, se tratando de citações diretas com mais de três linhas, alterne para \cs\quote\ccval{texto \cs\cite\cc{key}}.
-
-\newpage
-
-\corrprinton
-%\printbibliography
-\corrprintoff
-
-\newpage
-\appendix
-
-\section{\emph{Feedback}}
-Sugestões, relatos de \emph{bugs} e doações são bem-vindas.
-
-\section{Código-fonte}
-
-\makeatletter
-\newcount\seccount \def\thesec{\the\seccount}
-\def\extlabelwidth{4ex}
-\def\extlabelbox#1{\hbox to\extlabelwidth{#1~---~\hfil}}
-\def\l@subsection#1#2{\smartaboveskip{\penalty351}{\vskip1em plus1pt}%
- \begingroup
- \usetocifont \nobreak
- \extlineshape \relax
- \hskip-\leftskip \maybeuctoc{#1}\nobreak\hfil\nobreak
- \hbox to1.55em{\hss #2\kern-1pt\kern1pt}\par
- \endgroup
-}
-\def\subsection#1{\par \smartaboveskip{\penalty351}{\vskip\subsectionabove}\noindent
- \advancecount\seccount
- \setbox0=\hbox{\usesubsectionfont \thesec\quad}%
- {\usesubsectionfont \hangindent=\wd0 \box0 #1\tnba@nbpar}%
- \nobreak \smartbelowskip{\vskip\subsectionbelow}%
-}
-\makeatother
-
-% SOURCE MACROS
-% ================================================
-
-\makeatletter
-
-\definecolor{bg}{cmyk}{0,0.06,0,0}
-\definecolor{comment}{cmyk}{0.9,0,0,0.1}
-
-\def\sec#1\par{\subsection{#1}}
-
-\newdimen\hhkern \hhkern=12pt
-\newdimen\vvkern \vvkern=12pt
-
-\def\hh{\kern\hhkern}
-\def\vv{\kern\vvkern}
-
-{\catcode`\^^M=13
- \gdef\verbpercent#1^^M{{\bfseries\color{comment}\@percentchar#1^^M}}
-}
-
-\def\srccatcodes{\catcode`\!=14 \catcode`\%=9 \catcode`\|=0 }
-\def\codecatcodes{\let\do=\dodef \dospecials}
-
-\long\def\bcode{\par\begingroup \codecatcodes
- \adef{\^^I}{\ \ \ }%
- \adef{\^^M}{\par\leavevmode}%
- \adef{ }{\ }%
- \adef{\%}{\verbpercent}%
-% \def\par##1{\endgraf\ifx##1\par\leavevmode\fi##1}\obeylines
- \startcode
-}
-{\catcode`\%=13 \catcode`\ =13 \catcode`\^^M=13 \catcode`\|=0 \catcode`\\=12
- |long|gdef|startcode #1% |ecode{|codefont{#1}|par|endgroup}
-}
-
-\def\codefont{\raggedright\small\ttnoligs\bgbox}
-
-\long\def\bgbox#1{\setbox0=\vbox{\advance\hsize-24pt \vv#1\vv}%
- \ifdim\ht0>\dimexpr \pagegoal - \pagetotal \relax
- \setbox2=\vsplit0 to\dimexpr \pagegoal - \pagetotal -24pt \relax
- \fi
- \vskip8pt minus2pt
- \drawbg2\par \drawbg0%
- \vskip8pt minus2pt
-}
-\def\drawbg#1{\leavevmode
- \rlap{{\color{bg} \vrule width\dimexpr\wd#1+24pt\relax height\ht#1 depth\dp#1}}%
- \hbox{\hh\box#1\hh}%
-}
-
-\def\inputsrc#1{\begingroup \parskip=0pt \srccatcodes \input #1\endgroup}
-
-\inputsrc{abntexto.cls}
-
-\end{document}