texlive[73086] Master/texmf-dist/doc/latex/latex-via-exemplos:
commits+karl at tug.org
commits+karl at tug.org
Mon Dec 9 22:14:59 CET 2024
Revision: 73086
https://tug.org/svn/texlive?view=revision&revision=73086
Author: karl
Date: 2024-12-09 22:14:59 +0100 (Mon, 09 Dec 2024)
Log Message:
-----------
latex-via-exemplos (9dec24)
Modified Paths:
--------------
trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/README.md
trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/changelog.txt
trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-fig.tex
trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-poster.tex
trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-slides.tex
trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-todonotes.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
trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/makedoc.sh
Added Paths:
-----------
trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-twoside.tex
Removed Paths:
-------------
trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-twosides.pdf
trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-twosides.tex
trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/makeaux.sh
Modified: trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/README.md
===================================================================
--- trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/README.md 2024-12-09 21:14:45 UTC (rev 73085)
+++ trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/README.md 2024-12-09 21:14:59 UTC (rev 73086)
@@ -56,6 +56,16 @@
bash makedoc.sh
+to produce one sided document and
+
+ bash makedoc.sh twoside
+
+to produce two sided document.
+
+ bash makedoc.sh help
+
+show usage parameters.
+
Remark
------
The latex-via-exemplos.tex require japanese font in way to compile,
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-09 21:14:45 UTC (rev 73085)
+++ trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/changelog.txt 2024-12-09 21:14:59 UTC (rev 73086)
@@ -1,3 +1,8 @@
+version 2024-12-08
+ - new fonts examples: mlmodern, sansmathfonts, and fontsetup.
+ - updated example for anbtexto for ABNT
+ - some new packages.
+ - some bug fixes.
version 0.5.10 (2023-10-23)
- Small additional comment over \collect at body of amsmath
- Bug fix trick for combine on recent TeX distro.
Modified: trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-fig.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-fig.tex 2024-12-09 21:14:45 UTC (rev 73085)
+++ trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-fig.tex 2024-12-09 21:14:59 UTC (rev 73086)
@@ -12,7 +12,8 @@
\usetikzlibrary{patterns}
\begin{document}
\begin{tikzpicture}
-\draw[pattern=north east lines] (-1,-1) rectangle(1,1);
-\draw[fill=white] (0,0) circle(1);
+%\draw[pattern=north east lines] (-1,-1) rectangle(1,1);
+%\draw[fill=white] (0,0) circle(1);
+\draw[pattern=north east lines] (-1,-1) rectangle(1,1) (0,0) circle(1);
\end{tikzpicture}
\end{document}
Modified: trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-poster.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-poster.tex 2024-12-09 21:14:45 UTC (rev 73085)
+++ trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-poster.tex 2024-12-09 21:14:59 UTC (rev 73086)
@@ -19,6 +19,8 @@
\usepackage[usenames]{xcolor} % usar cores
\usepackage{fancybox} % para molduras adicionais nas caixas
+\usepackage{sansmathfonts} % sans serif extension to computer modern (use sans serif on math)
+
% espacamento entre colunas
\setlength{\columnsep}{1cm}
% \setlength{\columnseprule}{1pt} % separador de colunas
@@ -35,8 +37,6 @@
% \newcommand{\maintitlebox}[1]{\shadowbox{\parbox{0.99\columnwidth}{#1}}}
% \newcommand{\titlebox}[1]{\fbox{\parbox{1.0\columnwidth}{#1}}}
-% \usepackage{cmbright} % computer modern compatible sans serif font for text and math
-
\renewcommand\familydefault{\sfdefault} % Usar sans serif por padrao
\pagestyle{empty} % sem enumeracao das paginas
\begin{document}
@@ -47,6 +47,7 @@
\begin{center}
\vspace{1pc}
\Huge
+\bfseries
% podera acrescentar logo, usando inludegraphics
% \includegraphics[height=4pc]{logo-esquerda}
% \hfill
Modified: trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-slides.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-slides.tex 2024-12-09 21:14:45 UTC (rev 73085)
+++ trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-slides.tex 2024-12-09 21:14:59 UTC (rev 73086)
@@ -14,7 +14,7 @@
\usepackage{amssymb,amsmath} % para incrementar fórmulas
\usepackage{tikz} % para cria degrade no fundo
-%\usepackage[condensed,math]{iwona} % Mudando fontes
+%\usepackage[sfdefault]{notomath} % Mudando fontes
\usepackage{lipsum} % para gerar texto, para teste
% \usepackage{hyperref} % ja eh carregado pelo beamer
Modified: trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-todonotes.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-todonotes.tex 2024-12-09 21:14:45 UTC (rev 73085)
+++ trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-todonotes.tex 2024-12-09 21:14:59 UTC (rev 73086)
@@ -1,4 +1,4 @@
-\documentclass{article}
+\documentclass[a4paper,12pt]{article}
\usepackage[utf8]{inputenc}
\usepackage[portuguese]{todonotes}
\begin{document}
Added: trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-twoside.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-twoside.tex (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-twoside.tex 2024-12-09 21:14:59 UTC (rev 73086)
@@ -0,0 +1,6 @@
+\documentclass[12pt,a4paper,twoside,openright]{book}
+
+%\newif\iftwosidedocument
+%\twosidedocumentfalse
+
+\input{latex-via-exemplos}
Property changes on: trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-twoside.tex
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Deleted: trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-twosides.pdf
===================================================================
(Binary files differ)
Deleted: trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-twosides.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-twosides.tex 2024-12-09 21:14:45 UTC (rev 73085)
+++ trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-twosides.tex 2024-12-09 21:14:59 UTC (rev 73086)
@@ -1,6 +0,0 @@
-\documentclass[12pt,a4paper,twoside,openright]{book}
-
-%\newif\iftwosidedocument
-%\twosidedocumentfalse
-
-\input{latex-via-exemplos}
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-09 21:14:45 UTC (rev 73085)
+++ trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos.bib 2024-12-09 21:14:59 UTC (rev 73086)
@@ -97,8 +97,7 @@
@book{book:abnt2:araujo,
author={Lauro César Araujo},
-title={A classe abntex2: Documentos técnicos e científicos brasileiros
-compatíveis com as normas ABNT},
+title={A classe abntex2: Documentos técnicos e científicos brasileiros compatíveis com as normas ABNT},
url={https://ctan.org/pkg/abnt2/},
lastchecked={2018-06-11},
urldate={2018-06-11},
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-09 21:14:45 UTC (rev 73085)
+++ trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos.tex 2024-12-09 21:14:59 UTC (rev 73086)
@@ -16,16 +16,26 @@
\usepackage{iftex} % detectar motor TeX usado
% testing TeX engine
-\ifPDFTeX
+%\ifPDFTeX
+% \PackageError{\jobname}{Precisa de XeLaTeX ou LuaLaTeX}{Use XeLaTeX ou LuaLaTeX}
+%\fi
+
+\ifXeTeX
+\else\ifLuaTeX
+\else
\PackageError{\jobname}{Precisa de XeLaTeX ou LuaLaTeX}{Use XeLaTeX ou LuaLaTeX}
-\fi
+\fi\fi
-\usepackage[english,brazil]{babel}
+\usepackage[english,brazil]{babel} % brazil como padrão
-% Font selection
-\usepackage{fontspec}
-\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}
@@ -232,6 +242,12 @@
% o pacote tasks ja carregou o ulem. Carregar de novo causa erro
% Agora tasks não carrega mais (carregar explicitamente)
\usepackage[normalem]{ulem} % sublinhar,tachar, etc no texto
+
+\usepackage{soul} % para destacar
+\setulcolor{green} % cor para sublinhar
+\setstcolor{red} % cor para cancelar
+\sethlcolor{yellow} % cor para destaque
+
\usepackage{cancel} % cancelar elemento
% para cortar seta longa (negação da seta longa)
\usepackage{centernot} % cortar símbolo no centro
@@ -254,7 +270,7 @@
%
% \toprule, midrule, cmidrule{}, bottomrule
\usepackage{booktabs}
-% xtabular
+% xtabular (tabela longa cnfigurável)
\usepackage{xtab}
%
% Para evaluar expressões matemáticas
@@ -262,6 +278,8 @@
\usepackage{numerica}
\usepackage{numerica-tables}
+\usepackage{yfonts} % fonte Baroque para iniciais
+
% TODO's
%\usepackage{todonotes} % carega xkeyval, tikz, etc
@@ -1002,8 +1020,9 @@
% Setima atualização (0.5.8): 17 de maio de 2022
% Oitava atualização (0.5.9): 01 de maio de 2023
% Nona atualização (0.5.9): 01 de maio de 2023}
-% Decima atualização
-\date{Versão 0.5.10, 23 de outubro de 2023}
+% Decima atualização (0.5.10): 08 de dezembro de 2024}
+% Decima primeira atualização
+\date{Versão 0.5.11, 08 de dezembro de 2024}
%%%%%%%%%%%%%%%%%%%%%%%
% Documet start here
@@ -1014,7 +1033,7 @@
\thispagestyle{empty}
-Copyright \textcopyright 2018--2023 por Sadao Massago.
+Copyright \textcopyright 2018--2024 por Sadao Massago.
Todos os direitos reservados.
Este documento é software livre; podendo ser redistribuído e/ou modificado de acordo com os termos da Licença Pública da GNU como publicado pela Free Software Foundation; versão 2 da Licença, ou (se for sua opção) qualquer versão posterior.
Veja \url{https://opensource.org/licenses/gpl-license}.
@@ -1029,7 +1048,7 @@
\clearpage\thispagestyle{empty}\cleardoublepage
\frontmatter
\chapter*{}
-``\emph{Ninguém é tão pobre que nada possa dar e ninguém é tão rico que não precise receber}''
+``\emph{Ninguém é tão pobre que nada possa dar e ninguém é tão rico que não precise receber}''
(Alvaro Granha Loregian)
\clearpage\thispagestyle{empty}\cleardoublepage
@@ -1110,7 +1129,8 @@
% Sorocaba, dezembro de 2019.
% Sorocaba, julho de 2021.
% Sorocaba, maio de 2022.
-Sorocaba, outubro de 2023.
+% Sorocaba, outubro de 2023.
+Sorocaba, dezembro de 2024.
\
@@ -1148,7 +1168,7 @@
A versão mais utilizada do \LaTeX{} foi concluído em 1994 que é o \LaTeXe{} \cite{book:lamport:1994}.
Em 2004, o \TeX{} começou a suportar oficialmente o \texttt{utf-8}, facilitando a elaboração de documentos multi-idiomas.
Em 2007, o Xe\TeX{} que suporta o uso de fontes do sistema implementado inicialmente no \texttt{Mac OSX} foi portado para \texttt{linux} e \texttt{Windows}.
-Em 2008, o recurso de sincronização do documento fonte com o PDF tornou fácil e PDF foi substituindo a saída DVI do \TeX{} na diagramação.
+Em 2008, o recurso de sincronização do documento fonte com o \texttt{PDF} tornou fácil e \texttt{PDF} foi substituindo a saída DVI do \TeX{} na diagramação.
Em 2010 foi lançado a primeira versão estável do Lua\TeX{}, considerado como o sucessor do PDF\TeX{}.
O Lua\TeX{}, além de poder usar as fontes do sistema como o Xe\TeX, também pode estender a funcionalidade com a linguagem script \texttt{Lua}.
@@ -2133,6 +2153,7 @@
%\end{singlespacing}
%\let\mathcal\orimathcal
%\let\mathbb\orimathbb
+Se precisar deixar algum trecho da fórmula em negrito, poderá usar o comando \verb+\bm+ do pacote \texttt{bm}\index{bm}.
Note que no \texttt{argmin}, o $x$ será colocado embaixo e não como índice. Para que o que foi colocado como índice fique embaixo, usa-se o comando \verb+\mathop+\index{modo matematico@{modo matemático}!basico@{básico}!\verb+\mathop+}.
O comando \verb+\,+ usado no meio de \texttt{argmin} é um comando de espaçamento usado na fórmula que insere pequeno espaço. Mais sobre espaçamentos no modo matemático, veja a Seção~\ref{sec:medidas:unidade} e Seção~\ref{sec:medidas} do Caítulo~\ref{chap:medidas:contadores}.
@@ -4261,8 +4282,10 @@
Note que, por padrão, o processador \texttt{makeindex} aceita somente até 3 níveis de sub-entrada.
Caso queira mais níveis, poderá optar por usar \texttt{xindy}\index{xindy} em vez de \texttt{makeindex} com configuração adequada.
O \texttt{xindy} suporta indexação internacional, além de diversas configurações, entre eles, aumentar o nível de sub-entradas via arquivo de configuração.
-No entanto, dependendo do editor, pode não vir com botão para executar o \texttt{xindy}.
+Note que o desenvolvimento do \texttt{xindy} está parado. Assim, para índice remissivo internacional, é recomendado usar o \texttt{xindex}\index{xindex} ou \texttt{upmendex}\index{upmendex} em vez de \texttt{xindy}.
+No entanto, dependendo do editor, pode não vir com botão para executar o \texttt{xindex} ou similar.
+
O índice remissivo do Exemplo~\ref{ex11:index} ficaria como segue
%\begin{singlespacing}
@@ -4626,7 +4649,7 @@
O pacote de internacionalização \texttt{babel}\index{babel}
oferece regra de hifenização\index{hifenização} e nomes dos elementos tais como \texttt{capítulo}, \texttt{figura}, \texttt{tabela}, \texttt{sumário}, etc em vários idiomas\index{idioma}.
Para carregar mais de um idioma, coloque os idiomas separado pela vírgula no parâmetro do \texttt{babel}.
-O idioma do último será considerado padrão e outros são opcionais que podem ser ativados quando quiser.
+O idioma do último será considerado padrão e outros são opcionais que podem ser ativados quando quiser. Ma, se preferir, poderá usar ``\verb+main=<idioma>+'' na lista de parâmetros para indicar o idioma padrão.
Seleção de idiomas pode ser mudado por \verb+\selectlanguage{<idioma>}+\index{selectlanguage@\verb+\selectlanguage+}.
Para demarcar somente um trecho no outro idioma, usa-se o ambiente \texttt{otherlanguage}\index{otherlanguage}.
@@ -5428,7 +5451,7 @@
Como cada chamada, o comando redefine o comando interno,
o comando interno deve existir antes.
-Para redefinir um comando já existente, é interessante tirar uma cópia dele antes de redefinir, o que permitiria usar ou restaurar o comando original, caso necessário. Para copiar um comando, usa-se o \verb+\let+\index{\textbackslash let}.
+Para redefinir um comando já existente, é interessante tirar uma cópia dele antes de redefinir, o que permitiria usar ou restaurar o comando original, caso necessário. Para copiar um comando, usa-se o \verb+\let+\index{let@\verb+\let+}.
O Exemplo~\ref{ex14:comando:let} ilustra o uso de \verb+\let+.
\let\thesectionoriginaldolivro\thesection
@@ -5475,7 +5498,7 @@
o comando definido dentro do \verb+newcommand+ para diferenciar.
Os comandos \TeX{} correspondentes ao \verb+\newcommand+
-do \LaTeX{} são: \verb+\def+, \verb+edef+, \verb+gdef+ e \verb+xdef+.
+do \LaTeX{} são: \verb+\def+\index{def@\verb+\def+}, \verb+edef+, \verb+gdef+ e \verb+xdef+.
Observe que \verb+\def+ redefine o comando
caso já existir, o que requer cuidados para não alterar
@@ -5500,12 +5523,78 @@
\end{document}
\end{ltxlisting}
-Note que foi usado \verb+\gdef+\index{\textbackslash gdef} que é atalho para \verb+\global\def+, em vez de \verb+\def+ para que a definição fique disponível globalmente, dai em diante. No caso de usar o \verb+\def+, a definição só vale para dentro do ambiente que contém (caso definir comando usando \verb+\def+ dentro de algum ambiente -- entre \verb+\begin+ e \verb+\end+ -- fora dele o comando não estará disponível. No caso de \verb+\gdef+, comando definido continua disponível fora do ambiente).
+Note que foi usado \verb+\gdef+\index{gdef@\verb+\gdef+} que é atalho para \verb+\global\def+, em vez de \verb+\def+ para que a definição fique disponível globalmente, dai em diante. No caso de usar o \verb+\def+, a definição só vale para dentro do ambiente que contém (caso definir comando usando \verb+\def+ dentro de algum ambiente -- entre \verb+\begin+ e \verb+\end+ -- fora dele o comando não estará disponível. No caso de \verb+\gdef+, comando definido continua disponível fora do ambiente).
-Existe o comando \verb+edef+\index{\textbackslash edef} que expande os argumentos na hora de definir.
-Por exemplo, \verb+\def\pagina{thepage}+ define comando que imprime a página na qual o comando \verb+\pagina+ foi chamado, enquanto que \verb+\edef\pagina{thepage}+ define comando que imprime a página na qual o comando \verb+\pagina+ foi definido. Note que, \verb+xdef+ é um atalho para \verb+\global\edef+ que mantém a definição dos comandos globalmente.
+Existe o comando \verb+edef+\index{edef@\verb+\edef+} que expande os argumentos na hora de definir.
+Por exemplo, \verb+\def\pagina{thepage}+ define comando que imprime a página na qual o comando \verb+\pagina+ foi chamado, enquanto que \verb+\edef\pagina{thepage}+ define comando que imprime a página na qual o comando \verb+\pagina+ foi definido. Note que, \verb+xdef+\index{xdef@\verb+\xdef+} é um atalho para \verb+\global\edef+ que mantém a definição dos comandos globalmente.
No caso da definição de dentro ter parâmetro, a indicação de parâmetro também leva dois ``\#''.
+Outro caso é acrescentar algo no comando já existente, como em\verb+\def\foo{\foo{} mais algo}+ que causa erros pela recursão infinita e \verb+\edef\foo{\foo{} mais algo}+ que funciona devidamente. Note que, para adicionar algo no comando ou ambiente existente, deverá usar o \verb+\AddToHook+ ou similar para funcionar devidamente.
+\section{Alterando os comandos e ambientes existêntes}
+As vezes, queremos efetuar alteração no ambiente ou comandos existentes, adicionando comandos a mais. Isto costumava ser feito pelo comando \verb+\addto+ do pacote \texttt{babel} ou similar.
+%\verb+appto+ e similares do pacote \texttt{etoolbox}, mas a partir da versão do \LateX{} 01/10/2020, tal recurso tornou parte da base de \LateX, com o comando \verb+\AddToHook+.
+%Assim, vamos deixar \verb+\addto+ do \textt{babel} e comandos do \texttt{etoolbox} de lado e veremos o caso de uso de \verb+\AddToHook+ que não requer pacotes adicionais.
+
+Para exemplificar, considere o caso de definir o comando \verb+\foo+ e efetua a modificação posterior com o \verb+\AddToHook+\index{AddToHook@\verb+\AddToHook+}.
+
+\begin{singlespacing}
+\begin{lstlisting}
+\def\foo{um comando}
+\AddToHook{cmd/foo/before}% Adicionando no começo do comando
+{Este é }
+\AddToHook{cmd/foo/after}% Adicionando no final do comando
+{ de teste}
+\end{lstlisting}
+\end{singlespacing}
+%
+
+A definição original do comando \verb+\foo+ é imprimir ``um comando'', psa o primeiro \verb+\AddToHook+ acrescenta ``Este é '' antes dele, modificando para imprimir ``Este é um comando'' e o segundo \verb+\AddToHook+ adiciona `` de teste'' no final, para imprimir ``Este é um comando de teste''.
+No parâmetro de \verb+\AddToHook+, inicia com \verb+cmd+, indicando que é um comando e seguido do separador do campo \verb+/+ e o nome do comando. Depois coloca-se o separador novamente e coloca a posição que pode ser no início (\verb+before+) ou no final (\verb+after+). Se o último campo for omitido, será assumido \verb+\after+
+
+Para o caso de alterar o ambiente, especifica \verb+\env+ em vez de \verb+cmd+ e se a alteração for no inicialização do ambiente, coloca-se \verb+before+ no último campo e se a alteração for na finalização, coloca-se \verb+after+ no último campo do parâmetro.
+
+\begin{singlespacing}
+\begin{lstlisting}
+\newenvironment{myenv}{\begin{center}}{\end{center}}
+\AddToHook{env/myenv/before}% Adicionando no começo da inicializaçao do ambiente
+{\begin{bfseries}}
+\AddToHook{env/myenv/after}% Adicionando no final da finalização do ambiente
+{\end{bfseries}}
+\end{lstlisting}
+\end{singlespacing}
+%
+
+Caso o primeiro campo for omitido, será assumido como \verb+cmd+.
+
+Note que, o comando de inicialização e finalização do ambiente \verb+myenv+ são \verb+beginmyenv+ e \verb+endmyenv+ respectivamente. Assim, podemos adicionar códigos diretamente nestes comandos em vez do ambiente. Desta forma, para inserir comando no começo do documento\index{AddToHookbegindocument@\verb+AddToHook{begindocument}+} pode ser como no exemplo
+\begin{singlespacing}
+\begin{lstlisting}
+\makeatletter
+\AddToHook{begindocument}% Adicionando no começo do documento
+{ \@ifpackageloaded{graphicx}{
+ \def\logo{\includegraphics[height=3ex]{logo-ufscar}}
+ }{\def\logo{UFSCar }}
+}
+\makeatother
+\end{lstlisting}
+\end{singlespacing}
+
+que checará se o pacote \texttt{graphicx} foi carregado através do comando \verb+\@ifpackageloaded+\index{arrobaifpackageloaded@\verb+\@ifpackageloaded+}
+e caso positivo, define o comando \verb+\logo+ para inserir imagem de logotipo. Caso não for carregado, define o comando para apenas inserir o texto.
+Checar pacotes carregados para decidir o que fazer é técnica utilizada pelos desenvolvedores de pacotes.
+
+Alguns comandos/ambientes importantes para desenvolvedores, incluem Além do \texttt{begindocument} (início do documento), dependendo da necessidade, os desenvolvedores podem inserir código em \texttt{enddocument} (final do documento) e \texttt{shipout} (gerar página) também, para ajustar parâmetros, se necessário.
+
+Para acessar o parâmetro do comando ou ambiente, use \verb+\AddToHookWithArguments+\index{AddToHookWithArguments@\verb+\AddToHookWithArguments+}
+ em vez de \verb+\AddToHook+.
+
+Para mais detalhes, consulte o manual.
+
+% \AddToHook {begindocument}
+
+%\AtBeginDocument but for the enddocument hook.
+
+
\clearpage\thispagestyle{empty}\cleardoublepage
\chapter{Usando Pacotes Fora do \texttt{base} e \texttt{required}}
@@ -5661,6 +5750,25 @@
%\setcounter{section}{\value{lstorisection}}
%\let\addcontentsline\oriaddcontentsline
+Note que, em muitos casos do usos de \texttt{lettrine}, costuma usar a fonte enfeitada (fonte para iniciais) na primeira letra como no exemplo~\ref{lettrine:b} que supõe o uso do pacote \texttt{yfonts} com codificação \texttt{T1}, colocando o código
+
+\begin{singlespacing}
+\begin{lstlisting}
+\usepackage[T1]{fontenc}
+\usepackage{yfonts}
+\end{lstlisting}
+\end{singlespacing}
+
+no \texttt{preamble}.
+
+\begin{ltxlisting}[caption={ex15-lettrine-b.tex},label=ex15:lettrine:b]
+\chapter{Um Capítulo}
+\lettrine[lines=3]{\initfamily\small E}{xiste} um pacote chamado \texttt{letrine} que oferece o estilo literário francês (estilo bíblico) na qual a primeira letra do parágrafo ocupa varias linhas.
+Alguns livros literários usa este estilo somente para o parágrafo do primeiro capítulo, mantendo outros parágrafos como sendo normal. O primeiro parâmetro é a letra (primeira letra) que ocupará várias linhas, e o segundo parâmetro é a continuação dele até finalizar a palavra, que será escrito em maiúsculo. O comando ainda aceita parâmetros opcionais para ajustar quantas linhas vai ocupar, etc.
+\end{ltxlisting}
+
+Para mais fontes para iniciais, veja o \url{https://tug.org/FontCatalogue/}.
+
\section[Cabeçalho e títulos]{Ajustando o cabeçalho, títulos de capítulos e de figuras}
Ajustar o cabeçalho diretamente não é simples.
@@ -6174,29 +6282,40 @@
\end{ltxlisting}
-\section{Trocando as fontes}
+\section{Trocando as fontes -- parte 2}
\LaTeX{} dispõe de diversas fontes gratuitas para diagramar o documento.
-Em geral, usamos o \texttt{Latin Modern}\index{Latin Modern} que é uma extensão do \texttt{Computer Modern}\index{Computer Modern} para derivados de latim que tem letras acentuadas.
-Para isso, é só carregar o pacote \texttt{lmodern}\index{lmodern} com o comando
+Em geral, usamos o \texttt{Latin Modern}\index{Latin Modern} que é uma extensão do \texttt{Computer Modern}\index{Computer Modern} para derivados de latim que tem letras acentuadas.
+Outra opção é \texttt{MLModern}\index{MLModern} que é fonte compatível com \texttt{Computer Modern} e \texttt{Latin Modern}, mas um pouco mais grossa, adequado para livros eletrônicos.
+Note que o \texttt{Computer Modern} tradicional e \texttt{Latin Modern} são adequados para textos impressos no papel, e o \texttt{MLModern} é adequado para texto a ser lido na tela.
+Para usar o \texttt{MLModern}, carregue o pacote \texttt{mlmodern} e para usar a fonte \texttt{Latin Modern}, carregue o pacote \texttt{lmodern} no \texttt{preamble} do documento, como em
+
\begin{singlespacing}
\begin{lstlisting}
-\usepackage{lmodern} % latin modern
+\usepackage{mlmodern} % MLModern, com espessura Book.
+% \usepackage{lmodern} % Latin Modern, com espessura igual a Computer Modern tradicional.
\end{lstlisting}
\end{singlespacing}
%
-no preamble.
-Aqui, veremos algumas combinações que podem ser usadas, entre muitas outras.
+Além de variantes do tradicional \texttt{Computer Modern}, diversas combinações de fontes podem ser escolhidas usando pacotes correspondentes. Aqui, veremos algumas entre muitas outras.
-Concrete (texto e fórmula)
-\begin{singlespacing}
-\begin{lstlisting}
-\usepackage{lmodern} % para complementar
-\usepackage{ccfonts} % Concrete (serifa grossa?)
-\end{lstlisting}
-\end{singlespacing}
+%ML Modern\index{} (Compatível com computer modern, na espessura Book), mais grossa que tradicional, ideal para livros eletrônicos pela legibilidade na tela.
+%\begin{singlespacing}
+%\begin{lstlisting}
+%\usepackage{mlmodern} % ML Modern (compatível com computer modern, mas com espessura Book)
+%\end{lstlisting}
+%\end{singlespacing}
+
+%Concrete (texto e fórmula)
+%\begin{singlespacing}
+%\begin{lstlisting}
+%\usepackage{lmodern} % para complementar
+%\usepackage{ccfonts} % Concrete (serifa grossa?)
+%\end{lstlisting}
+%\end{singlespacing}
+
Fonte \texttt{Times} pode ser escolhido com
\begin{singlespacing}
\begin{lstlisting}
@@ -6211,18 +6330,38 @@
\end{lstlisting}
\end{singlespacing}
-A fonte \texttt{iwona} ideal para \texttt{poster} e \texttt{slides}.
+A fonte matemático em \texttt{sans serif}, compatível com o computer modern, ideal para \texttt{poster} e \texttt{slides}.
\begin{singlespacing}
\begin{lstlisting}
-\usepackage{lmodern} % para complementar
-\usepackage[math]{iwona} % sans serif com transição grosso fino
+\usepackage{lmodern} % computer modern com extensão para derivados ee latin
+\usepackage{sansmathfonts} %fonte compatível com computer modern sans para fórumulas matemáticas
+\renewcommand{\familydefault}{\sfdefault}% sans serif como padrão
\end{lstlisting}
\end{singlespacing}
+Outra opção para \texttt{poster} e \texttt{slides} (texto e fórmulas em \texttt{sans serif}). Por ser espessura ``Book'', é mas legível do que uso de \texttt{lmodern}+\texttt{sansmathfonts}.
+\begin{singlespacing}
+\begin{lstlisting}
+\usepackage[sfdefault]{notomath} % sffamily as \notosans
+\end{lstlisting}
+\end{singlespacing}
+
+Note que, o conjunto de fontes Noto ainda não tem fontes matemáticos serifados para matemática (2024). Se não precisar de fórmulas matemáticas, poderá usar o pacote \texttt{noto} para usar fontes \texttt{noto}.
+
+Se quer usar a fonte \texttt{sans serif} na fórmula matemática (para uso em \texttt{slides} e \texttt{poster}), poderá carregar o pacote \texttt{sfmath}\index{sfmath} ou similar para forçar a usar a fonte \texttt{sans serif} pra fórmulas, mas nem todas fontes tem símbolos necessários em \texttt{sans serif}. Por isso, \texttt{sfmath} permite usar fontes diferentes do texto na fórmula, através de opções.
+
+%A fonte \texttt{iwona} ideal para \texttt{poster} e \texttt{slides}.
+%\begin{singlespacing}
+%\begin{lstlisting}
+%\usepackage{lmodern} % para complementar
+%\usepackage[math]{iwona} % sans serif com transição grosso fino
+%\end{lstlisting}
+%\end{singlespacing}
+
Fonte \texttt{Schoolbook L}
\begin{singlespacing}
\begin{lstlisting}
-\usepackage{lmodern} % para complementar
+\usepackage{mlmodern} % para complementar
\usepackage{fouriernc} % schoobook L: Serifa grossa?
\end{lstlisting}
\end{singlespacing}
@@ -6234,6 +6373,8 @@
\usepackage{stix} % compativel com New Times Roman
\end{lstlisting}
\end{singlespacing}
+A versão nova da fonte \texttt{stix} pode ser carregado pelo pacote
+\texttt{stix2} .
Note que, para complementar a fonte com a outra, como do \texttt{amssymb}, deve carregar o complemento antes do pacote de fonte desejado.
Quando vários pacotes de fontes são carregados e tiver conflitos, o que vale é do pacote carregado por último.
@@ -6284,7 +6425,8 @@
%\end{LTXexample}
%\end{singlespacing}
-Para produzir o texto em degradê\index{degradê!texto}, existe o pacote novo chamado \texttt{gradient-text}\index{gradient-text} (\url{https://www.ctan.org/pkg/gradient-text}) de 2022 que implementa a aplicação do gradiente linear no texto. Caso ele não for instalável pelo gerenciador de pacotes e não souber instalar manualmente, basta abaixar o arquivo \texttt{gradient-text.sty} e deixar junto com o documento \TeX.
+Para produzir o texto em degradê\index{degradê!texto}, existe o pacote novo chamado \texttt{gradient-text}\index{gradient-text} (\url{https://www.ctan.org/pkg/gradient-text})% de 2022
+que implementa a aplicação do gradiente linear no texto. Caso ele não for instalável pelo gerenciador de pacotes e não souber instalar manualmente, basta abaixar o arquivo \texttt{gradient-text.sty} e deixar junto com o documento \TeX.
O \texttt{gradient-text} suporta somente o modelo de cor em RGB. Para usar outros modelos de cores como pelo nome, poderá criar um novo comando com auxilio do \verb+\convertcolorspec+\index{convertcolorspec@\verb+\convertcolorspec+} do pacote \texttt{xcolor}. Note que, para que letras acentuadas sejam aceitas, requer \XeLaTeX/Lua\LaTeX.
Veja o Exemplo~\ref{ex15:gradient-text}.
@@ -6344,7 +6486,8 @@
%\end{LTXexample}
%\end{singlespacing}
-Para controle mais sofisticado, existe um pacote novo \texttt{circledtext}\index{circledtext} (\url{https://www.ctan.org/pkg/circledtext}) de 2022. Caso ele não for instalável pelo gerenciador de pacotes e não souber instalar manualmente, basta abaixar o arquivo \texttt{textcircled.sty} e deixar junto com o documento \TeX.
+Para controle mais sofisticado, existe um pacote novo \texttt{circledtext}\index{circledtext} (\url{https://www.ctan.org/pkg/circledtext}).% de 2022.
+Caso ele não for instalável pelo gerenciador de pacotes e não souber instalar manualmente, basta abaixar o arquivo \texttt{textcircled.sty} e deixar junto com o documento \TeX.
Veja o Exemplo~\ref{ex15:circledtext}.
@@ -6536,7 +6679,7 @@
%\end{LTXexample}
%\end{singlespacing}
-O comando \verb+\legend+ é da classe \texttt{abntex2}, mas se quiser usar fora dela, basta colocar 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}
@@ -6823,7 +6966,7 @@
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 quer que não tenha esta separação, poderá carregar no modo de versão 2, com o comando \verb+\usepackage{siunitx}[=v2]+ e usar somente os comandos da versão 2.
\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} permmite tabelar funções rapidamente.
+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}.
@@ -6837,14 +6980,19 @@
Valor pelo \texttt{numerica} (com configuração padrão) é $\eval{\sin(\frac{\pi}{4})}$,
-Tabelando função com \texttt{numerica-table}
+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+}.
@@ -6980,6 +7128,7 @@
No Exemplo~\ref{ex15:lineno} foi usado o comando \verb+\lipsum+\index{lipsum@\verb+\lipsum+} que gera textos aleatórios em grego para preencher as páginas para testes.
Logo, precisa carregar o pacote \texttt{lipsum}\index{lipsum} no \texttt{preamble} para que o exemplo funcione.
+Para caso que queira preencher com texto contendo fórmulas, existe o pacote \texttt{blindtext}\index{blindtext}.
Existem vários pacotes que permitem colocar conteúdos em todas as páginas, como no caso de marca d'água.
Entre eles, vamos ver o caso do uso de \texttt{background}\index{background}, \texttt{draftwatermark}\index{draftwatermark} e
@@ -7637,6 +7786,27 @@
Linha pontilhada: \dotuline{pontilhada}
\end{ltxlisting}
+Para destacar texto, costuma usar o pacote \texttt{soul}\index{soul} como no exemplo~\ref{ex15:soul}, na qual a cor de destaque foi configurado com os comandos
+
+\begin{singlespace}
+\begin{lstlisting}
+\usepackage{soul} % para destacar
+\usepackage{xcolor} % para configurar cores
+\setulcolor{green} % cor para sublinhar
+\setstcolor{red} % cor para cancelar
+\sethlcolor{yellow} % cor para destaque
+\end{lstlisting}
+
+\end{singlespace}
+
+\begin{ltxlisting}[caption={ex15-soul.tex},label=ex15:soul]
+Espaçado: \so{espaçado} \\
+Small Caps: \caps{Small Caps} \\
+Sublinhado: \ul{sublinhado} \\
+Cancelando o texto: \st{errado} \\
+Destacando: \hl{destacando}
+\end{ltxlisting}
+
Para cancelar as equações, use o pacote \texttt{cancel}\index{cancel}.
Veja o Exemplo~\ref{ex15:cancel} para ver o uso.
@@ -8371,12 +8541,12 @@
\fi
\setmathfont{Latin Modern Math} % Padrão e não precisava. Foi colocado somente para ilustração
- % Fonte Noto não tem fontes matemáticos ainda
+ % Fonte Noto Serif não tem fontes matemáticos ainda
%\setmainfont[Ligatures=TeX]{NotoSerif}
%\setsansfont{NotoSans}
%\setmonofont{NotoMono}
% Asana math (Palatino like)
- % \setmainfont{Asana-Math}
+ % \setmathfont{Asana-Math}
% STIX (Times like font)
%\setmainfont[Ligatures=TeX]{STIX}
%\setmathfont{STIX Math}
@@ -8414,7 +8584,7 @@
%\begin{singlespacing}
%\begin{framed}
\begin{ltxlistingout}
-O Lua\LaTeX{} foi designado para ser o sucessor do PDF\LaTeX{} e por isso, deve ser o \LaTeX{} padrão no futuro. Por outro lado, \XeLaTeX{} e mais rápido e estável (2018).
+O Lua\LaTeX{} foi designado para ser o sucessor do PDF\LaTeX{} e por isso, deve ser o \LaTeX{} padrão no futuro. Por outro lado, Xe\LaTeX{} e mais rápido e estável (2018).
\ldots
@@ -8427,7 +8597,7 @@
%\end{framed}
%\end{singlespacing}
-O usuário de MS Windoes devem ficar atentos pelo fato de que a fonte ``Latin Modern Math'' usada no Exemplo~\ref{ex18:lualatex} não vem instalado por padrão no Mik\TeX{} Básico.
+O usuário de \texttt{MS Windows} devem ficar atentos pelo fato de que a fonte ``Latin Modern Math'' usada no Exemplo~\ref{ex18:lualatex} não vem instalado por padrão no Mik\TeX{} Básico.
Como \XeLaTeX/Lua\LaTeX{} acessa as fontes diretamente sem usar os pacotes, costuma precisar a instalação manual do pacote \texttt{lm-math} usando o gerenciador do Mik\TeX.
Existem algumas fontes \texttt{Open Type} com suporte a matemática que podem ser usados no \XeLaTeX/Lua\LaTeX.
@@ -8465,8 +8635,12 @@
Note que, nem todos os símbolos do \texttt{unicode-math} costumam estar presentes na fonte utilizada.
Quando a fonte utilizada não apresentar os símbolos correspondentes aos comandos de \texttt{unicode-math}, o símbolo simplesmente não aparece, sem emitir mensagens de erro, o que requer cuidados.
Neste caso, deverá complementar com outras fontes, ou procurar símbolos alternativos.
-Por exemplo, carregar o pacote \texttt{amssymb} antes do \texttt{unicode-math} complementa com os símbolos de AMS.
+Por exemplo, carregar o pacote \texttt{amssymb} antes do \texttt{unicode-math} complementa com os símbolos de \texttt{AMS}.
+\begin{remark}
+Além das melhores suportes das fontes, existem vários pacotes específicos para \XeLaTeX{} e Lua\LaTeX, como no caso de \texttt{luavlna}\index{luavlna} (para Lua\LaTeX) e \texttt{xevlna}\index{xevlna} (para \XeLaTeX) que impedem que as palavras de uma só letra ou similar, fiquem no final das linhas, o que ajudam na finalização do livro, em conjunto com o \texttt{microtype}.
+\end{remark}
+
\section[Fontes no \XeLaTeX/Lua\LaTeX]{Mais sobre básicos das fontes no \XeLaTeX/Lua\LaTeX}
No \XeLaTeX/Lua\LaTeX, poderá redigir em qualquer idioma desde que esteja utilizando as fontes que suportam tais idiomas.
@@ -8538,7 +8712,7 @@
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.
-No entanto, \texttt{iffont} não funciona devidamente no XeLaTeX/LuaLaTeX recente.
+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,
@@ -8575,7 +8749,7 @@
\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 dp \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.
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}).
@@ -8591,11 +8765,11 @@
%Lembrando novamente que os comandos do pacote \texttt{iffont} não funcionam devidamente no Lua\LaTeX{} (testados nas versões 2016 e março de 2018).
%Se estiver usando o Lua\LaTeX, use \verb+\IfFontExistsTF+ em vez das funções do pacote \texttt{iffont}.
-As fontes 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.
+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 caso de querer usar as fontes da MicroSoft no MS Windows,% compilando com LuaLaTeX,
+No caso de querer usar as fontes da \texttt{MicroSoft} no \texttt{MS Windows},% compilando com LuaLaTeX,
coloque
\begin{singlespacing}
@@ -8607,8 +8781,35 @@
\end{lstlisting}
\end{singlespacing}
-no preamble, lembrando que no caso de XeLaTeX, fontes que não está no sistema (como fontes que esã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}.
+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.
+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.
+
+\begin{singlespacing}
+\begin{lstlisting}[caption={ex18-fontsetup.tex},label=ex18:fontsetup]
+\usepackage{iftex} % Para detectar o motor de TeX utilizado
+% Fontes, de acordo com o motor do TeX
+\ifPDFTeX % PDFLaTeX
+ \usepackage[T1]{fontenc} % codificação da fonte em 8-bits
+ \usepackage{mlmodern} % fontes MLModern que é mais escura que Computer Modern tradicional (espessura de letra de Book)
+ %\usepackage{lmodern} % fontes Latin Modern: espessura tradicional do Computer Modern
+ \usepackage[utf8]{inputenc} % acentuação direta em UTF-8
+\else % XeLaTeX/LuaLaTeX
+ % \usepackage{fontspec} % pacote para configurar fontes
+ % \defaultfontfeatures{Ligatures=TeX}
+ % seleção das fontes desejadas pode ser colocados aqui
+ \usepackage{fontsetup} % New Computer Modern com espessura da letra de Book
+ % \usepackage[olddefault]{fontsetup} % espessura tradicional do Computer Modern
+\fi
+\end{lstlisting}
+\end{singlespacing}
+
\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.
O Bib\LaTeX{} permite internacionalizar a referência bibliográfica (mesmo sem usar \XeLaTeX/Lua\LaTeX).
@@ -8818,7 +9019,7 @@
\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).
-A classe 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 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
@@ -8848,11 +9049,14 @@
% Fontes, de acordo com o motor do TeX
\ifPDFTeX
\usepackage[T1]{fontenc} % codificação da fonte em 8-bits
- \usepackage{lmodern} % fontes latin modern
+ \usepackage{mlmodern} % fontes MLModern
+ %\usepackage{lmodern} % fontes Latin Modern
\usepackage[utf8]{inputenc} % acentuação direta em UTF-8
\else
- \usepackage{fontspec} % pacote para configurar fontes
- \defaultfontfeatures{Ligatures=TeX}
+ \usepackage{fontsetup} %New Computer Modern com espessura Book
+ % Note que a fonte padrão para XeLaTeX/LuaLaTeX é latin Modern
+ %\usepackage{fontspec} % pacote para configurar fontes
+ %\defaultfontfeatures{Ligatures=TeX}
% seleção das fontes desejadas pode ser colocados aqui
\fi
% pacotes matemáticas de acordo com o motor TeX
@@ -9070,7 +9274,7 @@
\section{Usando o estilo ABNT no \BibTeX}
-Quando as referências bibliográficas devem seguir a norma ABNT, use o pacote \texttt{abntex2cite}\index{abntex2cite} que pode ser usado separadamente da classe \texttt{abntex2}.
+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}.
É importante lembrar que este pacote requer que o pacote \texttt{hyperref} seja carregado antes dele.
Caso contrário, pode produzir erros, mas não costuma ser avisado de que \texttt{hyperref} precisa ser carregado antes.
@@ -9086,11 +9290,13 @@
\usepackage{iftex} % Para detectar o motor de TeX utilizado
\ifPDFTeX% Fontes, de acordo com o motor do TeX
\usepackage[T1]{fontenc} % codificação da fonte em 8-bits
- \usepackage{lmodern} % fontes latin modern
+ \usepackage{mlmodern} % fontes MLModern
+ %\usepackage{lmodern} % fontes Latin Modern
\usepackage[utf8]{inputenc} % acentuação direta em UTF-8
\else
- \usepackage{fontspec} % pacote para configurar fontes
- \defaultfontfeatures{Ligatures=TeX}
+ \usepackage{fontsetup}% New Computer Modern
+ %\usepackage{fontspec} % pacote para configurar fontes
+ %\defaultfontfeatures{Ligatures=TeX}
% seleção de fontes, se desejar
% ...
\fi
@@ -9201,7 +9407,7 @@
Para isso, coloque a opção \texttt{style=abnt}\index{biblatex!abnt} na opção de chamada do pacote \texttt{biblatex}.
-A data de último acesso ao material disponível na internet será colocado no campo \texttt{urldate} do arquivo \texttt{.bib} no formato \texttt{ano-mes-dia} onde ano será com $4$ digitos.
+A data de último acesso ao material disponível na internet será colocado no campo \texttt{urldate} do arquivo \texttt{.bib} no formato \texttt{ano-mes-dia} onde ano será com $4$ dígitos.
Note que \texttt{urlaccessdate} usado pelo \BibTeX{} também pode ser usado no Bib\LaTeX, mas \texttt{urldate} funcionam em vários estilos e não somente no estilo \texttt{abnt}.
Caso queira usar tanto o \BibTeX, assim como Bib\LaTeX, poderá especificar ambos os campos (e usar a acentuação no modo \TeX).
@@ -9253,12 +9459,14 @@
% Fontes, de acordo com o motor do TeX
\ifPDFTeX
\usepackage[T1]{fontenc} % codificação da fonte em 8-bits
- \usepackage{lmodern} % fontes latin modern
+ \usepackage{mlmodern} % fontes MLModern
+ %\usepackage{lmodern} % fontes Latin Modern
\usepackage[utf8]{inputenc} % acentuação direta em UTF-8
\else
- \usepackage{fontspec} % pacote para configurar fontes
- \defaultfontfeatures{Ligatures=TeX}
- % comandos de seleção das fontese, se desejar
+ \usepackage{fontsetup} % fontes New Computer Modern
+ %\usepackage{fontspec} % pacote para configurar fontes
+ %\defaultfontfeatures{Ligatures=TeX}
+ % comandos de seleção das fontes, se desejar
% ...
\fi
% pacotes matemáticas de acordo com o motor TeX
@@ -9393,13 +9601,85 @@
Para mais detalhes sobre comandos do estilo ABNT para Bib\LaTeX, veja \cite{book:biblatex-abnt:marques}.
-\section{ABNTexto}
-A classe \texttt{ABNTexto}\index{ABNTexto} que está na fase de desenvolvimento é uma alternativa leve para \texttt{ABNTeX2}, para diagramar em ABNT. Enquando 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, deixando mais leve.
-No entanto, como ele ainda está na fase de desenvolvimento (2023), faltam comandos e podem apresentar inconveniências, o que devem ser supridas manualmente.
+\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.
+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}
-Um exemplo de ABNTexto com uso de BibTeX é como no Exemplo~\ref{ex19:abntexto}, cuja saída é omitida.
+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.
\begin{singlespacing}
+\begin{lstlisting}[caption={ex19-abnt-table.tex},label={ex19:abnt-table}]
+A Tabela Tabela~\ref{tab:primeira} é o que auto posiciona.
+
+\begin{table}[hbp!]
+\centering
+\caption{Um título}\label{tab:primeira}
+\begin{tabular}{ll}
+\toprule %\hline
+ produto & preço \\
+\midrule %\hline
+ cenouras (500g) & R\$0,50 \\
+ 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}
+\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: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}
+\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 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.
+
+\begin{singlespacing}
\begin{lstlisting}[caption={ex19-abntexto.tex},label={ex19:abntexto}]
% Padrão para abntexto
% Classe base: article
@@ -9406,23 +9686,33 @@
% pacote adicional: geometry, graphicx
% font size: 12pt
% twoside=true
-% neste modelo, força para ser oneside (versão eletrônica)
+% Observação: Tabelas e figuras flutuantes não estão suportados oficienalemnte (2024). Além disso, tabela flutuante está desativada e a figura flutuante pode não funciona junto com subfiguras -- usando multiplace desta classe --
+%
+% neste modelo, usa o layout de um lado
\documentclass[a4paper]{abntexto}
+% O padrão é dois lados. Para um lado, ou modo eletronico (um lado com margem menor), requer pequeno ajuste
+% Em um lado somente
+\let\twosidelayout=\onesidelayout
+
+% No formato eletronico (suas margens parece não ser de ABNT)
+%\let\onesidelayout=\eletroniclayout% pretextual
+%\let\twosidelayout=\eletroniclayout% textual
+
\usepackage{iftex} % Para detectar o motor de TeX utilizado
% Fontes, de acordo com o motor do TeX
-\ifPDFTeX
- \usepackage[T1]{fontenc} % codificação da fonte em 8−bits
- \usepackage{lmodern} % fontes latin modern
- \usepackage[utf8]{inputenc} % acentuação direta em UTF−8
-\else
- \usepackage{fontspec} % pacote para configurar fontes
- \defaultfontfeatures{Ligatures=TeX}
- % seleção das fontes desejadas pode ser colocados aqui
+\ifPDFTeX % PDFLaTeX
+ \usepackage[T1]{fontenc} % codificação da fonte em 8-bits
+ \usepackage{mlmodern} % fontes MLModern que é mais escura que Computer Modern tradicional (espessura de letra de Book)
+ %\usepackage{lmodern} % fontes Latin Modern: espessura tradicional do Computer Modern
+ \usepackage[utf8]{inputenc} % acentuação direta em UTF-8
+\else % XeLaTeX/LuaLaTeX
+ \usepackage{fontsetup} % New Cmputer Modern com espessura da letra de Book
+ % \usepackage[olddefault]{fontsetup} % espessura tradicional do Computer Modern
\fi
% idiomas
-\usepackage[english,brazil]{babel}%padrão é brazil.
+\usepackage[english,main=brazil]{babel}%padrão é brazil.
% pacotes matemáticas de acordo com o motor TeX
\ifPDFTeX
@@ -9435,7 +9725,6 @@
\fi
\fi
%Outros pacotes
-\usepackage[overload]{textcase} % para poder ter comandos de LaTeX/fórmula no titulo
\usepackage{hyperref} % para link automático no PDF
% Desabilitando ou redefinindo comandos que causa erros no bookmark do PDF
\pdfstringdefDisableCommands{%
@@ -9448,7 +9737,14 @@
%% Se for criar o índice remissivo (opcional)
%\usepackage{makeidx}
%\makeindex
+\usepackage{microtype} % micro tipografia para ajuste refinado de espaçamento
+
+\usepackage{xtab} % para tabela longa configurável xtabular
+% Para linhas horizontais com espaçamento melhorado: \toprule, \midrule, \bottomrule, \cmidrule
+\usepackage{booktabs}
+
% BibLaTeX
+\usepackage{csquotes} % biblatex recomenda quando usar o pacote de idiomas babel/poligrossia
\usepackage[
backend=biber,
% backref é util para depulação: na referências, aparece páginas onde foi citado
@@ -9465,20 +9761,63 @@
% \renewcommand{\refname}{Referências}
%}
-% Como classe base é article, referências bibliográficas ficam como seção. Para ser capítulo, precisa de ajustes
-\defbibheading{bibliography}[\refname]{\heading{#1}}%\chapter*{#1}}
+% Mesmo com \usechapters, tamanho das fontes do título da referências bibliográficas e similares ficam como seção. Para ser de capítulo, precisa de ajustes
+\defbibheading{bibliography}[\refname]{\chapter*{#1}}
+\makeatletter
+% Índice remissivo
+\AddToHook{env/theindex/begin}{\let\@section at original\section \let\section\chapter}
+\AddToHook{env/theindex/end}{\let\section\@section at original}
+% referências bibliográficas
+\AddToHook{env/thebibliography/begin}{\let\@section at original\section \let\section\chapter}
+\AddToHook{env/thebibliography/end}{\let\section\@section at original}
+% Glossário com pacote glossaries
+\AtBeginDocument{\@ifpackageloaded{glossaries}{
+ \AddToHook{cmd/printglossary/before}{\let\@section at original\section \let\section\chapter}
+ \AddToHook{cmd/printglossary/after}{\let\section\@section at original}
+}} %\@ifpackageloaded %\AtBeginDocument
+\makeatother
+
+\usechapters% ativar o uso de capítulos (ajust 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
+\makeatletter
+ \@ifundefined{c at chapter}{\newcount \c at chapter}{}% contador principal
+ \global\let\cl at chapter\@empty% lista de aplicações de \@elt nos contadores subordinados (ao executar, aplicará \@elt em cada um dos contadores subordinados)
+ \def\@stpelt at on@cl#1{
+ \begingroup% agrupando para que mudanças seja local.
+ \let\@elt at original\@elt% copia do original
+ \let\@elt\@stpelt % \@elt será o \@stpelt
+ \csname cl@#1\endcsname % aplica o \@elt em cada contador
+ \let\@elt\@elt at original% restaura o \@elt original
+ \endgroup
+ }
-% versão * do capítulo não tem no ABNTexto. Providenciando
+ % Caso de part, subsubsection e paragraph, são analogos
+ \AddToHook{cmd/recountchapter/after}{\@stpelt at on@cl{chapter}}
+ \AddToHook{cmd/recountsection/after}{\@stpelt at on@cl{section}}
+ \AddToHook{cmd/recountsubsection/after}{\@stpelt at on@cl{subsection}}
+\makeatother
+
+% versão * do capítulo/seção não tem no ABNTexto.
+% No ABNTexto, será \clearpage\nonum\notoc\chapter{\centering } ou \nonum\notoc\section{\centering }
+% Providenciando versão * pela praticidade em usar no conteúdo pretextual (ABNT: deve ser centralizada)
+
\makeatletter
-\let\chapter at original\chapter% copiando o original
-\def\chapter{\@ifstar\chapter at star\chapter at nostar}
-\def\chapter at nostar#1{\chapter at original{#1}}% sem *
-\def\chapter at star#1{% com *
- \clearpage\vspace*{\abovechapter}
- \noindent{\Huge\bfseries #1}%
- \par\vskip\belowchapter
-}
-
+ \let\chapter at nostar\chapter% copiando o original
+ \def\chapter{\@ifstar\chapter at star\chapter at nostar}
+ \def\chapter at star#1{% com *
+ \cleardoublepage
+ \nonum\notoc\chapter at nostar{\centering #1}
+ }
+% Para artigos
+%\let\section at nostar\section% copiando o original
+%\def\section{\@ifstar\section at star\section at nostar}
+%\def\section at star#1{% com *
+% \nonum\notoc\section at nostar{\centering #1}
+%}
+\makeatother
+% informação do documento (requer o pacote hyperref)
\hypersetup{pdftitle={Exemplo de ABNTexto},
pdfauthor={Sadao Massago},
pdfsubject={Exemplo do documento em ABNT com a classe ABNTexto},
@@ -9485,8 +9824,11 @@
pdfkeywords={ABNT}{Trabalho acadêmico}{LaTeX}{ABNTexto}
}
+\sloppy % preferência a underfull (muito espaço entre palavras)
+
% INICIO DO DOCUMENTO
\begin{document}
+
\begin{titlepage}
UNIVERSIDADE FEDERAL DE SÃO CARLOS \\
CENTRO DE CIÊNCIAS E TECNOLOGIAS PARA SUSTENTABILIDADE
@@ -9494,13 +9836,13 @@
\vfill
\Large SADAO MASSAGO
\vfill
-{\Huge EXEMPLO DE ABNTEXTO}
+{\Huge\bfseries EXEMPLO DE ABNTEXTO}
\vfill
SOROCABA \\
-AGOSTO DE 2023
+NOVEMBRO DE 2024
\end{center}
\end{titlepage}
-\pretextual
+\pretextual % pretextual é iniciado automaticamente?
% Folha de rosto é obrigatório no ABNT
\begin{center}
\vfill
@@ -9509,6 +9851,8 @@
{\Large\bfseries Exemplo de ABNTexto}
\vfill
\begin{flushright}\begin{minipage}{0.5\textwidth}
+\noindent% sem indentação
+\singlesp % espaçamento simpoles, usando o comando de ABNTexto
Texto do tipo ‘‘Monografia apresentada ...’’ que depende da instituição
\end{minipage}\end{flushright}
\vfill
@@ -9518,7 +9862,7 @@
Orientador(a): Nome do(a) orientador(a)
\vfill
Sorocaba\\
-Agosto de 2023
+Novembro de 2024
\end{center}
%% Ficha catalográfica, caso existir, deve ficar no verso da folha de rosto
@@ -9533,7 +9877,7 @@
%% Quando tiver a folha de aprovação devidamente assinada, incluir aqui
%% \includepdf{folhadeaprovacaofinal.pdf}
%
-%%\chapter*{}
+%\chapter*{}
%%Dedicatória é um elemento opcional para ABNT
%
\chapter*{}
@@ -9540,10 +9884,10 @@
Agradecimentos é opcional no ABNT, mas boa educação é agradecer aos que contribuíram para realização do trabalho.
%
%\chapter*{}
-%epigrafe (uma mensagem) que é opcional no ABNT.
+%epigrafe (uma mensagem) que é opcional no ABNT. Deverá colocar o autor da mensagem, alinhada a direita.
%
\chapter*{Resumo}
-Resumo em português, obrigatório no ABNT.
+\noindent Resumo em português, obrigatório no ABNT.
\noindent
\textbf{Palavras-chave}: ABNT, LaTeX, ABNTexto.
@@ -9550,7 +9894,7 @@
%
\chapter*{Abstract} %Resumo em língua estrangeira (obrigatório no ABNT).
\begin{otherlanguage}{english}
-Abstract in foreign language is required in ABNT.
+\noindent Abstract in foreign language is required in ABNT.
\noindent
\textbf{Keywords}: ABNT, LaTeX, ABNTexto.
@@ -9557,13 +9901,14 @@
\end{otherlanguage}
%
%\clearpage\phantomsection\pdfbookmark[chapter]{\listfigurename}{lof}
-%\heading{Lista de Figuras}% opcional no ABNT
+%\chapter*{Lista de Figuras}% opcional no ABNT
%\maketoc{lof}
%
%\clearpage\phantomsection\pdfbookmark[chapter]{\listfigurename}{lot}
-%\heading{Lista de Tabelas} % opcional no ABNT
+%\chapter*{Lista de Tabelas} % opcional no ABNT
%\maketoc{lot}
%
+% \clearpage
%\chapter*{Siglas} % Lista de siglas é opcional no ABNT.
%\begin{description}
%\item[ABNT] Associação Brasileira de Normas Técnicas.
@@ -9570,6 +9915,7 @@
%\end{description}
%\end{siglas}
%
+% \clearpage
%\chapter*{Simbolos}% Lista de Símbolos é opcional no ABNT
%\begin{description}
%\item[$\pi$] Razão entre circunferência e raio.
@@ -9576,17 +9922,19 @@
%\item[ABNT] Associação Brasileira de Normas Técnicas.
%\end{description}
%
-\clearpage\heading{Sumário}% Sumário é obrigatório no ABNT
+\clearpage
+% \section*{Sumário} % artigo
+\chapter*{Sumário}
\maketoc
-%
+
% CONTEÚDO PRINCIPAL
\clearpage
-\textual\let\textual=\relax% iniciando o textual e desativando o comando
-\newgeometry{twoside=false} % forçando a ser oneside
+\textual \let\textual=\relax% iniciando o textual e desativando o comando
%
% Como já é conteúdo textual, capítulos serão enumerados.
\chapter{Prefácio} % prefácio (ou apresentação) é opcional no ABNT
Prefácio aqui. Se preferir, pode incorporar na introdução.
+
\clearpage
\chapter{Introdução}
Introdução aqui.
@@ -9603,14 +9951,53 @@
\end{topics}
\clearpage
\chapter{Legenda}
-Legenda da figura e tabelas.
+O comando \verb+\legend+ especifica se vai ser figura ou tabela e cria a legenda (título).
+Deve respeitar a ordem dos comandos \verb+\legend+, \verb+\src+ e \verb+\place+. O ambiente de figuras flutuantes \texttt{figure} funciona, mas não está suportado oficialmente na classe \texttt{abntexto} (2024). Se usar, não esquecer de verificar se está de acordo com o ABNT.
\begin{figure}[hbp!]
-\legend{figure}{Um título}
-\src{\texttt{www.site.com.br}. Acesso em 01 jan. 2020.}
+\legend{figure}{Uma figura}
+\src{Elaboração do autor}
\label{fig:teste}
-\place{\includegraphics[width=0.4\linewidth]{example-image}}
+\place{\includegraphics[width=0.4\linewidth]{imagem-exemplo}}
\end{figure}
Ver \ref{fig:teste}.
+
+Poderá usar subfiguras nativamente como na Figura~\ref{fig:teste2} (Figura~\ref{fig:teste2:a} e \ref{fig:teste2:b}).
+\begin{figure}[hbp!]
+\legend{figure}{Duas figuras}\label{fig:teste2}
+\begin{multiplace}
+ \sublegend{figure}{Normal}
+ \src{Elaboração do autor}
+ \label{fig:teste2:a}
+ \subplace{\includegraphics[width=0.4\linewidth]{imagem-exemplo}}
+ % figura 2
+ \sublegend{figure}{Rotacionada}
+ \src{Elaboração do autor}
+ \label{fig:teste2:b}
+ \subplace{\includegraphics[width=0.4\linewidth]{imagem-exemplo-2}}
+\end{multiplace}
+\end{figure}
+
+Não há suporte para tabelas flutuantes (2024). Logo, tabelas devem ser inseridas diretamente, mesmo que seja pequena.
+
+\begin{center}
+\legend{table}{Um título}\label{tab:primeira}
+\src{Elaboração do autor.}
+\place{%
+\begin{tabular}{ll}
+\toprule %\hline
+ produto & preço \\
+\midrule %\hline
+ cenouras (500g) & R\$0,50 \\
+ cogumelos (vidro de 500g) & R\$5,00 \\
+ batata (1Kg) & R\$1,20 \\ \midrule % \hline
+ total & R\$6,70 \\
+ \bottomrule %\hline
+\end{tabular}
+}
+\end{center}
+
+Não há suporte para tabelas longas. Se precisar, use o pacote \texttt{xtab} e configure devidamente.
+
\clearpage
\chapter{Citações}
Para citações curtas, use \verb+\enquote{texto}\cite{key}+.
@@ -9628,25 +10015,33 @@
%% Referencias bibliográficas é obrigatório no ABNT
\phantomsection\addcontentsline{toc}{chapter}{\refname}%adicionando no sumário
\printbibliography%sem opção, para devido funcionamento em ABNTexto
-%Apêndices são opcionais no ABNT
-\clearpage
-\appendix{Primeiro Apêndice}
-Conteúdo do primeiro apêndice.
-\clearpage
-\appendix{Segundo Apêndice}
-Conteúdo do segundo apêndice.
-% Anexos são opcionais no ABNT
-\clearpage
-\annex{Primeiro Anexo}
-Conteúdo do primeiro anexo
-\annex{Segundo Anexo}
-Conteúdo do segundo anexo
-% Índice remissivo (opcional no ABNT)
-% \clearpage
+%% glossário é opcional no ABNT
+%\clearpage\phantomsection\addtoext{toc}{chapter}{\glossaryname}%adicionando no sumário pelo comando de ABNTexto
+%\printglossaries
+%%Apêndices são opcionais no ABNT
+%\clearpage
+%\appendix{Primeiro Apêndice}
+%Conteúdo do primeiro apêndice.
+%\clearpage
+%\appendix{Segundo Apêndice}
+%Conteúdo do segundo apêndice.
+%% Anexos são opcionais no ABNT
+%\clearpage
+%\annex{Primeiro Anexo}
+%Conteúdo do primeiro anexo
+%\annex{Segundo Anexo}
+%Conteúdo do segundo anexo
+%% Índice remissivo (opcional no ABNT)
+% \clearpage\phantomsection\addtoext{toc}{chapter}{\indexname}%adicionando no sumário pelo comando de ABNTexto
% \printindex
\end{document}
\end{lstlisting}
\end{singlespacing}
+
+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.
+
+
%%%%%%%%%%%%%% APÊNDICE %%%%%%%%%%
\clearpage\thispagestyle{empty}\cleardoublepage
@@ -9654,8 +10049,8 @@
\chapter{Símbolos Básicos de \LaTeX\protect\index{simbolos basicos@{símbolos básicos}}}
Aqui, veremos os símbolos básicos de \LaTeX{} que não requer o uso de pacotes adicionais.
-Em geral, os editores atuais costumam apresentar painel de inserção de símbolos, o que torna desnecessário ter lista de símbolos em mão.
-Atualmente, muitos sistemas disponíveis na internet tais como alguns \texttt{blog}'s, \texttt{wiki}'s e sistema de ensino/aprendizagem \texttt{moodle} costumam ativar a fórmula \LaTeX{} através de \texttt{mimetex}, \texttt{mathjax} ou similar.
+Em geral, os editores atuais para \LaTeX{} costumam apresentar painel de inserção de símbolos, o que torna desnecessário ter lista de símbolos em mão.
+Atualmente, muitos sistemas disponíveis na internet tais como alguns \texttt{blog}'s, \texttt{wiki}'s e sistema de ensino/aprendizagem \texttt{moodle} costumam ativar a fórmula \LaTeX{} através de \texttt{mimetex}, \texttt{mathjax}, \texttt{KaTeX}, ou similar.
Alguns destes permitem somente os comandos e símbolos básicos sem os pacotes para deixar mais leve, enquanto que outros ativam os pacotes do \texttt{AMS} por padrão para incrementar a sua funcionalidade.
Aqui será apresentado somente os símbolos básicos que poderão ser usados em qualquer sistema na qual o suporte da fórmula \LaTeX{} esteja ativa. Para usar o sistema na qual os pacotes do \texttt{AMS} está ativa, é aconselhável procurar os símbolos e construções adicionais no outro material.
@@ -9932,7 +10327,7 @@
O comando \verb+\mathop+\index{modo matematico@{modo matemático}!construcao basica@{construção básica}!mathop@{\verb+\mathop+}}
permite colocar elementos embaixo/encima em vez de índice/expoente no modo \texttt{display}.
-Para usar temporariamente o modo \texttt{display} dentro do modo \texttt{inline}, basta usar o comando \verb+\display+\index{display@{\verb+\display+}}.
+Para usar temporariamente o modo \texttt{display} dentro do modo \texttt{inline}, basta usar o comando \verb+\displaystyle+\index{displaystyle@{\verb+\displaystyle+}}.
Existem caracteres que podem ser usados diretamente na qual o \LaTeX{} substitui diretamente com o símbolo adequado. Estes símbolos, juntamente com os símbolos que funcionam também no modo texto (apresentado também no Exemplo~\ref{ex-a:simbolos-texto}) estão no Exemplo~\ref{ex-a:math-basic}%
\index{modo texto!simbolo@{símbolo}!\textbackslash chaveaberta@\curlyopensymbforindex}\index{modo matematico@{modo matemático}!basico@{básico}!\textbackslash chaveaberta@{$\curlyopensymbforindex$}}%
@@ -10766,7 +11161,8 @@
\verb+\DeclareOption{<opção>}{<comando>}+\index{DeclareOption@\verb+\DeclareOption+}.
Lembre-se que não é permitido carregar o pacote dentro da declaração de opções, mas poderemos testar se o pacote existe.
Para evitar tais desconfortos e deixar o código mais fácil de ser analisados, costuma colocar a declarações de opções no começo e nele, colocar ativação do ``if'' previamente criado. O corpo da opção ficará mais adiante.
-Para criar ``if'' novo, usa-se o pacote \texttt{ifthen}\index{ifthen} e utiliza o \verb+\newif+\index{\textbackslash newif} seguido de \verb+\if<nome>+ onde \verb+<nome>+ é um nome desejado. O ``flag'' associado pode ser ativado ou desativado com o comando \verb+\<nome>true+ e \verb+\<nome>false+ respectivamente.
+Para criar ``if'' novo, % usa-se o pacote \texttt{ifthen}\index{ifthen} e
+utiliza o \verb+\newif+\index{newif@\verb+\newif+} seguido de \verb+\if<nome>+ onde \verb+<nome>+ é um nome desejado. O ``flag'' associado pode ser ativado ou desativado com o comando \verb+\<nome>true+ e \verb+\<nome>false+ respectivamente.
O código
\begin{verbatim}
\if<nome>
@@ -10782,7 +11178,7 @@
comando 1
\fi
\end{verbatim}
-Note que existe um pacote \texttt{ifthen} (da base) para manipular condições de forma mais confortável do que criar ``if''.
+Note que existe um pacote \texttt{ifthen}\index{ifthen} (da base) para manipular condições de forma mais confortável do que criar ``if''.
Também podemos passar opções para classe que será carregado posteriormente, pelo comando \verb+\PassOptionsToClass+\index{PassOptionsToClass@\verb+\PassOptionsToClass+} ou para o pacote a ser carregado posteriormente, com o comando \verb+\PassOptionsToPackage+\index{PassOptionsToPackage@\verb+\PassOptionsToPackage+}.
@@ -12502,10 +12898,12 @@
Se instalou o \LyX, já deve ter instalado.
Este convertor é para usuário mais avançado, útil para conversão em lotes.
Ele converte praticamente de qualquer formato.
-O comando é \texttt{convert}, mas usuário de MS Windows deve tomar cuidado
-pois a ferramenta do MS Windows para converter sistema de arquivo \texttt{FAT} para \texttt{NTFS} também se chama \texttt{convert}.
-Assim, deverá assegurar de que está chamando \texttt{convert} do image magick, como especificar o caminho.
+O comando é \texttt{convert}, mas usuário de \texttt{MS Windows} deve tomar cuidado
+pois a ferramenta do \texttt{MS Windows} para converter sistema de arquivo \texttt{FAT} para \texttt{NTFS} também se chama \texttt{convert}.
+Assim, deverá assegurar de que está chamando \texttt{convert} do \texttt{Image Magick}, como especificar o caminho.
+No \texttt{Linux}, a opção de conversão para \texttt{EPS,PDF} pode vir desativados por padrão, o que requer ativação manual.
+
Exemplo:
\texttt{convert img.jpg img.pdf}
@@ -12522,13 +12920,13 @@
site: \url{https://github.com/pts/sam2p/releases}
-Converte imagem bitmap para eps ou pdf.
-Atualmente o inkscape pode ser usado para converter para EPS/PDF,
+Converte imagem bitmap para \texttt{eps} ou \texttt{pdf}.
+Atualmente o \texttt{InkScape} pode ser usado para converter para \texttt{EPS/PDF},
mas pode ser útil para usuários avançados.
-sam2p figura.jpg figura.pdf
+\texttt{sam2p figura.jpg figura.pdf}
-converterá para pdf.
+converterá para \texttt{pdf}.
%Usando a opção correta no comando, poderá gerar arquivos pequenos.
%Note que ele é único convertor conhecido até o momento que permite
@@ -12556,28 +12954,34 @@
%Convertor clássico de jpeg para eps de nível 2 ou 3 (com compressão).
%Eu aconselho usar o Imagemagick ou sam2p.
-\subsection*{TeX4ht\index{convertor!TeX4ht} e lwarp\index{convertor!lwarp}}
-\texttt{TeX4ht} é um convertor de \TeX/\LaTeX para HTML/XHTML, similar a Hevea, TTH, e LaTeX2HTML, que roda em diversas plataformas.
-Note que todos 4 programas são de multiplataformas e cada um tem vantagens e desvantagens.
-Hevea e TTH, não apresenta suporte decente as fórmulas matmáticas.
-O Tex4ht implementado como pacote para TeX e o LaTeX2HTML que é escrito em perl, conseguem converter eficientemente os documentos com equações.
-Ambas podem optar em usar a imagem (GIF, PNG ou JPEG) ou MathML para representar equações.
-Além disso, TeX4ht e LaTeX2HTML são de código aberto.
+\subsection*{TeX4ht\index{convertor!TeX4ht}, LaTeXML\index{convertor!LaTeXML} e lwarp\index{convertor!lwarp}}
+
+site: \url{https://ctan.org/pkg/tex4ht}, \url{https://math.nist.gov/~BMiller/LaTeXML/}, \url{https://ctan.org/pkg/lwarp}.
+
+
+\texttt{TeX4ht} é um convertor de \TeX/\LaTeX para \texttt{HTML/XHTML}, similar a \texttt{Hevea}, \texttt{TTH}, e \texttt{LaTeX2HTML}, que roda em diversas plataformas.
+Note que todos $4$ programas clássicos são de multiplataformas e cada um tem vantagens e desvantagens.
+\texttt{Hevea} e \texttt{TTH}, não apresenta suporte decente às fórmulas matemáticas.
+O \texttt{Tex4ht} é implementado como pacote para \TeX{} e o \texttt{LaTeX2HTML} é convetor escrito em \texttt{perl}. Ambos conseguem converter eficientemente os documentos com equações, permitindo usar a imagem (\texttt{GIF}, \texttt{PNG} ou \texttt{JPEG}) ou \texttt{MathML} para representar equações.
+Além disso, \texttt{TeX4ht} e \texttt{LaTeX2HTML} são de código aberto.
Por estas e outras razões, eles são os mais usados.
-O HTML gerado por Tex4ht é mais parecido com o documento original e não consegue dividir documentos em pedaços (o que é interessante para HTML grande, para acelerar o acesso na internet).
-O LaTeX2HTML produz documentos de acordo com a filosofia do HTML e consequentemente, não produz documento ``fiel'' ao original.
+O \texttt{HTML} gerado por \texttt{Tex4ht} é mais parecido com o documento original e não consegue dividir documentos em pedaços (o que é interessante para \texttt{HTML} grande, para acelerar o acesso na internet).
+O \texttt{LaTeX2HTML} produz documentos de acordo com a filosofia do \texttt{HTML} e consequentemente, não produz documento ``fiel'' ao original.
Ele particiona documentos grandes em pedaços menores e cria recurso de navegação, mas isto pode ser desativado, se desejar.
-O HTML gerado por LaTeX2HTML acomoda bem em maioria dos navegadores, o que torna a escolha preferida dos profissionais.
-No entanto, Tex4ht já vem com muitas distribuições \LaTeX, incluindo o MikTeX para MS Windows.
+O \texttt{HTML} gerado por \texttt{LaTeX2HTML} acomoda bem em maioria dos navegadores, o que tornou a escolha preferida dos desenvolvedores da \texttt{Web}, enquanto que \texttt{TeX4ht} tornou a preferência para converter documentos \LaTeX{} em outros formatos.
+Note que o \texttt{Tex4ht} já vem com muitas distribuições \LaTeX, incluindo o \texttt{MikTeX} para \texttt{MS Windows}.
+Além disso, ele permite converter para formato do \texttt{Libre Office}, sendo que \texttt{TeXMaker} e \LyX{} usam ele para gerar arquivo de \texttt{Libre Office}.
+%No caso de Windows, o comando htlatex.bat converte usando imagem na equação e htmlatex.bat usa MathML para fórmula. O oolatex.bat converte para formato de Libre Office.
-Além disso, ele permite converter para formato do Libre Office e, TeXMaker e LyX usam ele para gerar arquivo de Libre Office.
+Um problema do \texttt{TeX4ht} é usar o formato intermediário em \texttt{DVI}, o que dificulta o uso de imagens em \texttt{pdf/jpg/png} por precisar ser convertidos em \texttt{eps}.
+A solução para isso é usar conversores modernos tais como \texttt{LaTeXML} e \texttt{lwarp} que apresentam filosofia similar ao \texttt{TeX4ht}, de produzir documentos parecidos com a saída do \LaTeX.
+O \texttt{LaTeXML} é implementado em \texttt{perl} e usa o \texttt{PDF} e \texttt{XML} como o arquivo intermediário, eliminando o problema do \texttt{TeX4ht}. Ele gera tanto o \texttt{HTML} quanto o \texttt{epub} com boa qualidade, permitindo usar \texttt{MathML} para equações. A conversão é feito pelo comando \texttt{latexmlc}.
-O \texttt{lwarp} é conjunto de pacotes de \LaTeX{} similar a \texttt{TeX4Ht} que converte \LaTeX{} para HTML5, mas usa PDF como formato intermediário, em vez do antigo DVI usado pelo \texttt{TeX4Ht}. Isto permite usar imagens PDF diretamente no documento. As equações e figuras ficarão no formato \texttt{SVG} por padrão, mas pode usar \texttt{MathJaX} para equações. Ele não suporta \texttt{MathML} para equações ainda. O script auxiliar \texttt{lwarpmk} é usado na conversão automática das equações e imagens para SVG.
+O \texttt{lwarp} é conjunto de pacotes de \LaTeX{} que converte \LaTeX{} para \texttt{HTML5}.
+As equações e figuras ficarão no formato \texttt{SVG} por padrão, mas pode usar \texttt{MathJaX} para equações. Ele não suporta \texttt{MathML} para equações ainda (2024). O \texttt{script} auxiliar \texttt{lwarpmk} é usado na conversão automática das equações e imagens para \texttt{SVG}.
-%No caso de Windows, o comando htlatex.bat converte usando imagem na equação e htmlatex.bat usa MathML para fórmula. O oolatex.bat converte para formato de Libre Office.
+%\textbf{Observação:} Acentuação dentro do ambiente tabular (\a{'}, \a{~}, etc) não será reconhecido no \texttt{TeX4ht}. Neste caso, use a acentuação direta.
-\textbf{Observação:} Acentuação dentro do ambiente tabular (\a{'}, \a{~}, etc) não será reconhecido. Neste caso, use a acentuação direta.
-
%\begin{enumerate}[{Observação}~1]
%\item É possível usar a imagem no formato JPEG ou PNG em vez de GIF. Por exemplo, o comando
%
@@ -12668,16 +13072,16 @@
site: \url{http://writer2latex.sourceforge.net/}
-Editor de texto do Open Office/Libre Office para LaTeX/XHTML+MathML.
+Convertor do editor de texto do \texttt{Open Office/Libre Office} para \texttt{LaTeX/XHTML+MathML}.
Ele pode ser usado como plugin ou pelo comando de linha.
-Dependendo da instalação do Libre Office, já estará instalado.
+Dependendo da instalação do \texttt{Libre Office}, já estará instalado.
\subsection*{Excel2LaTeX\index{convertor!Excel2LaTeX}}
site: \url{https://www.ctan.org/pkg/excel2latex}
-Excel2LaTeX é um macro para MS Excel, para converter planilha do Excel para tabela do LaTeX. Maioria das formatações tais como espacificação das fontes (negrito, itálico, etc), bordas, celula mescrada, etc são mantidas. Para instalar, copie o arquivo excel2latex.xla para pasta do MS Office e dê um double click sobre ele. O MS Excel abre o arquivo e perguntará se vai executar o "macro". Responda "sim" e a instalação está completa.
-No MS Excel, selecione a região desejada da tabela e crique em ``convert table to LaTeX'' (ou ferramentas->convert table to LaTeX).
+\texttt{Excel2LaTeX} é um macro para \texttt{MS Excel}, para converter planilha do \texttt{MS Excel} para tabela do \LaTeX. Maioria das formatações tais como espacificação das fontes (negrito, itálico, etc), bordas, celula mescrada, etc são mantidas. Para instalar, copie o arquivo \texttt{excel2latex.xla} para pasta do \texttt{MS Office} e dê um double click sobre ele. O \texttt{MS Excel} abre o arquivo e perguntará se vai executar o "macro". Responda "sim" e a instalação estará completa.
+No \texttt{MS Excel}, selecione a região desejada da tabela e clique em ``convert table to LaTeX'' (ou ``ferramentas->convert table to LaTeX'').
O resultado pode ser copiado para ``clipboard'' ou salvo no arquivo.
%Para versão em japonês, veja o http://plaza19.mbn.or.jp/~Butcher_Bird/Mac/Excel.html.
@@ -12685,7 +13089,7 @@
site: \url{http://calc2latex.sourceforge.net/}
-Macro para Open Calc (do Open Office) para gerar tabelas de LaTeX a partir da planilha.
+Macro para \texttt{Open Calc} (do \texttt{Open Office}) para gerar tabelas de \LaTeX{} a partir da planilha.
Não há atualização recente.
\section{Outras ferramentas\index{ferramentas}}
@@ -12697,7 +13101,7 @@
Se usar o \BibTeX, é recomendável que use este editor para editar arquivo ".bib".
Muitos usuários de \LaTeX{} deixam de usar o \BibTeX{} devido a chatice de editar o arquivo do \BibTeX{} que usa a sintaxe diferente do \LaTeX, mas com o \texttt{jabref}, as coisas mudam.
-Ele também suporta o Bib\LaTeX (para isso, deverá usar o modo Bib\LaTeX).
+Ele também suporta o Bib\LaTeX{} (para isso, deverá usar o modo Bib\LaTeX).
Também é aconselhável usar a codificação \texttt{utf-8} quando usa o modo Bib\LaTeX{} para evitar problemas com caracteres acentuados.
Deleted: trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/makeaux.sh
===================================================================
--- trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/makeaux.sh 2024-12-09 21:14:45 UTC (rev 73085)
+++ trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/makeaux.sh 2024-12-09 21:14:59 UTC (rev 73086)
@@ -1,39 +0,0 @@
-#!/bin/bash
-
-# To create auxiliar file for latex-via-exemplos (only for development)
-
-# compile auxiliar files
-pdflatex latex-via-exemplos-fig
-pdflatex latex-via-exemplos-poster
-pdflatex latex-via-exemplos-slides
-pdflatex latex-via-exemplos-slides
-pdflatex latex-via-exemplos-certificado
-pdflatex latex-via-exemplos-cracha
-pdflatex latex-via-exemplos-folder
-pdflatex latex-via-exemplos-todonotes
-pdflatex latex-via-exemplos-todonotes
-
-# clean up
-rm *.aux
-rm *.bbl
-rm *.blg
-rm *.idx
-rm *.ilg
-rm *.ind
-rm *.log
-rm *.lol
-rm *.out
-rm *.synctex.gz
-rm *.tmp
-rm *.toc
-
-rm *.nav
-rm *.snm
-rm *.vrb
-
-rm *.tdo
-
-# rm *.csv
-
-#end
-
Modified: trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/makedoc.sh
===================================================================
--- trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/makedoc.sh 2024-12-09 21:14:45 UTC (rev 73085)
+++ trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/makedoc.sh 2024-12-09 21:14:59 UTC (rev 73086)
@@ -2,6 +2,131 @@
# To compile latex-via-exemplos
+############
+# functions
+############
+
+# print usage
+function usage()
+{
+ # if [[ "$#" - gt 1 ]]; then
+ # echo "clear(): Invalid number of argument"
+ # exit;
+ # fi
+ echo "Usage:"
+ echo "bash $0 <option> <option 2>"
+ echo "without option: compile one sided document"
+ echo "<option> == oneside: compile two sided document"
+ echo "<option> == twoside: compile two sided document"
+ echo "<option> == all: compile one sided and two sided documents"
+ echo "<option> == auxonly: compile auxiliary files only"
+ echo "<option 2> == keepaux: keep generated auxiliar pdf files"
+ echo "<option> == usage: display usage only"
+}
+
+## clear auxiliar files
+## If argument is "true", keep auxiliar pdf files
+function clear()
+{
+ if [[ "$#" -gt 1 ]]; then
+ echo "clear(): Invalid number of argument"
+ exit;
+ fi
+
+ local keepaux=$1 # first argument
+ if [[ "${keepaux}" != "" && "${keepaux,,}" != "true" && "${keepaux,,}" != "false" ]]; then
+ echo "clear(): invalid parameter"
+ exit;
+ fi
+
+ # basic auxiliar files
+ rm *.aux
+ rm *.bbl
+ rm *.blg
+ rm *.idx
+ rm *.ilg
+ rm *.ind
+ rm *.log
+ rm *.lol
+ rm *.out
+ rm *.synctex.gz
+ rm *.tmp
+ rm *.toc
+
+ # more auxiliar files
+ rm *.nav
+ rm *.snm
+ rm *.vrb
+
+ # of todo notes
+ rm *.tdo
+
+ # rm *.csv
+
+ # remove automatic created auxiliar tex and txt files
+ rm latex-via-exemplos-tabela.txt
+ rm latex-via-exemplos-ans.tex
+ rm latex-via-exemplos-twoside-ans.tex
+
+ # rm latex-via-exemplos-*-exercise-body.tex
+
+ # remove auxiliar pdf files
+ if [[ "${keepaux,,}" != "true" ]]; then
+ rm latex-via-exemplos-fig.pdf
+ rm latex-via-exemplos-poster.pdf
+ rm latex-via-exemplos-slides.pdf
+ rm latex-via-exemplos-certificado.pdf
+ rm latex-via-exemplos-cracha.pdf
+ rm latex-via-exemplos-folder.pdf
+ rm latex-via-exemplos-todonotes.pdf
+ fi
+} # clear()
+
+#############
+# main script
+#############
+
+# check parameters
+# one parameters (all, twoside, or aux), or none of parameters
+if [ "$#" -gt 2 ]; then
+ echo "Illegal number of parameters"
+ usage
+ exit;
+fi
+
+if [ "$#" -gt 0 ]; then
+ optarg="$1"
+ optarg="${optarg,,}" # to lower case
+
+ # check auxiliar parameter
+ if [[ "${optarg}" == "keepaux" ]]; then
+ optarg="$2"
+ optarg="${optarg,,}" # to lower case
+ keepaux="true"
+ else if [ "$#" -eq 2 ]; then
+ keepaux="$2"
+ if [ "${keepaux,,}" != "keepaux" ]; then
+ echo "Invalid seccond argument '${keepaux}'"
+ usage
+ exit
+ fi
+ keepaux="true"
+ fi fi
+
+ # show usage
+ if [[ "${optarg}" == "usage" || "${optarg}" == "help" ]]; then
+ usage
+ exit
+ fi
+
+ # checking main parameter
+ if [[ "${optarg}" != "" && "${optarg}" != "oneside" && "${optarg}" != "twoside" && "${optarg}" != "all" && "${optarg}" != "auxonly" ]]; then
+ echo "Invalid option '${optarg}'"
+ usage
+ exit
+ fi
+fi
+
# compile auxiliar files
pdflatex latex-via-exemplos-fig
pdflatex latex-via-exemplos-poster
@@ -14,57 +139,33 @@
pdflatex latex-via-exemplos-todonotes
pdflatex latex-via-exemplos-todonotes
-# compile documento (one sided)
-xelatex latex-via-exemplos
-bibtex latex-via-exemplos
-makeindex latex-via-exemplos
-xelatex latex-via-exemplos
-xelatex latex-via-exemplos
+# if auxiliar files only, clear and stop
+if [[ "${optarg}" == "auxonly" ]]; then
+ # keep auxiliar pdf files
+ clear "true"
+ exit
+fi
+
+# compile one sided document
+if [[ "${optarg}" == "all" || "${optarg}" == "oneside" || "${optarg}" == "" ]]; then
+ lualatex latex-via-exemplos
+ bibtex latex-via-exemplos
+ makeindex latex-via-exemplos
+ lualatex latex-via-exemplos
+ lualatex latex-via-exemplos
+fi
-# compile document (two sided)
-xelatex latex-via-exemplos-twosides
-bibtex latex-via-exemplos-twosides
-makeindex latex-via-exemplos-twosides
-xelatex latex-via-exemplos-twosides
-xelatex latex-via-exemplos-twosides
+# compile two sided document
+if [[ "${optarg}" == "all" || "${optarg}" == "twosides" ]]; then
+ lualatex latex-via-exemplos-twoside
+ bibtex latex-via-exemplos-twoside
+ makeindex latex-via-exemplos-twoside
+ lualatex latex-via-exemplos-twoside
+ lualatex latex-via-exemplos-twoside
+fi
# clean up
-rm *.aux
-rm *.bbl
-rm *.blg
-rm *.idx
-rm *.ilg
-rm *.ind
-rm *.log
-rm *.lol
-rm *.out
-rm *.synctex.gz
-rm *.tmp
-rm *.toc
+clear $keepaux
-rm *.nav
-rm *.snm
-rm *.vrb
-
-rm *.tdo
-
-# rm *.csv
-
-# remove automatic created auxiliar tex and txt files
-rm latex-via-exemplos-tabela.txt
-rm latex-via-exemplos-ans.tex
-rm latex-via-exemplos-twosides-ans.tex
-
-# rm latex-via-exemplos-*-exercise-body.tex
-
-# remove auxiliar pdf files
-rm latex-via-exemplos-fig.pdf
-rm latex-via-exemplos-poster.pdf
-rm latex-via-exemplos-slides.pdf
-rm latex-via-exemplos-certificado.pdf
-rm latex-via-exemplos-cracha.pdf
-rm latex-via-exemplos-folder.pdf
-rm latex-via-exemplos-todonotes.pdf
-
#end
More information about the tex-live-commits
mailing list.