summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/abntexto/abntexto-manual.tex
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2022-10-07 03:03:15 +0000
committerNorbert Preining <norbert@preining.info>2022-10-07 03:03:15 +0000
commitbbbfa0a90645d4da46b1492f6513b28a01eb78da (patch)
treedcbf82e9f2bd50ac7596114690ad31ca7a6dbf8c /macros/latex/contrib/abntexto/abntexto-manual.tex
parent678708e90ffe138885ed8c06b6780d491b80fae5 (diff)
CTAN sync 202210070303
Diffstat (limited to 'macros/latex/contrib/abntexto/abntexto-manual.tex')
-rw-r--r--macros/latex/contrib/abntexto/abntexto-manual.tex106
1 files changed, 63 insertions, 43 deletions
diff --git a/macros/latex/contrib/abntexto/abntexto-manual.tex b/macros/latex/contrib/abntexto/abntexto-manual.tex
index 20ecc91f12..d054cf73fc 100644
--- a/macros/latex/contrib/abntexto/abntexto-manual.tex
+++ b/macros/latex/contrib/abntexto/abntexto-manual.tex
@@ -4,11 +4,11 @@
\usepackage[brazil]{babel}
\usepackage[T1]{fontenc}
-\usepackage[scale=0.85]{inconsolata}
-\usepackage[matchlowercase]{tgheros} \def\familydefault{\sfdefault}
+\usepackage{tgheros} \def\familydefault{\sfdefault}
+\usepackage{inconsolata}
\usepackage{lipsum} \def\lip{\lipsum[1][1-2]}
\usepackage{graphicx}
-\usepackage{xcolor}
+\usepackage[cmyk]{xcolor}
\usepackage[style=abnt]{biblatex} \addbibresource{abntexto.bib}
\usepackage[colorlinks]{hyperref}
%\let\href=\relax
@@ -40,24 +40,31 @@
\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`\%=14 \catcode`\|=0 }
+\def\verbcatcodes{\let\do=\dodef \dospecials \catcode`\|=0 }
-\long\def\verbon{\par\begingroup \verbcatcodes\obeyspaces
- \adef\^^I{\space\space\space}%
- \adef\^^M{\par\leavevmode}%
+{\catcode`\^^M=13
+ \gdef\verbpercent#1^^M{{\bfseries\color{graycomment}\@percentchar#1^^M}}
+}
+
+\long\def\codeon{\par\begingroup \verbcatcodes
+ \adef{\^^I}{\ \ \ }%
+ \adef{\^^M}{\par\leavevmode}%
+ \adef{ }{\ }%
+ \adef{\%}{\verbpercent}%
\startverb
}
-{\catcode`\|=0 \catcode`\\=12
- |gdef|startverb#1\verboff{|verbbox{#1}|par|endgroup |verbreset}
+{\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}%
- \ifx\tnba@savedplace\empty\else\vskip\placeabovespace\fi
+ \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\vskip\placebelowspace\fi
+ \ifx\tnba@savedsrc\empty\else\tnba@makesrc\fi
+ \vskip\placebelowspace
}
\def\verbreset{%
\let\tnba@savedplace=\empty
@@ -65,7 +72,7 @@
\let\tnba@savedsrc=\empty
\let\@currentlabel=\empty
}
-\def\verbfont{\raggedright\leftskip=6pt\singlesp\ttnoligs\leftframed}
+\def\verbfont{\raggedright\leftskip=6pt\singlesp\small\ttnoligs\leftframed}
\long\def\leftframed#1{\setbox0=\vtop{#1}%
\hbox{{\color{graybar}\kern1.5cm\vrule width1pt}\box0}%
}
@@ -78,10 +85,10 @@
\sizeselectordef\LARGE{25pt}{30pt}
\definecolor{graybar}{gray}{0.75}
-\definecolor{graycomment}{gray}{0.55}
-
-\legendplacedef{verb}{Verbatim}{verb.\,#1}{lov}
+\definecolor{graycomment}{gray}{1}
+\legendplacedef{code}{Código}{Lista de códigos}{cód.\,#1}{loc}
+\def\loclabelwidth{10.6ex}
\def\me{o autor.}
\tocilowercase
@@ -91,7 +98,13 @@
\widowpenalty=10000
\let\cite=\textcite
-\def\appendixlabelwidth{7em}
+\def\appendixlabelwidth{7.2em}
+
+\def\bibfont{\singlesp}
+\bibitemsep=18pt
+
+\def\corrprinton{\begingroup \def\section##1##2{\heading{##2}}}
+\def\corrprintoff{\par\endgroup}
\makeatother
@@ -110,7 +123,7 @@
\vskip3in
-{\centering \large\ttfamily 1.1.0-alpha\par}
+{\centering \large\ttfamily 1.2.0-alpha\par}
\newpage
@@ -132,20 +145,20 @@ As normas ABNT as quais o \pkg{abntexto} se propõe a seguir são aquelas em vig
Digite as linhas em \ref{vb:início} e use \pkg{abntexto}.
-\legend{verb}{Início} \src\me
+\legend{code}{Início} \src\me
\label{vb:início}
-\verbon
+\codeon
\documentclass{abntexto}
-\usepackage[brazil]{babel} |% para obter os padrões de hifenização corretos
+\usepackage[brazil]{babel} % para obter os padrões de hifenização corretos
\usepackage[T1]{fontenc}
-\usepackage{newtxtext} |% fontes New TX, com estilo times
+\usepackage{newtxtext} % fontes New TX, semelhante a Times
\usepackage{newtxmath}
\begin{document}
Texto
-\end{document}%
-\verboff
+\end{document}
+\codeoff
\section{Fonte tipográfica}
@@ -163,9 +176,9 @@ Além das chaves anteriores também existe \cs{twoside} que é booleana, ou seja
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{verb}{Aparência do sumário} \src\me
+\legend{code}{Aparência do sumário} \src\me
\label{vb:contents}
-\verbon
+\codeon
\documentclass{abntexto}
\usepackage{color}
@@ -178,18 +191,18 @@ Os comandos que mudam a fonte das entradas no ToC (Table of Contents, em inglês
\section{Título}
\subsection{Título}
-\end{document}%
-\verboff
+\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 2ex acima de \cs\section\ e 1cm abaixo.
+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{verb}{Aparência das seções} \src\me
+\legend{code}{Aparência das seções} \src\me
\label{vb:sec}
-\verbon
+\codeon
\documentclass{abntexto}
\usepackage{color}
@@ -204,16 +217,16 @@ Também há como alterar o espaço vertical acima e abaixo das seções usando \
\section{Texto}
\subsection{Texto}
\subsubsection{Texto}
-\end{document}%
-\verboff
+\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{verb}{Alíneas} \src\me
+\legend{code}{Alíneas} \src\me
\label{vb:topics}
-\verbon
+\codeon
\begin{topics}
\item \label{al:x} 1
\begin{topics}
@@ -223,16 +236,16 @@ Use o ambiente \cs{topics} para criar alíneas. Ele dispõe de dois níveis send
\end{topics}
\item \label{al:y} 2
\item 3
-\end{topics}%
-\verboff
+\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{verb}{Áreas de legenda} \src\me
+\legend{code}{Áreas de legenda} \src\me
\label{vb:place}
-\verbon
+\codeon
\usepackage{graphicx}
\begin{document}
@@ -242,8 +255,10 @@ Use \cs\place\ para inserir áreas de legenda como mostrado em \ref{vb:place}. M
\place{\includegraphics[width=0.4\linewidth]{example-image}}
Ver \ref{fig:teste}.
-\end{document}%
-\verboff
+\end{document}
+\codeoff
+
+O leitor pode querer definir uma nova área de legenda usando, por exemplo: \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}
@@ -255,8 +270,9 @@ Para inserir aspas em citações diretas use \cs\qt\ccval{texto}. Mas, se tratan
\newpage
-{\def\section#1#2{\heading{#2}}%
- \printbibliography\par}
+\corrprinton
+\printbibliography
+\corrprintoff
\newpage
\appendix
@@ -265,4 +281,8 @@ Para inserir aspas em citações diretas use \cs\qt\ccval{texto}. Mas, se tratan
Em progresso\dots
-\end{document}
+\section{\emph{Feedback}}
+
+Sugestões, \emph{bug reports} e doações são bem-vindas.
+
+\end{document}