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.tex86
1 files changed, 50 insertions, 36 deletions
diff --git a/macros/latex/contrib/abntexto/abntexto-manual.tex b/macros/latex/contrib/abntexto/abntexto-manual.tex
index 2038eed5d1..20ecc91f12 100644
--- a/macros/latex/contrib/abntexto/abntexto-manual.tex
+++ b/macros/latex/contrib/abntexto/abntexto-manual.tex
@@ -4,20 +4,24 @@
\usepackage[brazil]{babel}
\usepackage[T1]{fontenc}
-\usepackage[varqu,varl,scale=0.85]{inconsolata}
-\usepackage[matchlowercase]{tgheros} \renewcommand\familydefault\sfdefault
+\usepackage[scale=0.85]{inconsolata}
+\usepackage[matchlowercase]{tgheros} \def\familydefault{\sfdefault}
\usepackage{lipsum} \def\lip{\lipsum[1][1-2]}
\usepackage{graphicx}
\usepackage{xcolor}
+\usepackage[style=abnt]{biblatex} \addbibresource{abntexto.bib}
\usepackage[colorlinks]{hyperref}
+%\let\href=\relax
-% MARKUP DEFS
+% MARKUP
% ================================================
-\def\cs#1{{\ttfamily \string#1}}
-\def\meta#1{\textsf{⟨\textit{\fontseries{c}\selectfont #1}⟩}} % ⟨#1⟩
-\def\cc#1{{\ttfamily \{\meta{#1}\}}}
-\def\kk#1{{\ttfamily [\meta{#1}]}}
+\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}}
@@ -27,51 +31,50 @@
\def\opti{\kk{opti}}
\def\optii{\kk{optii}}
\def\optiii{\kk{optiii}}
-\def\ccval#1{{\ttfamily \{#1\}}}
-\def\kkval#1{{\ttfamily [#1]}}
-\def\cls#1{\textsf{\textit{#1}}}
-\def\pkg#1{\texttt{#1}}
+\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\obeyspaces\catcode`\%=14 }
+\def\verbcatcodes{\let\do=\dodef \dospecials \catcode`\%=14 \catcode`\|=0 }
-\long\def\verbon{\par\begingroup \verbcatcodes
- \catcode`\|=0 % escape char
- \adef\^^I{\space\space\space\space}\adef\^^M{\par\leavevmode}%
+\long\def\verbon{\par\begingroup \verbcatcodes\obeyspaces
+ \adef\^^I{\space\space\space}%
+ \adef\^^M{\par\leavevmode}%
\startverb
}
{\catcode`\|=0 \catcode`\\=12
- |long|gdef|startverb#1\verboff{|verbbox{#1}|par|endgroup |verbreset}
+ |gdef|startverb#1\verboff{|verbbox{#1}|par|endgroup |verbreset}
}
\def\verbbox#1{\def\tnba@placewidth{\hsize \advance\hsize-3cm}%
- \ifx\tnba@savedplace\empty \else \vskip\placeabovespace \fi
+ \ifx\tnba@savedplace\empty\else\vskip\placeabovespace\fi
\parindent=0pt
\ifx\tnba@savedplace\empty\else\tnba@makelegend\fi
- \nobreak\par\nointerlineskip \kern10pt
+ \nobreak\nointerlineskip\vskip10pt
{\verbfont{#1}}%
- \nobreak\nointerlineskip
- \ifx\tnba@savedsrc\empty \else \tnba@makesrc \vskip\placebelowspace \fi
+ \nobreak\nointerlineskip\vskip8pt
+ \ifx\tnba@savedsrc\empty\else\tnba@makesrc\vskip\placebelowspace\fi
}
\def\verbreset{%
\let\tnba@savedplace=\empty
\let\tnba@savedlegend=\empty
\let\tnba@savedsrc=\empty
- \let\@currentlabel=\relax
+ \let\@currentlabel=\empty
}
-\long\def\verbfont{\raggedright\leftskip=6pt \singlesp\ttfamily\@noligs\leftframed}
+\def\verbfont{\raggedright\leftskip=6pt\singlesp\ttnoligs\leftframed}
\long\def\leftframed#1{\setbox0=\vtop{#1}%
\hbox{{\color{graybar}\kern1.5cm\vrule width1pt}\box0}%
}
-% PERSONAL DEFS
+% MISC
% ================================================
-\sizeselectordef\large{14pt}{17pt}
-\sizeselectordef\Large{22pt}{25pt}
+\sizeselectordef\large{14.4pt}{17pt}
+\sizeselectordef\Large{20.74pt}{25pt}
\sizeselectordef\LARGE{25pt}{30pt}
\definecolor{graybar}{gray}{0.75}
@@ -87,6 +90,9 @@
\clubpenalty=10000
\widowpenalty=10000
+\let\cite=\textcite
+\def\appendixlabelwidth{7em}
+
\makeatother
@@ -99,12 +105,12 @@
abntexto\\[0.4em] \Large\itshape\mdseries
Classe para {\upshape\LaTeX}\\[2em] \normalfont\large
Elayson\\[1ex]
- \href{mailto:elaysonabreu@gmail.com}{elaysonabreu@gmail.com}\\[2.5ex]
+ \href{mailto:abntexto.classe@gmail.com}{abntexto dot classe at gmail dot com}\\[2.5ex]
\today\par}
\vskip3in
-{\centering \large\ttfamily 1.0.0-alpha\par}
+{\centering \large\ttfamily 1.1.0-alpha\par}
\newpage
@@ -114,17 +120,17 @@
\section{Apresentação}
-O \cls{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).
+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 \href{https://www.ctan.org/pkg/latex-via-exemplos}{\LaTeXe\ Via Exemplos} ou \href{https://www.ctan.org/pkg/latex2e-help-texinfo}{\LaTeXe: An unofficial reference manual}, disponível também em francês. Além disso, também se pode ler \href{https://www.ctan.org/pkg/texbytopic}{\TeX\ by Topic} para aprender sobre o sistema \TeX.
+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 é \cls{abntex2}. Mas, diferente desta, o \cls{abntexto} não depende do \cls{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.
+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 \cls{abntexto} se propõe a seguir são aquelas em vigor até o momento da criação deste manual.
+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 \cls{abntexto}.
+Digite as linhas em \ref{vb:início} e use \pkg{abntexto}.
\legend{verb}{Início} \src\me
\label{vb:início}
@@ -209,13 +215,13 @@ Use o ambiente \cs{topics} para criar alíneas. Ele dispõe de dois níveis send
\label{vb:topics}
\verbon
\begin{topics}
- \item \label{alínea:x} 1
+ \item \label{al:x} 1
\begin{topics}
\item x
\item y
\item z
\end{topics}
- \item \label{alínea:y} 2
+ \item \label{al:y} 2
\item 3
\end{topics}%
\verboff
@@ -241,11 +247,19 @@ Use \cs\place\ para inserir áreas de legenda como mostrado em \ref{vb:place}. M
\section{Formatação de {\ttfamily\protect\textbackslash cite} e referências}
-Até o momento esta classe não possui macros para formatação de \cs\cite\ e referências. Utilize \cs{\usepackage\{abnt2cite\}} ou \cs{\usepackage[style=abnt]\{biblatex\}}.
+Até o momento o \pkg{abntexto} não possui macros para formatação de \cs\cite\ e referências. Utilize \cs{\usepackage\{abnt2cite\}} ou \cs{\usepackage[style=abnt]\{biblatex\}}.
\section{Citações}
-Para inserir aspas em citações diretas use \cs\qt\cc{texto}. Mas, se tratando de citações diretas com mais de três linhas, alterne para \cs\quote\ccval{enquoted text \cs\cite\cc{key}}.
+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
+
+{\def\section#1#2{\heading{#2}}%
+ \printbibliography\par}
+
+\newpage
+\appendix
\section{Código-fonte}