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.tex115
1 files changed, 90 insertions, 25 deletions
diff --git a/macros/latex/contrib/abntexto/abntexto-manual.tex b/macros/latex/contrib/abntexto/abntexto-manual.tex
index d054cf73fc..7d9d2b3153 100644
--- a/macros/latex/contrib/abntexto/abntexto-manual.tex
+++ b/macros/latex/contrib/abntexto/abntexto-manual.tex
@@ -4,14 +4,14 @@
\usepackage[brazil]{babel}
\usepackage[T1]{fontenc}
-\usepackage{tgheros} \def\familydefault{\sfdefault}
-\usepackage{inconsolata}
+\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
+%\let\href=\relax \newdimen\bibitemsep \def\textcite#1{{\bfseries#1}}
% MARKUP
% ================================================
@@ -25,12 +25,6 @@
\def\arg{\cc{arg}}
\def\opt{\kk{opt}}
-\def\argi{\cc{argi}}
-\def\argii{\cc{argii}}
-\def\argiii{\cc{argiii}}
-\def\opti{\kk{opti}}
-\def\optii{\kk{optii}}
-\def\optiii{\kk{optiii}}
\def\ccval#1{{\ttnoligs \{#1\}}}
\def\kkval#1{{\ttnoligs [#1]}}
\def\pkg#1{{\ttnoligs #1}}
@@ -43,7 +37,7 @@
\def\verbcatcodes{\let\do=\dodef \dospecials \catcode`\|=0 }
{\catcode`\^^M=13
- \gdef\verbpercent#1^^M{{\bfseries\color{graycomment}\@percentchar#1^^M}}
+ \gdef\verbpercent#1^^M{{\color{graycomment}\itshape\@percentchar#1^^M}}
}
\long\def\codeon{\par\begingroup \verbcatcodes
@@ -85,7 +79,7 @@
\sizeselectordef\LARGE{25pt}{30pt}
\definecolor{graybar}{gray}{0.75}
-\definecolor{graycomment}{gray}{1}
+\definecolor{graycomment}{gray}{.2}
\legendplacedef{code}{Código}{Lista de códigos}{cód.\,#1}{loc}
\def\loclabelwidth{10.6ex}
@@ -98,8 +92,6 @@
\widowpenalty=10000
\let\cite=\textcite
-\def\appendixlabelwidth{7.2em}
-
\def\bibfont{\singlesp}
\bibitemsep=18pt
@@ -118,12 +110,12 @@
abntexto\\[0.4em] \Large\itshape\mdseries
Classe para {\upshape\LaTeX}\\[2em] \normalfont\large
Elayson\\[1ex]
- \href{mailto:abntexto.classe@gmail.com}{abntexto dot classe at gmail dot com}\\[2.5ex]
+ \href{mailto:abntexto.classe@gmail.com}{abntexto.classe at gmail.com}\\[2.5ex]
\today\par}
\vskip3in
-{\centering \large\ttfamily 1.2.0-alpha\par}
+{\centering \large\ttfamily 1.2.1-alpha\par}
\newpage
@@ -152,7 +144,7 @@ Digite as linhas em \ref{vb:início} e use \pkg{abntexto}.
\usepackage[brazil]{babel} % para obter os padrões de hifenização corretos
\usepackage[T1]{fontenc}
-\usepackage{newtxtext} % fontes New TX, semelhante a Times
+\usepackage{newtxtext} % fontes New TX, semelhantes a Times
\usepackage{newtxmath}
\begin{document}
@@ -162,13 +154,13 @@ Digite as linhas em \ref{vb:início} e use \pkg{abntexto}.
\section{Fonte tipográfica}
-O tamanho da fonte é 12\,pt de imediato e pode ser configurado com o comando \cs\setfontsize\arg\ 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 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}.
+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.
@@ -258,11 +250,13 @@ Use \cs\place\ para inserir áreas de legenda como mostrado em \ref{vb:place}. M
\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.
+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\{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[style=abnt]\{biblatex\}}.
\section{Citações}
@@ -271,18 +265,89 @@ Para inserir aspas em citações diretas use \cs\qt\ccval{texto}. Mas, se tratan
\newpage
\corrprinton
-\printbibliography
+%\printbibliography
\corrprintoff
\newpage
\appendix
+\section{\emph{Feedback}}
+Sugestões, relatos de \emph{bugs} e doações são bem-vindas.
+
\section{Código-fonte}
-Em progresso\dots
+\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
-\section{\emph{Feedback}}
+% SOURCE MACROS
+% ================================================
+
+\makeatletter
+
+\definecolor{bg}{cmyk}{0,0.06,0,0}
+\definecolor{comment}{cmyk}{0.9,0,0,0.1}
-Sugestões, \emph{bug reports} e doações são bem-vindas.
+\def\sec#1\par{\subsection{#1}}
-\end{document}
+\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}