texlive[73237] Master/texmf-dist/doc/latex/latex-via-exemplos:
commits+karl at tug.org
commits+karl at tug.org
Mon Dec 30 22:18:14 CET 2024
Revision: 73237
https://tug.org/svn/texlive?view=revision&revision=73237
Author: karl
Date: 2024-12-30 22:18:13 +0100 (Mon, 30 Dec 2024)
Log Message:
-----------
latex-via-exemplos (30dec24)
Modified Paths:
--------------
trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/changelog.txt
trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-abntex2.tex
trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-abntexto.tex
trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos.bib
trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos.pdf
trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos.tex
Modified: trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/changelog.txt
===================================================================
--- trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/changelog.txt 2024-12-30 00:44:07 UTC (rev 73236)
+++ trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/changelog.txt 2024-12-30 21:18:13 UTC (rev 73237)
@@ -1,3 +1,7 @@
+Version 2024-12-29
+ - example of table in ABNT style was corrected (now, using tabularray instead of xtab).
+ - example of xtabular used in ABNT removed because it does not fit ABNT style
+ - corrections over iffont related ones
version 2024-12-19
- example of glossaries and acronyms using packages acro and glossaries
- new packages: tabularray, overpic, tocloft
Modified: trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-abntex2.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-abntex2.tex 2024-12-30 00:44:07 UTC (rev 73236)
+++ trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-abntex2.tex 2024-12-30 21:18:13 UTC (rev 73237)
@@ -208,16 +208,35 @@
\clearpage\thispagestyle{empty}\cleardoublepage
\chapter{Fonte de tabelas e figuras}
-A fonte de tabelas e figuras são colocadas embaixo, pelo comando \verb+\legend+
+A fonte de tabelas e figuras são colocadas embaixo, pelo comando \verb+\fonte+
\begin{figure}[hbp!]
\center
\caption{Imagem exemplo contido no pacote \texttt{mwe}\label{fig:simples}}
\includegraphics[width=0.35\linewidth]{example-image}
-\legend{Fonte: CTAN -- \url{https://ctan.org/}}
+\fonte{CTAN -- \url{https://ctan.org/}}
+\nota{Exemplo do pacote \texttt{mwe}} % nota é opcional no ABNT
\end{figure}
-No caso de subfiguras e sub tabelas, colocar fonte em cada uma delas, com \verb+\legend+.
+No caso de subfiguras e sub tabelas, colocar fonte em cada uma delas, com \verb+\fonte+.
+Para tabelas curtas, use o comando \verb+\IBGEtab+ do \texttt{ABNTeX2} como na Tabela~\ref{tab:simples}.
+\begin{table}[hbp!]
+\IBGEtab{
+\caption{Tabela pequena\label{tab:simples}}
+}{
+ \begin{tabular}{lr}
+ \toprule
+ primeira coluna & segunda coluna \\
+ teste & 123 \\
+ \bottomrule
+ \end{tabular}%\center
+}{
+ \fonte{Elaboração do autor}
+ \nota{Tabela fluturante em conformidade com o ABNT} % nota é opcional no ABNT
+}\end{table}
+
+Note que o \verb+\IBGEtab+ não funciona na tabela longa ainda (2024). Além disso, \texttt{ABNTeX2} ainda (2024) não tem o ambiente de \texttt{quadros} do ABNT. O interessado para usar o quadro, poderá consultar o \url{https://github.com/abntex/abntex2/wiki/HowToCriarNovoAmbienteListing}.
+
\clearpage\thispagestyle{empty}\cleardoublepage
\chapter{Considerações Finais}
Conclusão do trabalho.
Modified: trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-abntexto.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-abntexto.tex 2024-12-30 00:44:07 UTC (rev 73236)
+++ trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-abntexto.tex 2024-12-30 21:18:13 UTC (rev 73237)
@@ -7,6 +7,8 @@
%
% neste modelo, usa o layout de um lado
\documentclass[a4paper]{abntexto}
+\usechapters% ativar o uso de capítulos (ajuste ao sumário)
+
% O padrão é dois lados. Para um lado, ou modo eletronico (um lado com margem menor), requer pequeno ajuste
% Em um lado somente
@@ -86,7 +88,6 @@
}} %\@ifpackageloaded %\AtBeginDocument
\makeatother
-\usechapters% ativar o uso de capítulos (ajuste ao sumário)
% ABNTexto define o contador \c at chapter usando \newcount do TeX.
% Assim, está sem o \cl at chapter para subordinar outros contadores
% Para que a subordinação de outros contadores (dois ou mais) funcionem devidamente (como feito pelo \numberwithin{}{}, \newtheorem{}{}[] e \newcounter{}[]), deve ter o seguinte comando
@@ -215,11 +216,11 @@
%
%\clearpage\phantomsection\pdfbookmark[chapter]{\listfigurename}{lof}
%\chapter*{Lista de Figuras}% opcional no ABNT
-%\maketoc{lof}
+%\makeext{lof}
%
%\clearpage\phantomsection\pdfbookmark[chapter]{\listfigurename}{lot}
%\chapter*{Lista de Tabelas} % opcional no ABNT
-%\maketoc{lot}
+%\makeext{lot}
%
% \clearpage
%\chapter*{Siglas} % Lista de siglas é opcional no ABNT.
@@ -291,8 +292,8 @@
\end{multiplace}
\end{figure}
-Não há suporte para tabelas flutuantes (2024). Logo, tabelas devem ser inseridas diretamente, mesmo que seja pequena.
-
+A tabela pequena pode ser inseridas no ambiente \texttt{table}, caso quer que seja auto posicionado, mas deve usar o comando \verb+\legend+ devidamente.
+\begin{table}[hbp!]
\begin{center}
\legend{table}{Um título}\label{tab:primeira}
\src{Elaboração do autor.}
@@ -309,9 +310,12 @@
\end{tabular}
}
\end{center}
+\end{table}
-Não há suporte para tabelas longas. Se precisar, use o pacote \texttt{xtab} e configure devidamente.
+Não há suporte para tabelas longas (2024). Se precisar, use o pacote \texttt{tabularray} ou \texttt{xtab} e configure devidamente.
+Também não há suporte para quadros ainda (2024).
+
\clearpage
\chapter{Citações}
Para citações curtas, use \verb+\enquote{texto}\cite{key}+.
@@ -328,7 +332,8 @@
% PÓS TEXTUAL
\clearpage
%% Referencias bibliográficas é obrigatório no ABNT
-\phantomsection\addcontentsline{toc}{chapter}{\refname}%adicionando no sumário
+% \phantomsection\addcontentsline{toc}{chapter}{\refname}%adicionando no sumário
+\phantomsection\addtoext{toc}{chapter}{\refname} %adicionando no sumário pelo comando de ABNTexto
\printbibliography%sem opção, para devido funcionamento em ABNTexto
%% glossário é opcional no ABNT
%\clearpage\phantomsection\addtoext{toc}{chapter}{Glossário} %adicionando no sumário pelo comando de ABNTexto
Modified: trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos.bib
===================================================================
--- trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos.bib 2024-12-30 00:44:07 UTC (rev 73236)
+++ trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos.bib 2024-12-30 21:18:13 UTC (rev 73237)
@@ -125,6 +125,16 @@
}
@comment{note="URL: {\url{https://ctan.org/pkg/biblatex-abnt/}}",}
+ at book{book:abntexto:abreu,
+author={Elayson Abreu},
+title={abntexto: classe para {\LaTeX}},
+url={https://ctan.org/pkg/abntexto},
+lastchecked={2024-12-29},
+urldate={2024-12-29},
+year=2024
+}
+ at comment{note="URL: {\url{https://ctan.org/pkg/abntexto}}",}
+
@book{book:pakin:2017,
author={Scott Pakin},
title={The Comprehensive {\LaTeX{}} Symbol List},
Modified: trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos.tex 2024-12-30 00:44:07 UTC (rev 73236)
+++ trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos.tex 2024-12-30 21:18:13 UTC (rev 73237)
@@ -26,17 +26,17 @@
\usepackage[english,brazil]{babel} % brazil como padrão
+%% Font selection
+\usepackage{fontspec} % iffont carrega ele
+%\defaultfontfeatures{Ligatures=TeX}
+
\usepackage{fontsetup} % New Computer Modern Book weight
%\usepackage[olddefault]{fontsetup} % New Computer Modern regular weight
-%% Font selection
-%\usepackage{fontspec}
-%\defaultfontfeatures{Ligatures=TeX}
-
% iffont not works on LuaLaTeX. Need patch it.
% On XeLaTeX need patch too for external font
-\usepackage{iffont}
+\usepackage{iffont} % On new xelatex/lualatex, it works (no patch needed)
%\makeatletter
% \renewcommand{\@iffont at firstfont}{MS Mincho}
@@ -54,23 +54,23 @@
%\ifLuaTeX
-% patch on iffont
- \ifx \IfFontExistsTF\undefined
- %\PackageError{\jobname}{fontspec antigo}{Atualize para versão mais nova ou use XeLaTeX}
- \PackageError{\jobname}{'fontspec' antigo}{Atualize para versão mais nova}
- \fi
- % \usepackage{etoolbox} % iffont ja carregou
- \let\iffontexists\IfFontExistsTF
- \makeatletter
- \renewcommand{\@iffont at checkfont}[1]{
- \IfFontExistsTF{#1}{
- \nottoggle{@iffont at fontfound}{%
- \renewcommand{\@iffont at firstfont}{#1}
- \toggletrue{@iffont at fontfound}
- }{}
- }{\stepcounter{@iffont at fontsnotfound} }
- }
- \makeatother
+%%% patch on iffont
+%% \ifx \IfFontExistsTF\undefined
+%% %\PackageError{\jobname}{fontspec antigo}{Atualize para versão mais nova ou use XeLaTeX}
+%% \PackageError{\jobname}{'fontspec' antigo}{Atualize para versão mais nova}
+%% \fi
+%% % \usepackage{etoolbox} % iffont ja carregou
+%% \let\iffontexists\IfFontExistsTF
+%% \makeatletter
+%% \renewcommand{\@iffont at checkfont}[1]{
+%% \IfFontExistsTF{#1}{
+%% \nottoggle{@iffont at fontfound}{%
+%% \renewcommand{\@iffont at firstfont}{#1}
+%% \toggletrue{@iffont at fontfound}
+%% }{}
+%% }{\stepcounter{@iffont at fontsnotfound} }
+%% }
+%% \makeatother
%\fi
%\ifXeTeX % need file name for font outside tex tree
@@ -77,8 +77,9 @@
% \settofirstfound{\jafont}{NotoSerifCJK-Regular.ttc, msmincho.ttf, takaomincho.ttf, ipaexm.ttf, ipam.ttf}
% \settofirstfound{\jagothic}{NotoSansCJK-Bold.ttc, msgothic.ttf, takaogothic.ttf, ipaexg.ttf, ipag.ttf}
%\else % LuaLa\teX (will use font name for all)
- \settofirstfound{\jafont}{Noto Serif CJK JP, MS Mincho, TakaoMincho, IPAexMincho, IPAMincho, Hiragino Mincho Pro}
- \settofirstfound{\jagothic}{Noto Sans CJK JP, MS Gothic, TakaoGothic, IPAexGothic, IPAGothic, Hiragino Maru Gothic Pro}
+
+% \settofirstfound{\jafont}{Noto Serif CJK JP, MS Mincho, TakaoMincho, IPAexMincho, IPAMincho, Hiragino Mincho Pro}
+% \settofirstfound{\jagothic}{Noto Sans CJK JP, MS Gothic, TakaoGothic, IPAexGothic, IPAGothic, Hiragino Maru Gothic Pro}
%\fi
% DEBUG XeLaTeX
@@ -109,9 +110,24 @@
% versao antiga (2016) do fontspec ainda nao tem \IfFontExistsTF
% precisa atualizar o fontspec
-\IfFontExistsTF{\jafont}{}{\PackageError{\jobname}{Fonte japonês Mincho (\jafont) não encontrada.}{Instale um dos seguintes: Noto Serif CJK JP, MS Mincho, TakaoMincho, IPAexMincho, IPAMincho, Hiragino Mincho Pro}}
-\IfFontExistsTF{\jagothic}{}{\PackageError{\jobname}{Fonte japonês Gothic não encontrada.}{Instale um dos seguintes: Noto Sans CJK JP, MS Gothic, TakaoGothic, IPAexGothic, IPAGothic, Hiragino Maru Gothic Pro}}
+%\IfFontExistsTF{\jafont}{}{\PackageError{\jobname}{Fonte japonês Mincho (\jafont) não encontrada.}{Instale um dos seguintes: Noto Serif CJK JP, MS Mincho, TakaoMincho, IPAexMincho, IPAMincho, Hiragino Mincho Pro}}
+%\IfFontExistsTF{\jagothic}{}{\PackageError{\jobname}{Fonte japonês Gothic não encontrada.}{Instale um dos seguintes: Noto Sans CJK JP, MS Gothic, TakaoGothic, IPAexGothic, IPAGothic, Hiragino Maru Gothic Pro}}
+\def\jafontlist{Noto Serif CJK JP, MS Mincho, TakaoMincho, IPAexMincho, IPAMincho, Hiragino Mincho Pro,[lmroman12-regular]} % último da list anão é japonês
+\def\jagothicfontlist{Noto Sans CJK JP, MS Gothic, TakaoGothic, IPAexGothic, IPAGothic, Hiragino Maru Gothic Pro}
+
+\settofirstfound{\jafont}{\jafontlist}
+\settofirstfound{\jagothic}{\jagothicfontlist}
+
+%\IfFontExistsTF{\jafont}{}{\PackageError{\jobname}{Fonte japonês Mincho (\jafont) não encontrada.}{Instale um dos seguintes: \jafontlist}}
+%\IfFontExistsTF{\jagothic}{}{\PackageError{\jobname}{Fonte japonês Gothic (\jagothic) não encontrada.}{Instale um dos seguintes: \jagothicfontlist}}
+
+% usando comando \ifdefstring e % \ifdefstrequal do etoolbox que iffont já carregou
+% \ifdefstring compara expansão de comando com o string
+\ifdefstring\jafont{[lmroman12-regular]}{\PackageError{\jobname}{Fonte japonês Mincho não encontrada.}{Instale um dos seguintes: \jafontlist}}{}
+% \ifdefstrequal compara expansão de dois comandos como string
+\ifdefstrequal\jagothic\jafont{\PackageWarning{\jobname}{Fonte japonês Gothic não encontrada.}{Instale um dos seguintes: \jagothicfontlist}}{}
+
\newfontfamily{\jafamily}[BoldFont=\jagothic]{\jafont}
\newcommand{\textja}[1]{{\jafamily #1}}
@@ -185,8 +201,7 @@
\usepackage{xtab}
% implementação moderna de tabela (tblr que funciona tanto no modo texto como no modo matemático)
\usepackage{tabularray}
-\UseTblrLibrary{booktabs}
-\UseTblrLibrary{caption}
+\UseTblrLibrary{booktabs,siunitx,caption}
\usepackage{makeidx}
\makeindex
@@ -1032,8 +1047,9 @@
% Nona atualização (0.5.9): 01 de maio de 2023}
% Decima atualização (0.5.10): 08 de dezembro de 2024
% Decima primeira atualização (0.5.11): 08 de dezembro de 2024
-% Decima segunda atualização
-\date{19 de dezembro de 2024}
+% Decima segunda atualização: 19 de dezembro de 2024
+% Decima terceira atualização
+\date{29 de dezembro de 2024}
%%%%%%%%%%%%%%%%%%%%%%%
@@ -1121,7 +1137,7 @@
Capítulo~18 apresenta o uso de \XeLaTeX{} e Lua\LaTeX, considerado como a próxima geração de \LaTeX.
-Capítulo~19 apresenta a formatação no padrão ABNT.
+Capítulo~19 apresenta a formatação no padrão de Associação Brasileira de Normas Técnicas (ABNT)\index{ABNT}.
Apêndice~A é sobre símbolos básicos do \LaTeX.
@@ -6596,6 +6612,171 @@
%Existe também, a opção de usar o \texttt{pifont}\index{pifont} ou o pacote \texttt{circledsteps}
+% \usepackage{chngcntr} % não e necessário a partir de 2018/04/01
+% para usar counterwithin
+\section{Escrevendo medidas internacionais}
+
+Para escrever medidas, requer alguns cuidados tais como usar letra romana reta (por ser abreviatura da palavra), ter pequeno espaço entre valor e medida, entre outros.
+Por exemplo, $\qty{10}{\kilo\gram}$ e não $10kg$, $\qty{5}{\litre}$ e não $5l$ e assim por diante.
+
+Para facilitar a escrever unidades de medidas corretamente no documento, o \texttt{siunitx}\index{siunitx} providencia comandos para escrever na unidade internacional.
+Normalmente \texttt(siunitx) usará formatação usando a fonte do modo matemático, mas pode converter para usar a fonte do modo texto com o comando \verb+\sisetup{unit-mode=text}+.
+
+Para produzir o número rapidamente, tem o comando \verb+\num+\index{num@\verb+\num+}.
+O comando \verb+\ang+\index{ang@\verb+\ang+} gera ângulos rapidamente.
+Para exemplos a seguir, será assumido que foi carregado o pacote \texttt{siunitx} no \texttt{preamble}
+Veja o Exemplo~\ref{ex15:num}.
+
+%\begin{singlespacing}
+%\begin{LTXexample}[pos=b,caption={ex11-09.tex},label=ex:11-09]
+\begin{ltxlisting}[caption={ex15-num.tex},label=ex15:num]
+Números
+
+\num{12345.67890} \\ % espacando de 3 em 3 casas
+\num{12345,67890} \\ % ``,'' também pode ser usado para decimal
+// +- é substituido por $\pm$
+\complexnum{1 +- 2i} \\ % i é número complexo
+\num{.3e45} \\ % notacao cientifica
+\numproduct{1.654 x 2.34 x 3.430} % ``x'' vira $\times$
+
+% valor monetaria costuma ser arredondado em duas decimais
+% DE (Alemão) usa virgula para decimais também
+R\$\num[locale=DE,round-precision=2,round-mode=places]{27.3671}
+e
+R\$\num[locale=DE,round-precision=2,round-mode=places]{15}
+
+Ângulos
+
+\ang{10} \\ % grau
+\ang{5.3} \\ % grau com decimal
+\ang{-1,5} \\ % ``,"" também pode ser usado como decimal
+\ang{1;2;3} \\ % grau, minuto e segundo
+\ang{;;1} \\ % so o segundo
+\end{ltxlisting}
+%\end{LTXexample}
+%\end{singlespacing}
+
+O comando \verb+\unit+\index{unit@\verb+\unit+} produz unidade de medida de acordo com o seu parâmetro (o comando da versão 2 equivalente \verb+\si+\index{si@\verb+\si+} também continua funcionando).
+A configuração de saída pode ser efetuado pelo parâmetro opcional.
+O \verb+\unit+, assim como \verb+\num+ e \verb+\ang+, funciona tanto no modo texto como no modo matemático.
+
+Em geral, coloca-se pequeno espaço entre valor e medida.
+O comando \verb+\qty+\index{qty@\verb+\qty+} automatiza isso. O comando da versão 2 equivalente é \verb+\SI+\index{SI@\verb+\SI+} que pode ser usado quando \verb+\qty+ não está disponível como no caso de usar junto com o pacote \texttt{physics}, ou quer colocar símbolo antes do valor.
+
+Ele tem a forma
+\verb+\qty[opção]{valor}[simbolo anterior]{unidade}+
+Veja o Exemplo~\ref{ex15:si}.
+
+%\begin{singlespacing}
+%\begin{LTXexample}[pos=b,caption={ex11-09.tex, parte b},label=ex:11-09:b]
+\begin{ltxlisting}[caption={ex15-si.tex},label=ex15:si]
+Entrada literal (Neste modo, não há opção de formatação).
+
+\unit{kg.m/s^2} \\
+\unit{g_{polymer}~mol_{cat}.s^{-1}}
+
+Entrada pelo macro (permite configurar a formatação usando opção do comando ou do parâmetro do pacote).
+
+\unit{\kilo\gram\per\square\second} \\
+\unit{\gram_{polymer}\mol_{cat}\per\second}
+
+Mais exemplos\\
+\unit{\kilo\gram\metre\per\square\second} \\
+\unit{\gram\per\cubic\centi\metre} \\
+\unit{\square\volt\cubic\lumen\per\farad} \\
+\unit{\metre\squared\per\gray\cubic\lux} \\
+\unit{\henry\second}
+
+Medidas com valor
+
+\qty{1.23}{J.mol^{-1}.K^{-1}} \\ % modo textual
+\qty{.23e7}{\candela} \\ % como macros
+\qty[locale = DE]{1.345}{\coulomb\per\mole} % alemanha usa virgula como decimal também
+
+Medida não numérico
+
+\qty[parse-numbers = false]{x}{\metre\per\second}
+
+é mesmo que
+
+$x\,\unit{\metre\per\second}$
+
+% Comando da versão 2 permite colocar elemento antes do número.
+% Para este exemplo, está arredondando para duas casas decimais.
+\SI[per-mode=symbol,locale=DE,round-precision=2,round-mode=places,round-integer-to-decimal]{1.987}[R\$]{\per\kilogram} \\ % com simbolo R$ antes
+
+Colocar medida após valor usando \verb+\unit+ e
+colocar valor já com medida usando \verb+\qty+
+pode apresentar diferença no espaçamento. \\
+\unit{10\celsius} \\ % valor concatenado com medida
+\qty{10}{\celsius} % valor e medida usando macro
+\end{ltxlisting}
+%\end{LTXexample}
+%\end{singlespacing}
+
+Alguma das medidas padrão são:
+\verb+\ampere+\index{si!ampere@\verb+\ampere+}, \verb+\candela+\index{si!candela@\verb+\candela+}, \verb+\kelvin+\index{si!kelvin@\verb+\kelvin+}, \verb+\kilogram+\index{si!kilogram@\verb+\kilogram+}, \verb+metre+\index{si!metre@\verb+\metre+} ou \verb+meter+\index{si!meter@\verb+\meter+},
+\verb+\mole+\index{si!mole@\verb+\mole+}, \verb+\second+\index{si!second@\verb+\second+}, \verb+\litre+\index{si!litre@\verb+\litre+}, \verb+\celsius+\index{si!celsius@\verb+\celsius+}, \verb+\percent+\index{si!percent@\verb+\percent+}, etc que são muitas.
+Para saber mais, consulte o manual do pacote.
+
+Para conversão de medidas,
+\verb+\giga+\index{si!giga@\verb+\giga+}, \verb+\mega+\index{si!mega@\verb+\mega+}, \verb+\kilo+\index{si!kilo@\verb+\kilo+}, \verb+\hecto+\index{si!hecto@\verb+\hecto+}, \verb+\deca+\index{si!deca@\verb+\deca+}, \verb+\deci+\index{si!deci@\verb+\deci+}, \verb+\centi+\index{si!centi@\verb+\centi+}, \verb+\milli+\index{si!milli@\verb+\milli+}, \verb+\micro+\index{si!micro@\verb+\micro+}, \verb+\nano+\index{si!nano@\verb+\nano+}, etc. são disponíveis.
+
+Exemplo: \verb+\qty{20}{\kilo\gram}+ e mesmo que \verb+\qty{20}{\kilogram}+.
+
+Para operar, tem o \texttt{per, square}, etc.
+
+\verb+\qty{30}{\kilo\meter\per\square\second}+
+é mesmo que
+\verb+\qty{30}{\kilo\meter/\second^2}+
+no modo padrão, mas o segundo não consegue controlar a formatação por usar forma literal em ``/'' e ``\verb+^2+''.
+
+A configuração geral de formatação pode ser feito pela opção do pacote ou pelo comando \verb+\sisetup+\index{sisetup@\verb+\sisetup+}, mas também pode especificar localmente como no Exemplo~\ref{ex15:sisetup}.
+
+%\begin{singlespacing}
+%\begin{LTXexample}[pos=b,caption={ex11-09.tex, parte c},label=ex:11-09:c]
+\begin{ltxlisting}[caption={ex15-sisetup.tex},label=ex15:sisetup]
+\qty[mode=text]{30}{\kilo\meter\per\square\second}
+
+\qty[per-mode=power]{30}{\kilo\meter\per\square\second}
+
+\qty[per-mode=symbol]{30}{\kilo\meter\per\square\second}
+
+\qty[per-mode=fraction]{30}{\kilo\meter\per\square\second}
+\end{ltxlisting}
+%\end{LTXexample}
+%\end{singlespacing}
+
+A nova versão, apesar de continuar com os comandos da versão 2, separa o comando para números complexos e com o produto, como pode ver no exemplo de \verb+\num+ (Exemplo~\ref{ex15:num}). Se o documento já está escrita usando os comando da versão 2 (sem esta separação), poderá carregar no modo de versão 2, com o comando \verb+\usepackage{siunitx}[=v2]+.
+
+\section{Calculando o valor de uma função}
+Para efetuar cálculo de funções matemáticas no \LaTeX, como no caso de tabelar funções nos pontos dados, podemos usar o pacote \texttt{xfp}\index{xfp} ou \texttt{numerica}\index{numerica}. O pacote \texttt{xfp} evalua a expressão matemática normalmente, enquanto que \texttt{numérica} evalua a expressão escrita na forma \TeX, permitindo que mesma expressão pode ser usado tanto para evaluar, como para exibir. Além de \texttt{numerica} ter mais recursos, o \texttt{numerica-tables}\index{numerica-tables} permite tabelar funções rapidamente.
+
+Veja o Exemplo~\ref{ex15:xfp-e-numerica}.
+
+%\begin{singlespacing}
+%\begin{LTXexample}[pos=b,caption={ex11-08.tex},label=ex:11-08]
+\begin{ltxlisting}[caption={ex15-xfp-e-numerica.tex},label=ex15:xfp-e-numerica]
+%Supõe carregada seguintes pacotes: xfp, numerica e numerica-tables
+Expressão a ser evaluada: $\sin(\frac{\pi}{4})$
+
+Valor pelo \texttt{xfp} é $\fpeval{sin(pi/4)}$
+
+Valor pelo \texttt{numerica} (com configuração padrão) é $\eval{\sin(\frac{\pi}{4})}$,
+
+Tabelando função com \texttt{numerica-tables}
+
+\tabulate[rvar=x,rstep={\frac{\pi}{10}},rows={10+1}]
+{\sin x}[x=0]
+
+\end{ltxlisting}
+%\end{LTXexample}
+%\end{singlespacing}
+
+% A nova versão (2024) de numerica-tables suporta transpor a tabela
+%Forma transposta: Precisa testar, mas ele precisa que outros pacotes tabém sejam atualizadas.
+%\tabulate[rvar=x,rstep={\frac{\pi}{10}},rows={10+1},transpose]{\sin x}[x=0]
+
\section{Controle das figuras e similares}
As vezes queremos que o elemento flutuante (figuras e tabelas) sejam inseridas exatamente no lugar onde foi colocado.
@@ -6713,6 +6894,57 @@
%
%rotating (sideways,sidewaysfigure,sidewaystable) ou lscape/pdflscape? OK
+\section{Criando ambientes tipo figuras e tabelas}
+
+O pacote \texttt{float}\index{float} permite criar elemento flutuante do tipo figuras e tabelas.
+O novo elemento flutuante é crido pelo comando \verb+\newfloat+\index{newfloat@\verb+\newfloat+}.
+O código
+\begin{singlespacing}
+%\begin{lstlisting}[caption={ex11-06.tex, parte d},label=ex:11-06:d]
+\begin{lstlisting}
+\newfloat{algorithm}{tbp}{loa}%[section]
+\floatname{algorithm}{Algorítmo}
+\end{lstlisting}
+\end{singlespacing}
+cria o ambiente \texttt{algorithm} que auto posiciona e aceita \verb+\caption+ dentro dele para enumerar e colocar o título. Veja o exemplo~\ref{ex15:newfloat}.
+
+\begin{singlespacing}
+%\begin{lstlisting}[caption={ex11-06.tex, parte d},label=ex:11-06:d]
+\begin{lstlisting}[caption={ex15-newfloat.tex},label=ex15:newfloat]
+\begin{algorithm}
+\caption{Primeiro algorítimo}
+Algorítimo aqui.
+\end{algorithm}
+\end{lstlisting}
+\end{singlespacing}
+%
+\begin{ltxlistingout}
+\begin{center}Algorítmo 1: Primeiro algorítimo\end{center}
+Algorítimo aqui.
+\end{ltxlistingout}
+
+A lista do novo elemento flutuante é criado pelo comando \verb+\listof+. Para listar algorítmos criados acima, usa-se o comando \verb+\listof{algorithm}{Lista de algorítmos}+
+
+Note que o elemento flutuante não pode dividir em páginas, sendo recomendado para figuras ou elementos menores. No caso do exemplo, o algorítimo pode ser maior, sendo recomendado dividir em páginas, como ocorre com a tabela longa. Para criar o ambiente do estilo \texttt{longtable} (tabela longa) na qual pode quebrar entre páginas, mas ficam enumeradas como os elementos flutuantes, usa-se o pacote \texttt{caption}\index{caption} que permite controlar títulos dos elementos flutuantes e similares.
+O código
+%
+\begin{singlespacing}
+%\begin{lstlisting}[caption={ex11-06.tex, parte d},label=ex:11-06:d]
+\begin{lstlisting}
+% definindo o tipo algorítimo
+\DeclareCaptionType{algorithmtype}[Algorítimo][Lista de algorítimos]
+% ambiente algorítmo configura o caption para tipo algorítimo
+\newenvironment{algorithm}{\captionsetup{type=algorithmtype}}{}
+%{\captionsetup{type=algorithmtype,justification=centering}}{}
+% atalho para lista de algoritmos
+\newcommand\listofalgorithms\listofalgorithmtypes
+% contador subordinado a capítulo
+\counterwithin{algorithmtype}{chapter}
+\end{lstlisting}
+\end{singlespacing}
+%
+Cria o ambiente \texttt{algorithm} similar a \texttt{longtable}.
+
\section{Melhorando as tabelas}
O pacote \texttt{booktabs}\index{booktabs} oferece comandos para traçar linhas horizontais com espaçamento ajustado adequadamente. Use \verb+\toprule+\index{toprule@\verb+\toprule+} para linha acima da tabela,
@@ -6737,7 +6969,6 @@
total & R\$6,70 \\
\bottomrule
\end{tabular}
-\legend{Fonte: elaboração do autor}
\end{center}
\end{table}
\end{ltxlisting}
@@ -6744,66 +6975,70 @@
%\end{LTXexample}
%\end{singlespacing}
-O comando \verb+\legend+ é da classe \texttt{abntex2}, mas se quiser usar sem a classe \texttt{abntex2}, basta colocar o comando
-\begin{verbatim}
-\providecommand{\legend}[1]{\par \medskip #1 \smallskip}
-\end{verbatim}
-ou similar no preâmbulo do documento para definir o comando.
+%O comando \verb+\legend+ é da classe \texttt{abntex2}, mas se quiser usar sem a classe \texttt{abntex2}, basta colocar o comando
+%\begin{verbatim}
+%\providecommand{\legend}[1]{\par \medskip #1 \smallskip}
+%\end{verbatim}
+%ou similar no preâmbulo do documento para definir o comando.
+%
+%Para tabelas longas simples, poderá usar o pacote \texttt{longtable}, mas para tabelas longas mais sofisticadas como exigido pelo \texttt{ABNT}, costuma usar o pacote \texttt{xtab}\index{xtab} que implementa o ambiente \texttt{xtabular}\index{xtabular}
+%
+%A Tabela~\ref{ex15:xtab} é tabela que ocupa várias páginas.
+%Note que o termo ``continua'' (caso ocupar duas ou mais páginas), ``continuação'' (caso ocupar três páginas) e ``conclusão'' (caso ocupar duas ou mais páginas) no cabeçalho da tabela, conforme ABNT.
+%A Tabela~\ref{ex15:xtab} foi criado pelo ambiente \texttt{xtabular} do pacote \texttt{xtab} que requer duas compilações seguidas para ajustar corretamente.
+%Veja a Tablea~\ref{ex15:xtab}.
+%
+%%\begin{singlespacing}
+%%\begin{LTXexample}[pos=b,caption={ex11-06.tex, parte c},label=ex:11-06:c]
+%\begin{ltxlisting}[caption={ex15-xtab.tex},label=ex15:xtab]
+%\begin{center}
+%\topcaption{Inflação (IPCA) e juro de poupança de 2022}\label{tab:inflacao}
+%\tablefirsthead{ % cabeçalho da primeira página
+% % \PWSTlastpage é criado pelo \newcount e não pelo \newcounter (não tem prefixo 'c@')
+% \ifnum\PWSTlastpage > 1 % Se a tabela ocupar mais de uma página
+% \multicolumn{3}{r}{(continua)}\\
+% \fi
+% \toprule
+% & \multicolumn{2}{c}{Índice} \\ \cmidrule{2-3}
+% \textbf{Mês} & \textbf{Inflação} & \textbf{Poupança}\\ \midrule}
+%\tablehead{% cabeçalho das páginas do meio
+% \multicolumn{3}{r}{(continuação)}\\ \toprule
+% & \multicolumn{2}{c}{Índice} \\ \cmidrule{2-3}
+% \textbf{Mês} & \textbf{Inflação} & \textbf{Poupança} \\ \midrule}
+%\tablelasthead{ % cabeçalho da última página
+% \multicolumn{3}{r}{(conclusão)}\\ \toprule
+% & \multicolumn{2}{c}{Índice} \\ \cmidrule{2-3}
+% \textbf{Mês} & \textbf{Inflação} & \textbf{Poupança} \\ \midrule}
+%\begin{xtabular}{lrc}
+%Janeiro & 0,54 & 0,5608 \\
+%Fevereiro & 1,01 & 0,5000 \\
+%Março & 1,62 & 0,5976 \\
+%Abril & 1,06 & 0,5558 \\
+%Maio & 0,47 & 0,6671 \\
+%Junho & 0,67 & 0,6491 \\
+%Julho & -0,68 & 0,6639 \\
+%Agosto & -0,36 & 0,7421 \\
+%Setembro & -0,29 & 0,6814 \\
+%Outubro & 0,59 & 0,6501 \\
+%Novembro & 0,41 & 0,6515 \\
+%Dezembro & 0,62 & 0,7082 \\
+%\midrule
+%Acumulado do ano & 5,79 & 7,8997 \\
+%\bottomrule
+%\end{xtabular}
+%
+%\legend{Fonte: \url{https://blog.nubank.com.br/ipca-2022/},
+% \url{https://brasilindicadores.com.br/poupanca/}
+%}
+%\end{center}
+%\end{ltxlisting}
+%%\end{LTXexample}
+%%\end{singlespacing}
+%
+% NOTA: para ABNT
+% O \texttt{xtabular} não tem opção padrão para repetir titulo da tabela entre páginas, o que é exigido pelo IBGE. Deverá usar o \texttt{longtblr} do pacote \texttt{tabularray}
+%
-Para tabelas longas simples, poderá usar o pacote \texttt{longtable}, mas para tabelas longas mais sofisticadas como exigido pelo \texttt{ABNT}, costuma usar o pacote \texttt{xtab}\index{xtab} que implementa o ambiente \texttt{xtabular}\index{xtabular}
-
-A Tabela~\ref{ex15:xtab} é tabela que ocupa várias páginas.
-Note que o termo ``continua'' (caso ocupar duas ou mais páginas), ``continuação'' (caso ocupar três páginas) e ``conclusão'' (caso ocupar duas ou mais páginas) no cabeçalho da tabela, conforme ABNT.
-A Tabela~\ref{ex15:xtab} foi criado pelo ambiente \texttt{xtabular} do pacote \texttt{xtab} que requer duas compilações seguidas para ajustar corretamente.
-Veja a Tablea~\ref{ex15:xtab}.
-
-%\begin{singlespacing}
-%\begin{LTXexample}[pos=b,caption={ex11-06.tex, parte c},label=ex:11-06:c]
-\begin{ltxlisting}[caption={ex15-xtab.tex},label=ex15:xtab]
-\begin{center}
-\topcaption{Inflação (IPCA) e juro de poupança de 2022}\label{tab:inflacao}
-\tablefirsthead{ % cabeçalho da primeira página
- % \PWSTlastpage é criado pelo \newcount e não pelo \newcounter (não tem prefixo 'c@')
- \ifnum\PWSTlastpage > 1 % Se a tabela ocupar mais de uma página
- \multicolumn{3}{r}{(continua)}\\
- \fi
- \toprule
- & \multicolumn{2}{c}{Índice} \\ \cmidrule{2-3}
- \textbf{Mês} & \textbf{Inflação} & \textbf{Poupança}\\ \midrule}
-\tablehead{% cabeçalho das páginas do meio
- \multicolumn{3}{r}{(continuação)}\\ \toprule
- & \multicolumn{2}{c}{Índice} \\ \cmidrule{2-3}
- \textbf{Mês} & \textbf{Inflação} & \textbf{Poupança} \\ \midrule}
-\tablelasthead{ % cabeçalho da última página
- \multicolumn{3}{r}{(conclusão)}\\ \toprule
- & \multicolumn{2}{c}{Índice} \\ \cmidrule{2-3}
- \textbf{Mês} & \textbf{Inflação} & \textbf{Poupança} \\ \midrule}
-\begin{xtabular}{lrc}
-Janeiro & 0,54 & 0,5608 \\
-Fevereiro & 1,01 & 0,5000 \\
-Março & 1,62 & 0,5976 \\
-Abril & 1,06 & 0,5558 \\
-Maio & 0,47 & 0,6671 \\
-Junho & 0,67 & 0,6491 \\
-Julho & -0,68 & 0,6639 \\
-Agosto & -0,36 & 0,7421 \\
-Setembro & -0,29 & 0,6814 \\
-Outubro & 0,59 & 0,6501 \\
-Novembro & 0,41 & 0,6515 \\
-Dezembro & 0,62 & 0,7082 \\
-\midrule
-Acumulado do ano & 5,79 & 7,8997 \\
-\bottomrule
-\end{xtabular}
-
-\legend{Fonte: \url{https://blog.nubank.com.br/ipca-2022/},
- \url{https://brasilindicadores.com.br/poupanca/}
-}
-\end{center}
-\end{ltxlisting}
-%\end{LTXexample}
-%\end{singlespacing}
-
Para colorir linhas e ou células da tabela de forma simples, poderá carregar o pacote \texttt{xcolor} com opção \texttt{table} colocando o código
\begin{singlespacing}
\begin{lstlisting}
@@ -6848,7 +7083,6 @@
total & R\$8,70 \\
\bottomrule
\end{tabular}
-\legend{Fonte: elaboração do autor}
\end{center}
\end{table}
\end{ltxlisting}
@@ -6857,9 +7091,10 @@
Para configuração de cores mais sofisticada, veja o manual do pacote \texttt{colortbl}\index{colortbl}.
-Para implementação mais moderna da tabela, poderá usar o ambiente \texttt{tblr}\index{tblr} do pacote \texttt{tabularray}\index{tabularray} que permite incorporar recursos do \texttt{tabularx} como do \texttt{colortbl}, entre outros. Veja o Exemplo~\ref{ex15:table:tblr}. Note que \texttt{tblr} funciona também dentro da fórmula, isto é, pode ser usado como \texttt{array}. Para usar pacotes adicionais como \texttt{booktabs}, \texttt{caption}, etc., usa-se o comando \verb+\UseTblrLibrary+ para que seja configurado devidamente.
-Colocando o \texttt{preamble}
+Para implementação mais moderna da tabela, poderá usar o ambiente \texttt{tblr}\index{tblr} do pacote \texttt{tabularray}\index{tabularray} que permite incorporar recursos do \texttt{tabularx} como do \texttt{colortbl}, entre outros. Veja o Exemplo~\ref{ex15:table:tblr}. Note que \texttt{tblr} funciona também dentro da fórmula, isto é, pode ser usado como \texttt{array}. Para usar pacotes adicionais como \texttt{booktabs}, \texttt{diagbox}, etc., usa-se o comando \verb+\UseTblrLibrary+ para que seja configurado devidamente.
+Colocando no \texttt{preamble}
+
\begin{singlespacing}
\begin{lstlisting}
\usepackage{xcolor}
@@ -6875,21 +7110,21 @@
\begin{center}
\caption{Tabela com \texttt{tabularray}}\label{tab:tabulaary}
\begin{tblr}{ %configurações
-colspec = {rX}, % alinhamentos/espaçamentos das colunas
+colspec = {rX}, % alinhamentos/espaçamentos das colunas: l->left, r-> right, c->center, X->automatic
row{odd} = {gray!15}, % cor da linha impar
%row{even} = {white}, % cor da linha par
-row{1} = {font=\bfseries\sffamily},
-row{2-Z} = {font=\sffamily},
-row{Z} = {fg=blue},
+row{1} = {font=\bfseries\sffamily}, % primeira linha
+row{2-Z} = {font=\sffamily}, % linha 2 até a última linha
+row{Z} = {fg=blue}, % última linha
}
% conteúdo da tabela
produto & preço \\
\midrule
- cenouras (500g) & R\$0,50 \\
- cogumelos (vidro de 500g) & R\$5,00 \\
- batata (1Kg) & R\$1,20 \\
- beterraba (1Kg) & R\$1,50 \\
- alface (1 maço) & R\$0,50 \\
+ cenouras (500g) & R\$0,50 \\
+ cogumelos (vidro de 500g) & R\$5,00 \\
+ batata (1Kg) & R\$1,20 \\
+ beterraba (1Kg) & R\$1,50 \\
+ alface (1 maço) & R\$0,50 \\
\bottomrule
total & R\$8,70 \\
\end{tblr}
@@ -6897,8 +7132,9 @@
\end{table}
\end{ltxlisting}
-O \texttt{tablarray} implementa também a funcionalidade da tabela longa correspondente que pode ser usado pelo ambiente \texttt{longtblr},% tblr com a opção \texttt{long} não ficará mesmo que longtblr
-mas não consegue configurar perfeitamente para \texttt{ABNT} por não conseguir saber se a tabela cabe ou não em uma única página (2024). No caso de tabela ocupar mais de uma página, poderá efetuar a configuração
+O \texttt{tablarray} implementa também a funcionalidade da tabela longa correspondente que pode ser usado pelo ambiente \texttt{longtblr}, que é mesmo que \texttt{tblr} com a primeira opção opcional como \texttt{long}, % tblr com a opção \texttt{long} não ficará mesmo que longtblr
+mas não consegue configurar perfeitamente para \texttt{ABNT} somente com comandos padrão, por não conseguir saber se a tabela cabe ou não em uma única página (2024) (Para ajustar como ABNT, veja a Seção~\ref{sec:abnt:tabela} do Capítulo~\ref{cap:abnt}, na página~\pageref{sec:abnt:tabela}).
+Mas, se a tabela ocupar mais de uma página, poderá efetuar a configuração similar a \texttt{ABNT} como segue.
\begin{singlespacing}
\begin{lstlisting}
@@ -6907,9 +7143,9 @@
\usepackage{tabularray} % tabularray
\UseTblrLibrary{booktabs} % adiciona booktabs
% configurando
-\DefTblrTemplate{firsthead-text}{default}{~(continua)} % primeira página
-\DefTblrTemplate{lasthead-text}{default}{~(conclusão)} %última página
-\DefTblrTemplate{conthead-text}{default}{~(continuação)} % páginas do meio
+\DefTblrTemplate{firsthead-text}{default}{\par~\hfill(continua)} % primeira página
+\DefTblrTemplate{lasthead-text}{default}{\par~\hfill(conclusão)} %última página
+\DefTblrTemplate{conthead-text}{default}{\par~\hfill(continuação)} % páginas do meio
% desativando os rodapés
\DefTblrTemplate{firstfoot,middlefoot}{default}{}
% redefinindo o título da primeira página
@@ -6917,23 +7153,38 @@
\UseTblrTemplate{caption-tag}{default}
\UseTblrTemplate{caption-sep}{default}
\UseTblrTemplate{caption-text}{default}
+ \UseTblrTemplate{firsthead-text}{default} % acrescentar o firsthead-text
}
+\DefTblrTemplate{capcont}{default}{ % redefinindo, para \par funcionar (senão, será ignorado)
+ \UseTblrTemplate{caption-tag}{default}
+ \UseTblrTemplate{caption-sep}{default}
+ \UseTblrTemplate{caption-text}{default}
+ \UseTblrTemplate{conthead-text}{default}
+}
% redefinindo o título da última página
\DefTblrTemplate{lasthead}{default}{
\UseTblrTemplate{caption-tag}{default}
\UseTblrTemplate{caption-sep}{default}
\UseTblrTemplate{caption-text}{default}
- \UseTblrTemplate{lasthead-text}{default} % acrescenttar o lasthead-text
+ \UseTblrTemplate{lasthead-text}{default} % acrescentar o lasthead-text
}
% último rodapé para inserir fonte
\DefTblrTemplate{lastfoot-text}{default}{} % inicialmente vazio
-\DefTblrTemplate{lastfoot}{default}{ % rodapé d aúltima página
+\DefTblrTemplate{lastfoot}{default}{ % rodapé da última página
\UseTblrTemplate{lastfoot-text}{default} % colocar o lastfoot-text
}
+% tamanho das fontes
+\SetTblrStyle{firsthead-text,lasthead-text,conthead-text}{\footnotesize}
+\SetTblrStyle{caption,lasthead,capcont}{\normalsize}
+\SetTblrStyle{lastfoot}{\footnotesize}
\end{lstlisting}
\end{singlespacing}
-no \texttt{preamble} para que a tabela do Exemplo~\ref{ex15:table:longtblr} fique compatível como \texttt{ABNT}. Note que \verb+\legend+ é o comando de \texttt{ABNTeX2}. Se não estiver usando o \texttt{ABNTeX2}, deverá substituir com outra, ou providenciar no \texttt{preamble}.
+no \texttt{preamble} para que a tabela do Exemplo~\ref{ex15:table:longtblr} fique compatível como \texttt{ABNT}. Note que \verb+\legend+ é o comando de \texttt{memoir} usado pelo \texttt{ABNTeX2}. Se não estiver usando o \texttt{ABNTeX2} ou \texttt{memoir}, deverá substituir com outra, ou providenciar algo como
+\begin{lstlisting}
+\providecommand{\legend}[1]{\par \medskip #1 \smallskip}
+\end{lstlisting}
+no \texttt{preamble}.
\begin{singlespacing}
\begin{lstlisting}[caption={ex15-table-longtblr.tex},label=ex15:table:longtblr]
@@ -6948,13 +7199,13 @@
{
%theme=default, % default é tema padrão
colspec = {XXX}, % colunas de largura automatica
- rowhead = 1, % primeira linha será repatida em todas páginas
+ rowhead = 1, % primeira linha será repetida em todas páginas
row{1} = {font=\bfseries}, % linha de título
- row{even} = {gray!50}, % página par em cinza
+ row{even} = {gray!15}, % página par em cinza
row{Z} = {font=\bfseries}, % última linha
}
\toprule
-Mês & Inglação & Poupança \\
+Mês & Inflação & Poupança \\
\midrule
Janeiro & 0,54 & 0,5608 \\
Fevereiro & 1,01 & 0,5000 \\
@@ -6974,225 +7225,89 @@
\end{lstlisting}
\end{singlespacing}
+% onde \verb+\legend+ é o comando da classe \texttt{abntex2}.
+
Observe que, nos argumentos dos comandos de configuração, o espaço serão eliminados, exceto quando estiver dentro do outro comando. Isto melhor a precisão dos cálculos necessários. Assim, usa-se o espaço não quebrável (``\verb+~+'').
-
-\section{Criando ambientes tipo figuras e tabelas}
+O pacote \texttt{tabularray} também disponibiliza o ambiente \texttt{talltblr}\index{talltblr} que pode ser usado dentro do ambiente \texttt{figure}, mas que aceitam os mesmos parâmetros do \texttt{longtblr}, permitindo, por exemplo, colocar rodapé da tabela, entre outros.
-O pacote \texttt{float}\index{float} permite criar elemento flutuante do tipo figuras e tabelas.
-O novo elemento flutuante é crido pelo comando \verb+\newfloat+\index{newfloat@\verb+\newfloat+}.
-O código
-\begin{singlespacing}
-%\begin{lstlisting}[caption={ex11-06.tex, parte d},label=ex:11-06:d]
-\begin{lstlisting}
-\newfloat{algorithm}{tbp}{loa}%[section]
-\floatname{algorithm}{Algorítmo}
-\end{lstlisting}
-\end{singlespacing}
-cria o ambiente \texttt{algorithm} que auto posiciona e aceita \verb+\caption+ dentro dele para enumerar e colocar o título. Veja o exemplo~\ref{ex15:newfloat}.
+Com o uso de \texttt{siunitx}, poderá lidar com tabelas que tem números flutuantes\index{tabelas!com números}, como no Exemplo~\ref{ex15:siunitx:table}.
-\begin{singlespacing}
-%\begin{lstlisting}[caption={ex11-06.tex, parte d},label=ex:11-06:d]
-\begin{lstlisting}[caption={ex15-newfloat.tex},label=ex15:newfloat]
-\begin{algorithm}
-\caption{Primeiro algorítimo}
-Algorítimo aqui.
-\end{algorithm}
-\end{lstlisting}
-\end{singlespacing}
+%\begin{singlespacing}
+%\begin{LTXexample}[pos=b,caption={ex11-06.tex, parte c},label=ex:11-06:c]
+\begin{ltxlisting}[caption={ex15-siunitx-table.tex},label=ex15:siunitx:table]
+% não funciona?
%
-\begin{ltxlistingout}
-\begin{center}Algorítmo 1: Primeiro algorítimo\end{center}
-Algorítimo aqui.
-\end{ltxlistingout}
-
-A lista do novo elemento flutuante é criado pelo comando \verb+\listof+. Para listar algorítmos criados acima, usa-se o comando \verb+\listof{algorithm}{Lista de algorítmos}+
-
-Note que o elemento flutuante não pode dividir em páginas, sendo recomendado para figuras ou elementos menores. No caso do exemplo, o algorítimo pode ser maior, sendo recomendado dividir em páginas, como ocorre com a tabela longa. Para criar o ambiente do estilo \texttt{longtable} (tabela longa) na qual pode quebrar entre páginas, mas ficam enumeradas como os elementos flutuantes, usa-se o pacote \texttt{caption}\index{caption} que permite controlar títulos dos elementos flutuantes e similares.
-O código
-%
-\begin{singlespacing}
-%\begin{lstlisting}[caption={ex11-06.tex, parte d},label=ex:11-06:d]
-\begin{lstlisting}
-% definindo o tipo algorítimo
-\DeclareCaptionType{algorithmtype}[Algorítimo][Lista de algorítimos]
-% ambiente algorítmo configura o caption para tipo algorítimo
-\newenvironment{algorithm}{\captionsetup{type=algorithmtype}}{}
-%{\captionsetup{type=algorithmtype,justification=centering}}{}
-% atalho para lista de algoritmos
-\newcommand\listofalgorithms\listofalgorithmtypes
-% contador subordinado a capítulo
-\counterwithin{algorithmtype}{chapter}
-\end{lstlisting}
-\end{singlespacing}
-%
-Cria o ambiente \texttt{algorithm} similar a \texttt{longtable}.
-
-% \usepackage{chngcntr} % não e necessário a partir de 2018/04/01
-% para usar counterwithin
-\section{Escrevendo medidas internacionais}
-
-Para escrever medidas, requer alguns cuidados tais como usar letra romana reta (por ser abreviatura da palavra), ter pequeno espaço entre valor e medida, entre outros.
-Por exemplo, $\qty{10}{\kilo\gram}$ e não $10kg$, $\qty{5}{\litre}$ e não $5l$ e assim por diante.
-
-Para facilitar a escrever unidades de medidas corretamente no documento, o \texttt{siunitx}\index{siunitx} providencia comandos para escrever na unidade internacional.
-Normalmente \texttt(siunitx) usará formatação usando a fonte do modo matemático, mas pode converter para usar a fonte do modo texto com o comando \verb+\sisetup{unit-mode=text}+.
-
-Para produzir o número rapidamente, tem o comando \verb+\num+\index{num@\verb+\num+}.
-O comando \verb+\ang+\index{ang@\verb+\ang+} gera ângulos rapidamente.
-Para exemplos a seguir, será assumido que foi carregado o pacote \texttt{siunitx} no \texttt{preamble}
-Veja o Exemplo~\ref{ex15:num}.
-
-%\begin{singlespacing}
-%\begin{LTXexample}[pos=b,caption={ex11-09.tex},label=ex:11-09]
-\begin{ltxlisting}[caption={ex15-num.tex},label=ex15:num]
-Números
-
-\num{12345.67890} \\ % espacando de 3 em 3 casas
-\num{12345,67890} \\ % ``,'' também pode ser usado para decimal
-// +- é substituido por $\pm$
-\complexnum{1 +- 2i} \\ % i é número complexo
-\num{.3e45} \\ % notacao cientifica
-\numproduct{1.654 x 2.34 x 3.430} % ``x'' vira $\times$
-
-% valor monetaria costuma ser arredondado em duas decimais
-% DE (Alemão) usa virgula para decimais também
-R\$\num[locale=DE,round-precision=2,round-mode=places]{27.3671}
-e
-R\$\num[locale=DE,round-precision=2,round-mode=places]{15}
-
-Ângulos
-
-\ang{10} \\ % grau
-\ang{5.3} \\ % grau com decimal
-\ang{-1,5} \\ % ``,"" também pode ser usado como decimal
-\ang{1;2;3} \\ % grau, minuto e segundo
-\ang{;;1} \\ % so o segundo
+\begin{table}[hbp!]
+\begin{center}
+\caption{Tabela com \texttt{siunitx}}\label{tab:siunitx}
+\medskip
+\begin{tblr}
+{
+ colspec = { X X[r, si={locale=DE}] },
+ row{1} = {font=\bfseries}, % linha de título
+ row{even} = {gray!15}, % página par em cinza
+ row{Z} = {font=\bfseries,white}, % última linha
+}
+\toprule
+ produto & \text{preço} \\
+\midrule
+ cenouras (\qty{500}{\gram}) & R\$0.50 \\
+ cogumelos (vidro de \qty{500}{\gram}) & R\$5.00 \\
+ batata (\qty{1}{\kilogram}) & R\$1.20 \\
+\midrule
+ total & R\$6.70 \\
+\bottomrule
+\end{tblr}
+\end{center}
+\end{table}
\end{ltxlisting}
%\end{LTXexample}
%\end{singlespacing}
-O comando \verb+\unit+\index{unit@\verb+\unit+} produz unidade de medida de acordo com o seu parâmetro (o comando da versão 2 equivalente \verb+\si+\index{si@\verb+\si+} também continua funcionando).
-A configuração de saída pode ser efetuado pelo parâmetro opcional.
-O \verb+\unit+, assim como \verb+\num+ e \verb+\ang+, funciona tanto no modo texto como no modo matemático.
+No caso do ambiente \texttt{tabular}, use a especificação da coluna ``S''. O exemplo anterior usa o pacote \texttt{tabularray}, com o comando adicional \verb+\UseTblrLibrary{booktabs,siunitx}+ para configurar o uso de \texttt{booktabs} e \texttt{siunitx}.
-Em geral, coloca-se pequeno espaço entre valor e medida.
-O comando \verb+\qty+\index{qty@\verb+\qty+} automatiza isso. O comando da versão 2 equivalente é \verb+\SI+\index{SI@\verb+\SI+} que pode ser usado quando \verb+\qty+ não está disponível como no caso de usar junto com o pacote \texttt{physics}, ou quer colocar símbolo antes do valor.
+Nas colunas que usam o \texttt{siunitx}, deverá tomar cuidado quando tem o caractere ``e'' que é uado para notação científica dos números (na qual tenta interpretar como número). Tais colunas no ambiente \texttt{tabular}, basta colocar entre chaves para prevenir que seja interpretado como número, mas no ambiente \texttt{tblr} e \texttt{longtblr} do \texttt{tabularray}, deverá ficar dentro do comando \verb+\text+, o que requer cuidados.
-Ele tem a forma
-\verb+\qty[opção]{valor}[simbolo anterior]{unidade}+
-Veja o Exemplo~\ref{ex15:si}.
+Note que, com o uso de localidade ``DE'' (Alemão) na coluna de \texttt{siunitx}, os decimais serão convertidos automaticamente para virgula em vez do ponto.
+Se quer alinhar devidamente nos decimais, deverá usar mais opções para ``si'', como no Exemplo~\ref{ex15:siunitx:long:table}, cuja saída foi omitida. Casos como estes que requer vários parâmetros, poderá configurar com \verb+\sisetup+\index{sisetup@\verb+\sisetup+} antes da tabela, lembrando que o efeito do \verb+\sisetup+ continuará até que seja reconfigurado novamente.
-%\begin{singlespacing}
-%\begin{LTXexample}[pos=b,caption={ex11-09.tex, parte b},label=ex:11-09:b]
-\begin{ltxlisting}[caption={ex15-si.tex},label=ex15:si]
-Entrada literal (Neste modo, não há opção de formatação).
+\begin{singlespacing}
+\begin{lstlisting}[caption={ex15-siunitx-long-table.tex},label=ex15:siunitx:long:table]
+\sisetup{
+ locale=DE, % Alemão: virgula como decimal
+ table-format=4.2, % 4 digitos, 2 digitos decimais
+ table-number-alignment=center % alinhar no decimal
+}
+\begin{longtblr}
+[%
+ caption = {Tabela longa}, % titulo
+ label={tab:longa}, % rotulo para referências cruzadas
+]
+{
+ colspec = {XX[r,si]}, % X é largura automatica. Segundo X tem como parâmetro opcional r (direita) e si (número usando pacote siunitx)
+ rowhead = 1, % primeira linha será repatida em todas páginas
+ row{1} = {font=\bfseries}, % linha de título
+ row{even} = {gray!50}, % linhas par em cinza
+ row{Z} = {font=\bfseries,white}, % última linha
+}
+\toprule
+ texto & \text{número} \\ \midrule
+ linha 1 & 1.1 \\ % \midrule
+ linha 2 & 2.2 \\ % \midrule
+ linha 3 & 3.3 \\ % \midrule
+ linha 4 & 4.4 \\ % \midrule
+ linha 5 & 5.5 \\ % \midrule
+ linha 6 & 6.6 \\ % \midrule
+ linha 7 & 7.7 \\ % \midrule
+ linha 8 & 8.8 \\ % \midrule
+ linha 9 & 9.9 \\ % \midrule
+ linha 10 & 10.10 \\ % \midrule
+ linha 11 & 11.11 \\
+ \bottomrule
+ \end{longtblr}
+\end{lstlisting}
+\end{singlespacing}
-\unit{kg.m/s^2} \\
-\unit{g_{polymer}~mol_{cat}.s^{-1}}
-
-Entrada pelo macro (permite configurar a formatação usando opção do comando ou do parâmetro do pacote).
-
-\unit{\kilo\gram\per\square\second} \\
-\unit{\gram_{polymer}\mol_{cat}\per\second}
-
-Mais exemplos\\
-\unit{\kilo\gram\metre\per\square\second} \\
-\unit{\gram\per\cubic\centi\metre} \\
-\unit{\square\volt\cubic\lumen\per\farad} \\
-\unit{\metre\squared\per\gray\cubic\lux} \\
-\unit{\henry\second}
-
-Medidas com valor
-
-\qty{1.23}{J.mol^{-1}.K^{-1}} \\ % modo textual
-\qty{.23e7}{\candela} \\ % como macros
-\qty[locale = DE]{1.345}{\coulomb\per\mole} % alemanha usa virgula como decimal também
-
-Medida não numérico
-
-\qty[parse-numbers = false]{x}{\metre\per\second}
-
-é mesmo que
-
-$x\,\unit{\metre\per\second}$
-
-% Comando da versão 2 permite colocar elemento antes do número.
-% Para este exemplo, está arredondando para duas casas decimais.
-\SI[per-mode=symbol,locale=DE,round-precision=2,round-mode=places,round-integer-to-decimal]{1.987}[R\$]{\per\kilogram} \\ % com simbolo R$ antes
-
-Colocar medida após valor usando \verb+\unit+ e
-colocar valor já com medida usando \verb+\qty+
-pode apresentar diferença no espaçamento. \\
-\unit{10\celsius} \\ % valor concatenado com medida
-\qty{10}{\celsius} % valor e medida usando macro
-\end{ltxlisting}
-%\end{LTXexample}
-%\end{singlespacing}
-
-Alguma das medidas padrão são:
-\verb+\ampere+\index{si!ampere@\verb+\ampere+}, \verb+\candela+\index{si!candela@\verb+\candela+}, \verb+\kelvin+\index{si!kelvin@\verb+\kelvin+}, \verb+\kilogram+\index{si!kilogram@\verb+\kilogram+}, \verb+metre+\index{si!metre@\verb+\metre+} ou \verb+meter+\index{si!meter@\verb+\meter+},
-\verb+\mole+\index{si!mole@\verb+\mole+}, \verb+\second+\index{si!second@\verb+\second+}, \verb+\litre+\index{si!litre@\verb+\litre+}, \verb+\celsius+\index{si!celsius@\verb+\celsius+}, \verb+\percent+\index{si!percent@\verb+\percent+}, etc que são muitas.
-Para saber mais, consulte o manual do pacote.
-
-Para conversão de medidas,
-\verb+\giga+\index{si!giga@\verb+\giga+}, \verb+\mega+\index{si!mega@\verb+\mega+}, \verb+\kilo+\index{si!kilo@\verb+\kilo+}, \verb+\hecto+\index{si!hecto@\verb+\hecto+}, \verb+\deca+\index{si!deca@\verb+\deca+}, \verb+\deci+\index{si!deci@\verb+\deci+}, \verb+\centi+\index{si!centi@\verb+\centi+}, \verb+\milli+\index{si!milli@\verb+\milli+}, \verb+\micro+\index{si!micro@\verb+\micro+}, \verb+\nano+\index{si!nano@\verb+\nano+}, etc. são disponíveis.
-
-Exemplo: \verb+\qty{20}{\kilo\gram}+ e mesmo que \verb+\qty{20}{\kilogram}+.
-
-Para operar, tem o \texttt{per, square}, etc.
-
-\verb+\qty{30}{\kilo\meter\per\square\second}+
-é mesmo que
-\verb+\qty{30}{\kilo\meter/\second^2}+
-no modo padrão, mas o segundo não consegue controlar a formatação por usar forma literal em ``/'' e ``\verb+^2+''.
-
-A configuração geral de formatação pode ser feito pela opção do pacote ou pelo comando \verb+\sisetup+\index{sisetup@\verb+\sisetup+}, mas também pode especificar localmente como no Exemplo~\ref{ex15:sisetup}.
-
-
-%\begin{singlespacing}
-%\begin{LTXexample}[pos=b,caption={ex11-09.tex, parte c},label=ex:11-09:c]
-\begin{ltxlisting}[caption={ex15-sisetup.tex},label=ex15:sisetup]
-\qty[mode=text]{30}{\kilo\meter\per\square\second}
-
-\qty[per-mode=power]{30}{\kilo\meter\per\square\second}
-
-\qty[per-mode=symbol]{30}{\kilo\meter\per\square\second}
-
-\qty[per-mode=fraction]{30}{\kilo\meter\per\square\second}
-\end{ltxlisting}
-%\end{LTXexample}
-%\end{singlespacing}
-
-A nova versão, apesar de continuar com os comandos da versão 2, separa o comando para números complexos e com o produto, como pode ver no exemplo de \verb+\num+ (Exemplo~\ref{ex15:num}). Se o documento já está escrita usando os comando da versão 2 (sem esta separação), poderá carregar no modo de versão 2, com o comando \verb+\usepackage{siunitx}[=v2]+.
-
-\section{Calculando o valor de uma função}
-Para efetuar cálculo de funções matemáticas no \LaTeX, como no caso de tabelar funções nos pontos dados, podemos usar o pacote \texttt{xfp}\index{xfp} ou \texttt{numerica}\index{numerica}. O pacote \texttt{xfp} evalua a expressão matemática normalmente, enquanto que \texttt{numérica} evalua a expressão escrita na forma \TeX, permitindo que mesma expressão pode ser usado tanto para evaluar, como para exibir. Além de \texttt{numerica} ter mais recursos, o \texttt{numerica-tables}\index{numerica-tables} permite tabelar funções rapidamente.
-
-Veja o Exemplo~\ref{ex15:xfp-e-numerica}.
-
-%\begin{singlespacing}
-%\begin{LTXexample}[pos=b,caption={ex11-08.tex},label=ex:11-08]
-\begin{ltxlisting}[caption={ex15-xfp-e-numerica.tex},label=ex15:xfp-e-numerica]
-%Supõe carregada seguintes pacotes: xfp, numerica e numerica-tables
-Expressão a ser evaluada: $\sin(\frac{\pi}{4})$
-
-Valor pelo \texttt{xfp} é $\fpeval{sin(pi/4)}$
-
-Valor pelo \texttt{numerica} (com configuração padrão) é $\eval{\sin(\frac{\pi}{4})}$,
-
-Tabelando função com \texttt{numerica-tables}
-
-\tabulate[rvar=x,rstep={\frac{\pi}{10}},rows={10+1}]
-{\sin x}[x=0]
-
-\end{ltxlisting}
-%\end{LTXexample}
-%\end{singlespacing}
-
-% A nova versão (2024) de numerica-tables suporta transpor a tabela
-%Forma transposta: Precisa testar, mas ele precisa que outros pacotes tabém sejam atualizadas.
-%\tabulate[rvar=x,rstep={\frac{\pi}{10}},rows={10+1},transpose]{\sin x}[x=0]
-
\section{Moldura, enumeração das linhas e marca d'água}
Para enfeitar o documento, como colocar moldura nos elementos, usamos os pacotes adicionais, exceto molduras simples fornecidos pelo \verb+\fbox+\index{fbox@\verb+\fbox+}.
@@ -8133,7 +8248,7 @@
\end{lstlisting}
\end{singlespacing}
-No exemplo anterior, a diferenciação entre siglas, símbolos e glossários foi feito pelo valor do \texttt{tag}, mas como permite \texttt{tag} genérico, pode cometer erros de digitação. Assim as vezes, é preferível usar o pacote com maior rigidez como o \texttt{glossaries}\index{glossaries}. O pacote \texttt{glossaries} também permite processar a ordenação pelo comando externo \texttt{makeglossaries} para ter maior controle. O Exemplo~\ref{ex15:glossaries} ilustra o uso (saída será omitida).
+A ordenação no \texttt{acro} é pela ordem alfabética dos rótulos (nomes) dos acronomos que é o primeiro argumento de \verb+\DeclareAcronym+. No exemplo anterior, a diferenciação entre siglas, símbolos e glossários foi feito pelo valor do \texttt{tag}, mas como permite \texttt{tag} genérico, pode cometer erros de digitação. Assim as vezes, é preferível usar o pacote com maior rigidez como o \texttt{glossaries}\index{glossaries}. O pacote \texttt{glossaries} também permite processar a ordenação pelo comando externo \texttt{makeglossaries} para ter maior controle. O Exemplo~\ref{ex15:glossaries} ilustra o uso (saída será omitida).
\begin{singlespacing}
\begin{lstlisting}[caption={ex15-glossaries.tex},label=ex15:glossaries]
@@ -9004,6 +9119,7 @@
\setotherlanguage{english} % secundario
% Estas fontes são padrões e não precisavam especificar. Foram colocados somente para ilustrar
+ % No caso de XeLaTeX, se a fontes correspondentes não estiver isntalados no sistema operacional, pode não funcionar. Comente.
\setmainfont{Latin Modern Roman}
\setsansfont{Latin Modern Sans}
\setmonofont{Latin Modern Mono}
@@ -9184,38 +9300,39 @@
Assim, para procurar fontes na lista, costuma usar o pacote \texttt{iffont}\index{iffont}.
Ele implementa o comando \verb+\settofirstfound{\nomefonte}{<fontes>}+\index{settofirstfound@\verb+\settofirstfound+} onde \texttt{<fontes>} é lista de nome das fontes, separado pela vírgula.
Ele associa ao comando \verb+\nomefonte+, o nome da primeira fonte encontrada na lista, o que pode ser usado para selecionar ou definir família de fontes.
-Caso nenhuma fonte existir, retorna o valor de \verb+\@iffont at firstfont+ que está como a fonte \texttt{Fira Sans}. % março de 2018
-Em geral, coloca-se o nome de uma fonte existente no final da lista para evitar de cair no \texttt{Fira Sans} que nem sempre é desejável.
+Caso nenhuma fonte existir, retorna o valor de \verb+\@iffont at firstfont+ que está como a última fonte encontrada anteriormente (se ainda não existe a fonte encontrada, será a fonte \texttt{Fira Sans}). % março de 2018
+Em geral, coloca-se o nome de uma fonte existente no final da lista para evitar de cair no \verb+\@iffont at firstfont+ que nem sempre é desejável.
-No entanto, \texttt{iffont} não funciona devidamente no \XeLaTeX/Lua\LaTeX{} recente.
-% só funciona no \XeLaTeX{} (testados nas versões 2016 e março de 2018).
-Para que as funções do \texttt{iffont} funcione devidamente,
-%no Lua\LaTeX,
-reescreva o comando \verb+\@iffont at checkfont+ usando o \verb+\IfFontExistisTF+ do pacote \texttt{fontspec} como em
-\begin{singlespacing}
-\begin{lstlisting}
-...
-\usepackage{iftex}
-...
-\usepackage{iffont}
-% patch
-% \usepackage{etoolbox} % iffont ja carregou
-\let\iffontexists\IfFontExistsTF
-\makeatletter
- \renewcommand{\@iffont at checkfont}[1]{
- \IfFontExistsTF{#1}{
- \nottoggle{@iffont at fontfound}{%
- \renewcommand{\@iffont at firstfont}{#1}
- \toggletrue{@iffont at fontfound}
- }{}
- }{\stepcounter{@iffont at fontsnotfound} }
- }
-\makeatother
-\end{lstlisting}
-\end{singlespacing}
+% No xelatex/lualatex recente, funciona corretamente
+%No entanto, \texttt{iffont} não funciona devidamente no \XeLaTeX/Lua\LaTeX{} recente.
+%% só funciona no \XeLaTeX{} (testados nas versões 2016 e março de 2018).
+%Para que as funções do \texttt{iffont} funcione devidamente,
+%%no Lua\LaTeX,
+%reescreva o comando \verb+\@iffont at checkfont+ usando o \verb+\IfFontExistisTF+ do pacote \texttt{fontspec} como em
+%\begin{singlespacing}
+%\begin{lstlisting}
+%...
+%\usepackage{iftex}
+%...
+%\usepackage{iffont}
+%% patch
+%% \usepackage{etoolbox} % iffont ja carregou
+%\let\iffontexists\IfFontExistsTF
+%\makeatletter
+% \renewcommand{\@iffont at checkfont}[1]{
+% \IfFontExistsTF{#1}{
+% \nottoggle{@iffont at fontfound}{%
+% \renewcommand{\@iffont at firstfont}{#1}
+% \toggletrue{@iffont at fontfound}
+% }{}
+% }{\stepcounter{@iffont at fontsnotfound} }
+% }
+%\makeatother
+%\end{lstlisting}
+%\end{singlespacing}
+%
+%Com este ajuste, os comandos de \texttt{iffont} vão funcionar devidamente.%no Lua\LaTeX{} também.
-Com este ajuste, os comandos de \texttt{iffont} vão funcionar devidamente.%no Lua\LaTeX{} também.
-
Por exemplo, o código
\begin{singlespacing}
\begin{lstlisting}
@@ -9224,10 +9341,10 @@
\end{lstlisting}
\end{singlespacing}
%
-configura para usar o ``Noto Serif'' como fonte padrão caso existir. Caso ele não for encontrado, usa-se a fonte ``Latin Modern Serif'' que deve estar presente na instalação padrão do \TeX.
+configura para usar o ``Noto Serif'' como fonte padrão caso existir. Caso ele não for encontrado, usa-se a fonte ``Latin Modern Serif'' que deve estar presente na instalação padrão do \TeX. No caso de \XeLaTeX, se a fonte ``Latin Modern Serif'' não estiver instalado no sistema operacional, não vai encontrar. Assim, poderá colocar ``[lmroman12-regular]'' ou similar no lugar.
-Se o que quer é saber se fonte existe, o \texttt{iffont} também tem os comandos \verb+\iffontsexist+\index{iffontsexist@\verb+\iffontsexist+} e \verb+\iffontexists+\index{iffontexists@\verb+\iffontexists+} na qual executa o segundo parâmetro quando fonte existe e terceiro parâmetro quando a fonte não existe.
-A diferença é que no \verb+\iffontsexist+, o parâmetro é lista de nome das fontes separado pela vírgula e no \verb+\iffontexists+, o parâmetro é nome de uma única fonte (igual a \verb+\IfFontExistsTF+ do \texttt{fontspec}).
+Se o que quer é saber se a fonte existe, o \texttt{iffont} também implementa os comandos \verb+\iffontsexist+\index{iffontsexist@\verb+\iffontsexist+} e \verb+\iffontexists+\index{iffontexists@\verb+\iffontexists+} na qual executa o segundo parâmetro quando fonte existe e terceiro parâmetro quando a fonte não existe.
+A diferença é que no \verb+\iffontsexist+, o parâmetro é uma lista de nome das fontes separado pela vírgula (e executa o segundo parâmetro se todas as fontes da lista existirem) e no \verb+\iffontexists+, o parâmetro é nome de uma única fonte (igual a \verb+\IfFontExistsTF+ do \texttt{fontspec}).
Por exemplo,
\begin{singlespacing}
\begin{lstlisting}
@@ -9241,8 +9358,8 @@
%Se estiver usando o Lua\LaTeX, use \verb+\IfFontExistsTF+ em vez das funções do pacote \texttt{iffont}.
As fontes \texttt{Open Type} que podem ser usados pelo \XeLaTeX{} e Lua\LaTeX{} podem estar no diretório do documento, diretório de \TeX{} ou instalado no sistema operacional.
-No Lua\LaTeX, estas fontes podem ser acessadas pelo nome das fontes, mas no \XeLaTeX, somente as fontes instaladas no sistema operacional podem ser acessados pelo nome. Fontes encontradas em outras localidades tais como junto ao documento \TeX{} ou no diretório de \TeX{} devem ser indicados pelo nome do arquivo, incluindo a sua extensão.
-Assim, se os comandos do pacote \texttt{fontspec} ou de \texttt{iffont} não conseguirem encontrar as fontes pelo nome no \XeLaTeX, tente usar o nome do arquivo da fonte (sem esquecer da sua extensão).
+No Lua\LaTeX, estas fontes podem ser acessadas pelo nome das fontes, mas no \XeLaTeX, somente as fontes instaladas no sistema operacional podem ser acessados pelo nome. Fontes encontradas em outras localidades tais como junto ao documento \TeX{} ou no diretório de \TeX{} devem ser indicados pelo nome do arquivo, incluindo a sua extensão (ou alguma especificação adequada). % será que a versão nova não resolveu este problema? Sim 2024, aind acontinua
+Assim, se os comandos do pacote \texttt{fontspec} ou de \texttt{iffont} não conseguirem encontrar as fontes pelo nome no \XeLaTeX, tente usar o nome do arquivo da fonte.
No caso de querer usar as fontes da \texttt{MicroSoft} no \texttt{MS Windows}, % compilando com LuaLaTeX,
coloque
@@ -9256,13 +9373,13 @@
\end{lstlisting}
\end{singlespacing}
-no \texttt{preamble}, lembrando que no caso de \XeLaTeX, fontes que não está no sistema (como fontes que estão no diretório de \TeX) requer passar o nome do arquivo das fontes em vez dos nomes das fontes.
+no \texttt{preamble}.%, lembrando que no caso de \XeLaTeX, fontes que não está no sistema (como fontes que estão no diretório de \TeX) requer passar o nome do arquivo das fontes em vez dos nomes das fontes.
-Uma das dificuldades de usar fontes não padrão é saber as combinações adequadas, o que requer o conhecimento de tipografia e diagramação. Para resolver este problema em \XeLaTeX{} e Lua\LaTeX{}, foi desenvolvido o pacote \texttt{fontsetup}\index{fontsetup}.
+Uma das dificuldades de usar fontes não padrão é saber as combinações adequadas (entre romano, sem serifa, mono espaçado, etc), o que requer o conhecimento de tipografia e diagramação. Para resolver este problema em \XeLaTeX{} e Lua\LaTeX{}, foi desenvolvido o pacote \texttt{fontsetup}\index{fontsetup}.
O padrão deste pacote é usar a fonte \texttt{New Computer Modern} na espessura \texttt{Book} adequado para livros eletrônicos e similares, mas existem muitas opções deste pacote que configura para outras combinações das fontes pré estabelecidas. Por exemplo, a opção \texttt{stixtwo} carrega a fonte \texttt{STIX 2} que é do tipo times. Veja o documento do pacote \texttt{fontsetup} para mais detalhes.
Para usar fonte de espessura \texttt{Book} compatível com Computer Modern no PDF\LaTeX{} em vez de \XeLaTeX/Lua\LaTeX, use a fonte {MLModern}.%\index{fonte MLModern}.
-O Exemplo~\ref{ex18:fontsetup} é um exemplo usando a fonte compatível com Computer Modern, mas com espessura \texttt{Book} apropriado para livros eletrônicos e similares.
+O Exemplo~\ref{ex18:fontsetup} é um exemplo usando a fonte compatível com ``Computer Modern'', mas com espessura \texttt{Book}. % apropriado para livros eletrônicos e similares.
Para PDF\LaTeX, usa a fonte \texttt{MLModern}\index{fonte!MLModern} e para \XeLaTeX/Lua\LaTeX, usa-se a fonte \texttt{New Computer Modern}\index{fonte!New Computer Modern}.
A opção para tornar espessura compatível com o \texttt{Computer Modern} tradicional (para impressão em papel) está comentada.
@@ -9282,7 +9399,7 @@
\end{lstlisting}
\end{singlespacing}
-Para \texttt{poster} e \texttt{slides}, é recomendado que use a fonte \texttt{sans serif}. Para escolher o \texttt{New Computer Modern} no estilo \texttt{sans serif} pelo pacote \texttt{fontsetup}, use a opção \texttt{sansdefault}.
+Para \texttt{poster} e \texttt{slides}, é recomendado que use a fonte \texttt{sans serif}. Para escolher o \texttt{New Computer Modern} no estilo \texttt{sans serif} pelo pacote \texttt{fontsetup}, use a opção \texttt{sansdefault}. Para PDF\LaTeX, carregue o pacote \texttt{sansmathfonts}.
\section{Usando em conjunto com Bib\LaTeX}
O documento em vários idiomas pode precisar também de referências bibliográficas em vários idiomas.
@@ -9353,35 +9470,56 @@
Isto será facilitado se estiver usando \XeLaTeX{} ou Lua\LaTeX{} em vez do PDF\LaTeX.
Assim, vamos supor que está usando o \XeLaTeX/Lua\LaTeX{} para prosseguir com a explicação.
Para definir comandos para texto em japonês, coloque o comando
+%\begin{singlespacing}
+%\begin{lstlisting}
+%\usepackage[Ligatures=TeX]{fontspec}
+%\usepackage{iffont}
+%% patch
+%\let\iffontexists\IfFontExistsTF
+%\makeatletter
+% \renewcommand{\@iffont at checkfont}[1]{
+% \IfFontExistsTF{#1}{
+% \nottoggle{@iffont at fontfound}{%
+% \renewcommand{\@iffont at firstfont}{#1}
+% \toggletrue{@iffont at fontfound}
+% }{}
+% }{\stepcounter{@iffont at fontsnotfound} }
+% }
+%\makeatother
+%
+%\settofirstfound{\mainjfont}{Noto Serif CJK JP, MS Mincho, TakaoMincho, IPAexMincho, Hiragino Mincho Pro}
+%\settofirstfound{\gothicjfont}{Noto Sans CJK JP, MS Gothic, TakaoGothic, IPAexGothic, Hiragino Maru Gothic Pro}
+%% If Gothic not found, use Mincho instead.
+%\IfFontExistsTF{\gothicjfont}{}{\let\gothicjfont\mainjfont}
+%% If Mincho not found, error.
+%\IfFontExistsTF{\mainjfont}{\newfontfamily{\jafamily}[BoldFont=\gothicjfont]{\mainjfont}}{%
+%\PackageError{\jobname}{Japanese Mincho font not found}{Install apropriate ones}
+%}%
+%\newcommand{\textja}[1]{{\jafamily #1}}
+%\end{lstlisting}
+%\end{singlespacing}
+%Lembre-se que, para o pacote \texttt{iffont} funcionar no Lua\LaTeX, precisará ajustar o comando \verb+\@iffont at checkfont+ após carregar o \texttt{iffont}.
+
\begin{singlespacing}
\begin{lstlisting}
\usepackage[Ligatures=TeX]{fontspec}
\usepackage{iffont}
-% patch
-\let\iffontexists\IfFontExistsTF
-\makeatletter
- \renewcommand{\@iffont at checkfont}[1]{
- \IfFontExistsTF{#1}{
- \nottoggle{@iffont at fontfound}{%
- \renewcommand{\@iffont at firstfont}{#1}
- \toggletrue{@iffont at fontfound}
- }{}
- }{\stepcounter{@iffont at fontsnotfound} }
- }
-\makeatother
-\settofirstfound{\mainjfont}{Noto Serif CJK JP, MS Mincho, TakaoMincho, IPAexMincho, Hiragino Mincho Pro}
-\settofirstfound{\gothicjfont}{Noto Sans CJK JP, MS Gothic, TakaoGothic, IPAexGothic, Hiragino Maru Gothic Pro}
-% If Gothic not found, use Mincho instead.
-\IfFontExistsTF{\gothicjfont}{}{\let\gothicjfont\mainjfont}
-% If Mincho not found, error.
-\IfFontExistsTF{\mainjfont}{\newfontfamily{\jafamily}[BoldFont=\gothicjfont]{\mainjfont}}{%
-\PackageError{\jobname}{Japanese Mincho font not found}{Install apropriate ones}
-}%
-\newcommand{\textja}[1]{{\jafamily #1}}
+\def\jafontlist{Noto Serif CJK JP, MS Mincho, TakaoMincho, IPAexMincho, IPAMincho, Hiragino Mincho Pro,[lmroman12-regular]} % último da list anão é japonês
+\def\jagothicfontlist{Noto Sans CJK JP, MS Gothic, TakaoGothic, IPAexGothic, IPAGothic, Hiragino Maru Gothic Pro}
+
+\settofirstfound{\jafont}{\jafontlist}
+\settofirstfound{\jagothic}{\jagothicfontlist}
+
+% Se cair no último, fonte japonês não encontrado.
+\ifdefstring{\jafont}{[lmroman12-regular]}{\PackageWarning{\jobname}{Fonte japonês Mincho não encontrada.}{Instale um dos seguintes: \jafontlist}\newcommand{\textja}[2][]{#1}}
+{%
+ \ifdefstrequal{\jagothic}{\jafont}{\PackageWarning{\jobname}{Fonte japonês Gothic não encontrada.}{Instale um dos seguintes: \jagothicfontlist}}{}
+ \newfontfamily{\jafamily}[BoldFont=\jagothic]{\jafont}
+ \newcommand{\textja}[2][]{{\jafamily #2}}
+}{}
\end{lstlisting}
\end{singlespacing}
-Lembre-se que, para o pacote \texttt{iffont} funcionar no Lua\LaTeX, precisará ajustar o comando \verb+\@iffont at checkfont+ após carregar o \texttt{iffont}.
O comando \verb+\jafamily+ será definido quando encontrar alguma fonte da lista.
Também será definido o comando \verb+\textja+ para trecho pequeno.
@@ -9463,7 +9601,7 @@
Além disso, com o uso do tal pacote, a troca de fontes para japonês e vice versa será automática, sem a necessidade de estar especificando a família de fontes a ser usadas a cada trecho.
Como observação final sobre \XeLaTeX/Lua\LaTeX,
-os comandos protegidos dos pacotes de \XeLaTeX/Lua\LaTeX{} costumam usar ``\verb+_+'' em vez de ``@'', ou ``\verb+_+'' em conjunto com ``@''.
+os comandos protegidos dos pacotes de \XeLaTeX/Lua\LaTeX{} costumam usar ``\verb+_+'' e ``\verb+:+'', em vez de ``@'' (ou ests caracteres em conjunto com ``@'').
Isto foi introduzido no \LaTeX{} pelo equipe de desenvolvimento \LaTeX{} 3 e aparecem nos pacotes mais recentes.
Assim, para usar estes comandos e ambientes no \texttt{preamble}, deverá colocar entre \verb+\ExplSyntaxOn+\index{ExplSyntaxOn@\verb+\ExplSyntaxOn+} e \verb+\ExplSyntaxOff+\index{ExplSyntaxOff@\verb+\ExplSyntaxOff+}.
@@ -9490,29 +9628,29 @@
%item \verb+\newfontfamily+ do fontspec
\clearpage\thispagestyle{empty}\cleardoublepage
-\chapter{Diagramando na Norma ABNT}
-Neste capítulo, vamos estudar uma classe e arquivos de suporte da referência bibliográfica para diagramar de acordo com a exigência do ABNT\index{ABNT} (Associação Brasileira das Normas Técnicas).
+\chapter{Diagramando na Norma ABNT}\label{cap:abnt}
+Neste capítulo, vamos estudar uma classe e arquivos de suporte da referência bibliográfica para diagramar de acordo com a exigência de Associação Brasileira das Normas Técnicas (ABNT\index{ABNT}).
-A classe padrão para diagramar os documentos como trabalho de conclusão de cursos, monografias em geral, teses e dissertações em ABNT é a classe \texttt{abntex2}\index{abntex2} que foi implementado sobre a classe \texttt{memoir}, herdando diversas funcionalidades. Para saber estas funcionalidades adicionais, consulte o manual do \texttt{memoir}.
+A classe padrão para diagramar os documentos como trabalho de conclusão de cursos, monografias em geral, teses e dissertações em \texttt{ABNT} é a classe \texttt{abntex2}\index{abntex2} que foi implementado sobre a classe \texttt{memoir}, herdando diversas funcionalidades. Para saber estas funcionalidades adicionais, consulte o manual do \texttt{memoir}.
\section{Documentos em ABNT}
Para o documento em ABNT, usamos a classe \texttt{abntex2} como em
\begin{lstlisting}
-\documentclass[12pt,a4paper,openright,twoside,english,brazil]{abntex2}
+\documentclass[12pt,a4paper,openright,oneside,english,brazil]{abntex2}
\end{lstlisting}
-onde \verb+12pt+ foi usado para ajustar o tamanho das letras, \verb+a4paper+ para papel \texttt{A4} e \verb+twoside+ e \verb+openright+ foi usado para criar impressão frente/verso seguindo a recomendação do ABNT (recomendação não é obrigatoriedade). Se quer gerar a verão \texttt{online}, use a opção \verb+oneside+ no lugar.
-Por último, \verb+english+ e \verb+brazil+ foi colocado para ser repassado no pacote \texttt{babel}, pois ABNT requer que tenha resumo na língua estrangeira (por exemplo, em inglês) além do resumo em português.
+onde \verb+12pt+ foi usado para ajustar o tamanho das letras, \verb+a4paper+ para papel \texttt{A4} e \verb+oneside+ foi usado para criar impressão de somente um lado para versão eletrônica. Se quer gear a versão impressa, coloque \verb+twoside+ e \verb+openright+ para ficar como frente/verso seguindo a recomendação do ABNT (recomendação não é obrigatoriedade).
+Por último, \verb+english+ e \verb+brazil+ foi colocado para ser repassado no pacote \texttt{babel}, pois \texttt{ABNT} requer que tenha resumo na língua estrangeira (por exemplo, em inglês) além do resumo em português.
A classe \texttt{abntex2} implementa diversos comandos para produzir elementos de acordo com a exigência ou recomendações do ABNT.
Alguns desses comandos possuem equivalência para comandos da classe \texttt{memoir} e estão mapeados para poder usar tanto os comandos do \texttt{memoir} como da própria classe \texttt{abntex2} (por exemplo, \verb+\autor+ e \verb+\author+, \verb+\titulo+ e \verb+\title+, \verb+\data+ e \verb+\date+, etc), enquanto que existem comandos que equivalente do \texttt{memoir} produz estilo diferente do exigido ou recomendado pelo ABNT (por exemplo, \verb+\imprimecapa+ e \verb+\maketitle+, \verb+\apendices+ e \verb+\appendix+).
Assim, requer cuidados.
-Uma observação importante é usar sempre o \texttt{uft8} na classe ABNT, o que é necessário especificar com \verb+\usepackage[utf8]{inputenc}+ no caso de não estar usando o \XeLaTeX/Lua\LaTeX.
+Uma observação importante é usar sempre o \texttt{uft8} na classe \texttt{ABNT}, o que é necessário especificar com \verb+\usepackage[utf8]{inputenc}+ no caso de não estar usando o \XeLaTeX/Lua\LaTeX.
A classe \texttt{abntex2} faz a chamada de \verb+\frontmatter+ (ou \verb+\pretextual+) no início do documento.
Assim, não é necessário colocar este comando no começo do documento.
-O exemplo~\ref{ex19:abntex2} ilustra o uso desta classe, com alguns comentários importantes.
+O Exemplo~\ref{ex19:abntex2} ilustra o uso desta classe (com referẽncias emm Bib\LaTeX{}), com alguns comentários importantes.
A sua saída será omitida aqui.
\begin{singlespacing}
@@ -9557,11 +9695,27 @@
\end{lstlisting}
\end{singlespacing}
-Após ter a folha de aprovação devidamente assinadas, digitalize e converta no formato PDF.
+Após ter a folha de aprovação devidamente assinadas, digitalize e converta no formato \texttt{PDF}.
Em seguida, inclua diretamente no documento como uma página (e não como um desenho) usando o comando \verb+\includepdf+\index{includepdf@\verb+\includepdf+} do pacote \texttt{pdfpages}\index{pdfpages}.
A classe \texttt{abntex2} aceita a opção \texttt{article} para diagramar artigos, mas na maioria dos casos, não é exigido que artigos sigam a norma ABNT, podendo ou não, requerer suas referências em ABNT.
+
+\section{Documento ABNT usando \texttt{ABNTexto}}
+A classe \texttt{ABNTexto}\index{ABNTexto} que está na fase de desenvolvimento é uma alternativa leve para \texttt{ABNTeX2}, para diagramar em \texttt{ABNT}. Enquanto que \texttt{ABNTeX2} usa a classe \texttt{memoir} e diversos pacotes para maior flexibilidade, \texttt{ABNTexto} usa a classe \texttt{article} e muitos poucos pacotes, tornando muito leve.
+Para usar a última versão desta classe sem instalar, abaixe o arquivo \texttt{abntexto.cls} do \texttt{CTAN} (\url{https://ctan.org/}) e mantenha junto ao arquivo \texttt{.tex}.
+%Sobre os comandos, veja a documentação disponível em \cite{book:abntexto:abreu}.
+% No entanto, como ele ainda está na fase de desenvolvimento (2024), pode apresentar algumas inconveniências.
+
+Um exemplo de \texttt{ABNTexto} com uso de Bib\LaTeX{} é como no Exemplo~\ref{ex19:abntexto}, cuja a saída é omitida.
+
+\begin{singlespacing}
+\lstinputlisting[caption={ex19-abntexto.tex},label=ex19:abntexto]{latex-via-exemplos-abntexto}
+\end{singlespacing}
+
+O \texttt{ABNTeX2} é mais completo, mas por basear na classe \texttt{memoir} e carregar diversos pacotes, torna mais pesado.
+Por outro lado, \texttt{abntexto} é baseado na classe \texttt{article} e depende de poucos pacotes, o que torna leve, apesar de ter menos recursos. Outra observação é que \texttt{ABNTeX2} implementa comandos e ambientes em português, enquanto que \texttt{abntexto} implementa comandos e ambientes em inglês.
+
\section{Usando o estilo ABNT no \BibTeX}
Quando as referências bibliográficas devem seguir a norma ABNT, e pretende usar o Bib\TeX, use o pacote \texttt{abntex2cite}\index{abntex2cite} que pode ser usado separadamente da classe \texttt{abntex2}.
@@ -9693,7 +9847,7 @@
\section{Usando o estilo ABNT no Bib\LaTeX}
-Também poderá elaborar referências bibliográficas no estilo ABNT usando o Bib\LaTeX.
+Também poderá elaborar referências bibliográficas no estilo ABNT usando o Bib\LaTeX{} que é recomendado.
Para isso, coloque a opção \texttt{style=abnt}\index{biblatex!abnt} na opção de chamada do pacote \texttt{biblatex}.
@@ -9707,11 +9861,11 @@
Por outro lado, se quiser usar o \verb+\textcite+ com \texttt{abntex2cite}, prevendo a futura transição para BiB\LaTeX,
basta colocar \verb+\let\textcite\citeonline+ no \texttt{preamble} do documento.
-Novamente, use a codificação em \texttt{utf8} e note que o Bib\LaTeX{} aceita a acentuação direta no arquivo de \BibTeX.
+Novamente, use a codificação em \texttt{utf8}. Note que o Bib\LaTeX{} aceita a acentuação direta no arquivo de \BibTeX.
O uso de \texttt{hyperref} é opcional, mas recomendável.
Como referências bibliográficas no estilo ABNT do Bib\LaTeX{} está projetado para poder ser usado fora da classe \texttt{abntex2}, a formatação do título da referência bibliográfica não costuma aparecer de acordo com o \texttt{ABNT} mesmo na classe \texttt{abntex2} devido a algumas questões técnicas.
-Isto pode ser acertado sem problemas com alguns códigos no \texttt{preâmbulo} como segue.
+Isto pode ser acertado sem problemas com alguns códigos no \texttt{preâmbulo} como segue (supondo que está usando ``brazilian'' na opção do pacote \texttt{babel}).
% Consertando o titulo que biblatex redefiniu
% Para biblatex: consertando para Referências ficar em maiusculo no sumário
@@ -9821,7 +9975,7 @@
\end{lstlisting}
\end{singlespacing}
-O arquivo \texttt{ex19-biblatex-abnt.bib} fica como segue.
+O arquivo \texttt{ex19-biblatex-abnt.bib} fica como segue.
\begin{singlespacing}
\begin{lstlisting}[language={BibTeX}]
@@ -9892,24 +10046,205 @@
Para mais detalhes sobre comandos do estilo ABNT para Bib\LaTeX, veja \cite{book:biblatex-abnt:marques}.
\begin{remark}
-O novo estilo bibliográfico de Bib\LaTeX{} para ABNT (conformidade com a nova regra ABNT) está no site \url{https://github.com/abntex/biblatex-abnt}, mas ainda não está no \href{https://ctan.org/}{CTAN} (em 2024). Por este motivo, o estilo da referência bibliográfica distribuída junto a \TeX{} não está atualizada.
+O novo estilo bibliográfico de Bib\LaTeX{} para ABNT (conformidade com a nova regra ABNT) está no site \url{https://github.com/abntex/biblatex-abnt}, mas ainda não está no \href{https://ctan.org/}{CTAN} (em 2024). Por este motivo, o estilo da referência bibliográfica distribuída junto com \TeX{} não está atualizada.
Para usar a versão nova, deverá abaixar e instalar manualmente seguindo a instrução.
Caso não conseguir instalar, poderá extrair todos os arquivos do pacote e colocar junto com o arquivo \texttt{tex}.
Para verificar se está com o novo estilo, veja se \texttt{URL} (endereço da internet) da referência bibliográfica ficará sem estar entre ``\verb+<+'' e ``\verb+>+'' (versão antiga ficará entre estes dois símbolos).
\end{remark}
-\section{Tabelas em ABNT}
+\section{Tabelas em ABNT}\label{sec:abnt:tabela}
-As tabelas no ABNT devem obedecer as normas de IBGE (Instituto Brasileiro de Geográfica e Estatística). Veja o Exemplo~\ref{ex19:abnt-table}, cuja saída é omitida.
+Tanto o \texttt{ABNTeX2}, como o \texttt{ABNTexto}, implementa sua forma de criar tabelas curtas em \texttt{ABNT}, mas ainda não tem a funcionalidade para tabelas longas (2024).
+As tabelas no \texttt{ABNT} devem obedecer as normas do Instituto Brasileiro de Geográfica e Estatística (IBGE)\index{IBGE}. Para ter conformidade com o estilo de IBGE (que ABNT adota), poderá usar o pacote \texttt{tabularray}, mas requer ajustes. Para isso, coloque o código a seguir, após carregar o pacote \texttt{tabularray}.
\begin{singlespacing}
+\begin{lstlisting}
+% texto adicional no cabeçalho
+\DefTblrTemplate{firsthead-text}{default}{\par~\hfill(continua)} % primeira página
+\DefTblrTemplate{lasthead-text}{defalt}{\par~\hfill(conclusão)} % última página
+\DefTblrTemplate{conthead-text}{default}{\par~\hfill(continuação)} % páginas do meio (default é em ingles, sem \par)
+% primeiro cabeçalho
+\makeatletter
+ \DefTblrTemplate{caption}{default}{
+ \UseTblrTemplate{caption-tag}{default}
+ \UseTblrTemplate{caption-sep}{default}
+ \UseTblrTemplate{caption-text}{default}
+ % like \ifdefined, but with csname
+ \ifcsname tblr at abnt@spanpages@\roman{table}\endcsname % if span pages
+ \UseTblrTemplate{firsthead-text}{default} % acrescentar o firsthead-text
+ \fi
+ }
+\makeatother
+%%
+% redefinindo o título do último cabeçalho
+\DefTblrTemplate{lasthead}{default}{\normalsize
+ \UseTblrTemplate{caption-tag}{default}
+ \UseTblrTemplate{caption-sep}{default}
+ \UseTblrTemplate{caption-text}{default}
+ \UseTblrTemplate{lasthead-text}{defalt} % acrescenttar o lasthead-text
+}
+\DefTblrTemplate{capcont}{default}{ % redefinindo, para \par funcionar (senão, será ignorado)
+ \UseTblrTemplate{caption-tag}{default}
+ \UseTblrTemplate{caption-sep}{default}
+ \UseTblrTemplate{caption-text}{default}
+ \UseTblrTemplate{conthead-text}{default}
+}
+% desativando rodapé inicial e do meio
+\DefTblrTemplate{firstfoot,middlefoot}{default}{}
+%
+% último rodapé para inserir fonte e nota
+\DefTblrTemplate{lastfoot}{default}{ % rodapé da última página
+ \UseTblrTemplate{lastfoot-text}{default} % colocar o lastfoot-text
+ \UseTblrTemplate{lastfoot-text-note}{default} % colocar o lastfoot-text-note
+}
+% texto do último rodapé
+\DefTblrTemplate{lastfoot-text}{default}{} % inicialmente vazio
+\DefTblrTemplate{lastfoot-text-note}{default}{} % inicialmente vazio
+% tamanho das fontes
+\SetTblrStyle{firsthead-text,lasthead-text,conthead-text}{\footnotesize}
+\SetTblrStyle{caption,lasthead,capcont}{\normalsize}
+\SetTblrStyle{lastfoot}{\footnotesize}
+
+\makeatletter
+% comando para legenda
+
+% https://www.reddit.com/r/LaTeX/comments/116wtwp/how_get_the_next_line_with_indentation/
+% \hangindent=2em\hangafter=1
+% indentar a rpóxima linha por \hangindent não funciona no tblr?
+\newlength{\Tblr at Format@Source at text@width}%
+\newsavebox\Tblr at Format@Source at label@box%
+\providecommand{\Tblr at Format@Source}[2][Fonte]{\par \medskip%
+ \setlength{\Tblr at Format@Source at text@width}{\textwidth}%
+ % if argument is empty, nothings for #1
+ \def\tempa{}\def\tempb{#1}%
+ \ifx\tempa\tempb
+ \else%
+ \sbox{\Tblr at Format@Source at label@box}{#1: }%
+ \addtolength{\Tblr at Format@Source at text@width}{-\wd\Tblr at Format@Source at label@box}% subtract label width
+ \usebox\Tblr at Format@Source at label@box% write label
+ \fi%
+ \parbox[t]{\Tblr at Format@Source at text@width}{\linespread{1}\@currsize
+ #2% dentro de tabular par aalinhamento e com espaçamento simples
+ }%
+ \smallskip
+} %
+% Fonte no último rodapé
+\newcommand\SetTblrSource[2][Fonte]{%
+ % https://texfaq.org/FAQ-empty
+ \def\tempa{}%
+ \def\tempb{#1}%
+ \ifx\tempa\tempb% if argument is empty
+ \DefTblrTemplate{lastfoot-text}{default}{}%
+ \else
+ \DefTblrTemplate{lastfoot-text}{default}{\Tblr at Format@Source[#1]{#2}}%
+ \fi
+}
+% Nota no último rodapé
+\newcommand\SetTblrNote[2][Nota]{%
+ % https://texfaq.org/FAQ-empty
+ \def\tempa{}%
+ \def\tempb{#1}%
+ \ifx\tempa\tempb% if argument is empty
+ \DefTblrTemplate{lastfoot-text-append}{default}{}%
+ \else
+ \par\DefTblrTemplate{lastfoot-text-note}{default}{\Tblr at Format@Source[#1]{#2}}%
+ \fi
+}
+
+% To save span page status
+%\makeatletter
+ \newif\iftblr at abnt@mark at spanpages% if span pages, put corresponding command to aux file
+ \tblr at abnt@mark at spanpagesfalse % initially false
+ % tblr with long optional option
+ \AddToHook{env/tblr/before}
+ {
+ \tblr at abnt@mark at spanpagestrue
+ }
+ \AddToHook{env/tblr/after}
+ {
+ \tblr at abnt@mark at spanpagesfalse
+ \DefTblrTemplate{lastfoot-text}{default}{}
+ \DefTblrTemplate{lastfoot-text-note}{default}{}
+ }
+ % longtblr
+ \AddToHook{env/longtblr/before}
+ {
+ \tblr at abnt@mark at spanpagestrue
+ }
+ \AddToHook{env/longtblr/after}
+ {
+ \tblr at abnt@mark at spanpagesfalse
+ \DefTblrTemplate{lastfoot-text}{default}{}
+ \DefTblrTemplate{lastfoot-text-note}{default}{}
+ }
+ % talltblr
+ \AddToHook{env/talltblr/before}
+ {
+ \tblr at abnt@mark at spanpagestrue
+ }
+ \AddToHook{env/talltblr/after}
+ {
+ \tblr at abnt@mark at spanpagesfalse
+ \DefTblrTemplate{lastfoot-text}{default}{}
+ \DefTblrTemplate{lastfoot-text-note}{default}{}
+ }
+ % if change pages, mark as span pages on aux file
+ \AddToHook{shipout/after}
+ {
+ \iftblr at abnt@mark at spanpages
+ % from https://tex.stackexchange.com/questions/115932/on-the-basics-of-writing-to-reading-from-auxiliary-files-aux-toc-etc
+ \immediate\write\@auxout{\gdef\string\tblr at abnt@spanpages@\roman{table}{true}}
+ \fi
+ %\tblr at abnt@mark at spanpagesfalse
+ % https://tex.stackexchange.com/questions/566884/setting-a-newif-to-false-ignored-on-first-check-in-custom-itemize-environment
+ % to the associated commands act globally
+ \global\let\iftblr at abnt@mark at spanpages\iffalse
+ }
+\makeatother
+\end{lstlisting}
+\end{singlespacing}
+
+O código ficou um pouco longo, mas isto configura tanto o \texttt{talltblr} como o \texttt{longtblr} (e \texttt{tblr} com opção \texttt{long} ou \texttt{tall}) e funciona tanto na tabela de uma página como no caso de ocupar mais de uma página.
+Para usar no \texttt{abntexto}, ainda precisa acrescentar o código.
+
+\begin{singlespacing}
+\begin{lstlisting}
+\ExplSyntaxOn
+ \DefTblrTemplate { caption-lot } { default }
+ {
+ %\addtocounter{table}{-1}
+ %\stepcounter{quadro}
+ %\global\advance\counttable by 1
+ \tl_if_empty:NTF \lTblrEntryTl
+ { \tl_set_eq:NN \l__tblr_caption_short_tl \lTblrCaptionTl }
+ { \tl_set_eq:NN \l__tblr_caption_short_tl \lTblrEntryTl }
+ %\addcontentsline { lot } { table }
+ % { \protect\numberline { \thetable } { \l__tblr_caption_short_tl } }
+ %adicionando na lista pelo comando de abntexto
+ \addtoext{lot}{lofi}{\protect\lotlabelbox{\the\counttable} {\l__tblr_caption_short_tl}}%
+ }
+\ExplSyntaxOff
+\end{lstlisting}
+\end{singlespacing}
+
+Agora, supondo que o \texttt{tabularray} com ajuste ao uso de \texttt{booktabs} por \verb+\UseTblrLibrary{booktabs}+ e também foi carregado os pacotes \texttt{url} (ou \texttt{hyperref}) e \texttt{xcolor}. Então poderá diagramar as tabelas normalmente com o \texttt{talltblr} e \texttt{longtblr}, com auxilio do comando \verb+\SetTblrSource+ e \verb+\SetTblrNote+ para tabela flutuante que foi definido no \texttt{preamble}, como no Exemplo~\ref{ex19:abnt-table}, cuja a saída foi omitida.
+
+\begin{singlespacing}
\begin{lstlisting}[caption={ex19-abnt-table.tex},label={ex19:abnt-table}]
-A Tabela Tabela~\ref{tab:primeira} é o que auto posiciona.
+A Tabela Tabela~\ref{tab:abnt:flutuante} é o que auto posiciona. Para tabela flutuante, poderá usar \texttt{tabular} ou similar normalmente, mas neste exemplo, foi usado o \texttt{talltblr} que aceita mesmos parâmetros de \texttt{longtblr} como o rodapé, etc, mas que pode ser colocado dentro do ambiente \texttt{table}.
\begin{table}[hbp!]
\centering
-\caption{Um título}\label{tab:primeira}
-\begin{tabular}{ll}
+\SetTblrSource{Elaboração do autor} % Usando comando definido no preamble premabulo
+\begin{talltblr}
+[
+ caption={Um título},
+ label={tab:abnt:flutuante},
+]
+{
+ colspec = {XX}, % colunas de largura automatica
+ row{even} = {gray!15}, % linha par em cinza
+}
\toprule %\hline
produto & preço \\
\midrule %\hline
@@ -9917,65 +10252,186 @@
cogumelos (vidro de 500g) & R\$5,00 \\
batata (1Kg) & R\$1,20 \\ \midrule % \hline
total & R\$6,70 \\
- \bottomrule %\hline
-\end{tabular}
-\legend{Fonte: elaboração do autor} % No ABNTeX2
-% Se não for ABNTeX2, use a fonte em \footnotesize.
-% {\footnotesize Fonte: elaboração do autor}
+\bottomrule %\hline
+\end{talltblr}
\end{table}
-A tabela longa precisará do pacote \textt{xtab}, pois o pacote \texttt{longtable} não é suficiente para ter conformidade com a exigência do ABNT.
+A Tabela~\ref{tab:abnt:longa} foi criado pelo ambiente \texttt{longtblr} (que é mesmo que \texttt{tblr} com opção ``long'' no primeiro parâmetro do argumento), que requer duas compilações seguidas para ajustar corretamente devido a configuração no preambulo.
-A Tabela~\ref{tab:longa} foi criado pelo ambiente \texttt{xtabular} do pacote \texttt{xtab} que requer duas compilações seguidas para ajustar corretamente.
-
\begin{center}
-\topcaption{Tabela longa}\label{tab:longa}
-\tablefirsthead{ % primeira página
- \ifnum\PWSTlastpage > 1 % Se a tabela ocupar mais de uma página
- \multicolumn{2}{r}{(continua)}\\
- \fi
- \toprule
- \textbf{centrada} & \textbf{para direita} \\ \midrule}
-\tablehead{\multicolumn{2}{r}{(continuação)}\\ \toprule
- \textbf{centrada} & \textbf{para direita} \\ \midrule } % páginas do meio
-\tablelasthead{\multicolumn{2}{r}{(conclusão)}\\ \toprule
- \textbf{centrada} & \textbf{para direita} \\ \midrule} % última página
-\begin{xtabular}{c|r}
- %\hline % linha superior
- %\textbf{centrada} & \textbf{para direita} \\
- % \toprule %\hline
- linha 1 & coluna 2 \\ % \midrule %\hline
- linha 2 & coluna 2 \\ % \midrule %\hline
- linha 3 & coluna 2 \\ % \midrule %\hline
- linha 4 & coluna 2 \\ % \midrule %\hline
- linha 5 & coluna 2 \\ % \midrule %\hline
- linha 6 & coluna 2 \\ % \midrule %\hline
- linha 7 & coluna 2 \\ % \midrule %\hline
- linha 4 & coluna 2 \\ % \midrule %\hline
- linha 5 & coluna 2 \\ % \midrule %\hline
- linha 6 & coluna 2 \\ % \midrule %\hline
- linha 7 & coluna 2 \\
- \bottomrule % \hline
- \end{xtabular}
-
- {\footnotesize Fonte: elaboração do autor}
-\end{center}
+% Configurando a legenda pelo comando definido no preambulo
+\SetTblrSource{\url{https://blog.nubank.com.br/ipca-2022/}\\
+\url{https://brasilindicadores.com.br/poupanca/}}
+\SetTblrNote{Pode colocar apenas uma nota que é opcional}
+\begin{longtblr}
+[%
+ caption = {Inflação (IPCA) e juro de poupança de 2022}, % titulo
+ label={tab:abnt:longa}, % rotulo para referências cruzadas
+]
+{
+ colspec = {XXX}, % colunas de largura automatica
+ rowhead = 1, % primeira linha será repatida em todas páginas
+ row{1} = {font=\bfseries}, % linha de título
+ row{even} = {gray!50}, % linha par em cinza
+ row{Z} = {font=\bfseries,white}, % última linha
+}
+\toprule
+Mês & Inglação & Poupança \\
+\midrule
+Janeiro & 0,54 & 0,5608 \\
+Fevereiro & 1,01 & 0,5000 \\
+Março & 1,62 & 0,5976 \\
+Abril & 1,06 & 0,5558 \\
+Maio & 0,47 & 0,6671 \\
+Junho & 0,67 & 0,6491 \\
+Julho & -0,68 & 0,6639 \\
+Agosto & -0,36 & 0,7421 \\
+Setembro & -0,29 & 0,6814 \\
+Outubro & 0,59 & 0,6501 \\
+Novembro & 0,41 & 0,6515 \\
+Dezembro & 0,62 & 0,7082 \\
+\bottomrule
+Acumulado do ano & 5,79 & 7,8997 \\
+\begin{tblr}
\end{lstlisting}
\end{singlespacing}
-
-\section{Documento ABNT usando \texttt{ABNTexto}}
-A classe \texttt{ABNTexto}\index{ABNTexto} que está na fase de desenvolvimento é uma alternativa leve para \texttt{ABNTeX2}, para diagramar em \texttt{ABNT}. Enquanto que \texttt{ABNTeX2} usa a classe \texttt{memoir} e diversos pacotes para maior flexibilidade, \texttt{ABNTexto} usa a classe \texttt{article} e muitos poucos pacotes, tornando muito leve.
-% No entanto, como ele ainda está na fase de desenvolvimento (2024), pode apresentar algumas inconveniências.
-Um exemplo de \texttt{ABNTexto} com uso de Bib\LaTeX{} é como no Exemplo~\ref{ex19:abntexto}, cuja saída é omitida.
+Se preferir, poderá reduzir as fontes do corpo da tabela para \verb+\footnotesize+, o que já é exigido em várias instituições que usam a norma \texttt{ABNT}. Para tal, poderá colocar a tabela entre \verb+\begin{footnotesize}+ e \verb+\end{footnotesize}+.
+Se preferir, poderá criar um ambiente para que isto seja feito automaticamente.
-\begin{singlespacing}
-\lstinputlisting[caption={ex19-abntexto.tex},label=ex19:abntexto]{latex-via-exemplos-abntexto}
-\end{singlespacing}
+\begin{remark}
+O ambiente \texttt{xtabular} do pacote \texttt{xtab} apresenta o comando para saber se tabela cabe ou não em uma única página (por exemplo, poderá testar se ocupa mais de uma página por \verb+\ifnum\PWSTlastpage > 1+), mas não há configuração padrão para repetir o nome da tabela na página seguinte (o que é feito na tabelas de IBGE).
+\end{remark}
-O \texttt{ABNTeX2} é mais completo, mas por basear na classe \texttt{momoir} e carregar diversos pacotes, torna mais pesado.
-Por outro lado, \texttt{abntexto} é baseado na classe \texttt{article} e depende de poucos pacotes, o que torna leve, apesar de ter menos recursos. Além disso, \texttt{ABNTeX2} implementa comandos e ambientes em português, enquanto que \texttt{abntexto} implementa comandos e ambientes em inglês.
+% Implementação do quadro (tabela textual)
+% O problema é
+% \SetTblrTemplate{ caption-lot } { quadro }
+% fora do preamble, mesmo indireta (como dentro do tema) ou ambiente providenciado causa erros:
+% Use of \??? doesn't match its definition.
+% <argument> \???
+%! LaTeX Error: Erroneous variable \l__tblr_template_caption-lot_default_t
+% Outros \SetTblrTemplate funcionam.
+%
+% O comando foi criado para colocar quadro na lista de quadros, mas se chamar no preamble, tabelas vai ficar na lista de quadros também.
+% Se não chamar, quadros ficará na lista de tabelas.
+%
+% Precisará ver, como implementar o quadro longo corretamente, pois o codigo a seguir, está dando erro devido ao problema ciatada anteriormente.
+%No \texttt{ABNT}, tabelas com descrições qualitativas (textos em vez de números) é denominado de ``quadros''\index{quadro}. A classe \texttt{ABNTeX2} não implementa o ``quadro''. Se pretende usar, precisará providenciar o ambiente de quadros, lista de quadros, etc.
+%Para ambiente flutuante, poderá efetuar com o pacote \texttt{float}\index{float}. Para o caso de quadro longa, poderá implementar sobre a tabela longa, mas no caso de usar o \texttt{tabularray}, poderá implementar como tema em vez do ambiente, acrescentando um pouco mais de códigos no \texttt{preamble} anterior. O código a seguir, assume que está usando a classe \texttt{abntex2} que é baseado memoir.
+%%, supondo carregado os pacotes \texttt{float} e \texttt{tabularray}.
+%
+%\begin{singlespacing}
+%\begin{lstlisting}
+%
+%% quadros
+%\newcommand{\quadroname}{Quadro}
+%\newcommand{\listofquadrosname}{Lista de \quadroname s}
+%
+%\newcommand{\listadeqadros}{\listof{quadro}{Lista de \listofquadrosname}}
+%
+%\newfloat{quadro}{tbp}{loq}[chapter]
+%%\counterwithout{quadro}{chapter} desvincular no capítulo
+%
+%\ExplSyntaxOn
+%
+%\NewTblrTheme{quadro}{
+% \SetTblrTemplate{ caption-lot }{ quadro }
+% \SetTblrTemplate{ caption-tag } { quadro }
+%}
+%
+%\DefTblrTemplate { caption-lot } { quadro }
+%{
+% \addtocounter{table}{-1}
+% \stepcounter{quadro}
+% \tl_if_empty:NTF \lTblrEntryTl
+% { \tl_set_eq:NN \l__tblr_caption_short_tl \lTblrCaptionTl }
+% { \tl_set_eq:NN \l__tblr_caption_short_tl \lTblrEntryTl }
+% \addcontentsline { loq } { table }
+% { \protect\numberline { \thequadro } { \l__tblr_caption_short_tl } }
+%}
+%
+%%% We need to use \hspace and \enskip, but not ~ or \space,
+%%% since we want a correct hangindent caption paragraph.
+%
+%\DefTblrTemplate { caption-tag } { quadro } { \quadroname\hspace{0.25em}\thequadro }
+%
+%\ExplSyntaxOff
+%\end{lstlisting}
+%\end{singlespacing}
+%
+%Com isso, poderá usar a tabela e quadros, como no Exemplo~\ref{ex19:abnt-quadro}. A distinção entre tabela e quadro será feito pelo \verb+theme=quadro,+ na primeira opção do parâmetro opcional de \texttt{longtblr} ou \texttt{talltblr}.
+%
+%\begin{singlespacing}
+%\begin{lstlisting}[caption={ex19-abnt-table.tex},label={ex19:abnt-table}]
+%Sem a opção do tema, será produzido a tabela. Note que na tabela não pode fechar os laterais (Exemplo~\ref{tab:talltblr:simples}).
+%
+%\SetTblrSource{Elaboração do autor}
+%\begin{table}[hbp!]
+%\begin{talltblr}
+%[
+% caption={Tabela simples},
+% label={tab:talltblr:simples},
+%]
+%{
+% colspec = {XX},
+%}
+%\toprule
+%nome & valor \\
+%a & 1 \\ \midrule
+%c & 2 \\ \bottomrule
+%\end{tallblr}
+%\end{table}
+%
+%O quadro é produzido pelo tema \texttt{quadro} como no Exemplo~\ref{quadro:longo}. Note que, quadro deve fechar todos os lados e fazer divisório.
+%
+%\SetTblrSource{Elaboração do autor}
+%\SetTblrNote{Usando o tema quadro para produzir quadro}
+%\begin{longtblr}
+%[
+% theme=quadro,
+% caption={Um quadro longo simples},
+% label={quadro:longo},
+%]
+%{
+% colspec = {XX},
+% vlines,hlines, % fazer grade
+%}
+%linha 1 & 1 \\
+%linha 2 & b \\
+%linha 3 & c \\
+%linha 4 & d \\
+%linha 5 & e \\
+%\pagebreak % quebrando página para teste
+%linha 6 & f \\
+%linha 7 & g \\
+%linha 8 & h \\
+%linha 9 & i \\
+%linha 10 & j \\
+%\end{longtblr}
+%
+%Quadro flutuante será produzido também pelo ambiente \texttt{quadro}, como no Quadro~\ref{quadro:flutuante}.
+%
+%\begin{quadro}[hbp!]
+%\SetTblrSource{Elaboração do autor}
+%\begin{talltblr}
+%[
+% caption={Quadro flutuante simples},
+% label={quadro:flutuante},
+%]
+%{
+% colspec = {XX},
+% vlines,hlines, % grades
+%}
+%Nome 1 & Sobrenome 1 \\
+%Nome 2 & Sobrenome 2 \\
+%\end{tallblr}
+%\end{quadro}
+%
+%\end{lstlisting}
+%\end{singlespacing}
+%
+%A lista de quadros para configuração anterior, será produzida com o comando \verb+\listadequadros+.
%%%%%%%%%%%%%% APÊNDICE %%%%%%%%%%
@@ -13034,7 +13490,7 @@
Macro para \texttt{Open Calc} (do \texttt{Open Office}) para gerar tabelas de \LaTeX{} a partir da planilha.
Não há atualização recente.
-\subsection{Pandoc\index{convertor!Pandoc}}
+\subsection*{Pandoc\index{convertor!Pandoc}}
site: \url{https://pandoc.org/}
@@ -13117,6 +13573,10 @@
Note que o central de repositório do (La)\TeX{} é o CTAN. Portanto, se estiver procurando algo, pode dar olhada primeiro no CTAN (\url{https://www.ctan.org/}).
+%\url{https://www.tablesgenerator.com}
+%Gerador de \texttt{layout} das tabelas em \LaTeX.
+% Parcialment gratuito? o que quer dizer "Seus 10 primieros clientes gratuitos"?
+
% \clearpage
\clearpage\thispagestyle{empty}\cleardoublepage
\phantomsection
@@ -13155,6 +13615,7 @@
\clearpage\thispagestyle{empty}\cleardoublepage
\backmatter
% Referências Bibliográficas
+\nocite{*}
\phantomsection
\bibliography{latex-via-exemplos}
% \bibliographystyle{amsalpha}
More information about the tex-live-commits
mailing list.