texlive[76012] Master/texmf-dist/doc/latex/latex-via-exemplos:
commits+karl at tug.org
commits+karl at tug.org
Sat Aug 9 21:37:10 CEST 2025
Revision: 76012
https://tug.org/svn/texlive?view=revision&revision=76012
Author: karl
Date: 2025-08-09 21:37:10 +0200 (Sat, 09 Aug 2025)
Log Message:
-----------
latex-via-exemplos (9aug25)
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-abntexto.tex
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 2025-08-09 19:36:37 UTC (rev 76011)
+++ trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/changelog.txt 2025-08-09 19:37:10 UTC (rev 76012)
@@ -1,3 +1,6 @@
+Version 2025-08-08
+ - abntexto related sample code are updated to version 2025-08-05 of abntexto.
+ - Some words for typeset system other than LaTeX.
Version 2025-04-09
- Correction related to use of combine class
Version 2025-01-06
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 2025-08-09 19:36:37 UTC (rev 76011)
+++ trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos-abntexto.tex 2025-08-09 19:37:10 UTC (rev 76012)
@@ -1,9 +1,8 @@
-% Padrão para abntexto
+% Padrão para abntexto 2025-07-17 ou posterior
% Classe base: article
% pacote adicional: geometry, graphicx
% font size: 12pt
% twoside=true
-% 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}
@@ -67,48 +66,31 @@
\usepackage[backend=biber, language=auto, style=abnt]{biblatex}
\addbibresource{modelo-biblatex.bib} % arquivo bib
-
%\addto{\captionsbrazil}{
% \renewcommand{\refname}{Referências}
%}
-% Mesmo com \usechapters do ABNTexto, 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
+% Mesmo com \usechapters do ABNTexto, 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 usando comando de abntexto.
\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}
+\AddToHook{env/theindex/begin}{\begin{corrprint}}
+\AddToHook{env/theindex/end}{\end{corrprint}}
% 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}
+\AddToHook{env/thebibliography/begin}{\begin{corrprint}}
+\AddToHook{env/thebibliography/end}{\end{corrprint}}
% 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}
+ \AddToHook{cmd/printglossary/before}{\begin{corrprint}}
+ \AddToHook{cmd/printglossary/after}{\end{corrprint}}
}} %\@ifpackageloaded %\AtBeginDocument
+% Glossário com pacote acro
+\AtBeginDocument{\@ifpackageloaded{acro}{
+ \AddToHook{cmd/printacronyms/before}{\begin{corrprint}}
+ \AddToHook{cmd/printacronyms/after}{\end{corrprint}}
+}} %\@ifpackageloaded %\AtBeginDocument
\makeatother
-
-% 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
- }
-
- % 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)
@@ -153,7 +135,7 @@
{\Huge\bfseries EXEMPLO DE ABNTEXTO}
\vfill
SOROCABA \\
-NOVEMBRO DE 2024
+AGOSTO DE 2025
\end{center}
\end{titlepage}
\pretextual % pretextual é iniciado automaticamente?
@@ -176,7 +158,7 @@
Orientador(a): Nome do(a) orientador(a)
\vfill
Sorocaba\\
-Novembro de 2024
+Agosto de 2025
\end{center}
%% Ficha catalográfica, caso existir, deve ficar no verso da folha de rosto
@@ -267,37 +249,39 @@
\clearpage
\chapter{Legenda}
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!]
+Deve respeitar a ordem dos comandos \verb+\legend+, \verb+\src+ e \verb+\begin{place}+. A opção de posicionamento é mesmo de figuras/tabelas flutuantes \texttt{figure}/\texttt{table},adicionado de uma opção 'here' que fixa no lugar como a opção 'H' do pacote \texttt{float}.
\legend{figure}{Uma figura}
\src{CTAN: \url{https://ctan.org/}}
\label{fig:teste}
-\place{\includegraphics[width=0.4\linewidth]{example-image}}
-\end{figure}
+\begin{place}[hbp!] % opção de posicionamento é mesmo de figure/table
+\includegraphics[width=0.4\linewidth]{example-image}
+\end{place}
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}
+% \src{CTAN: \url{https://ctan.org/}}
+\begin{multiplace}% [here] % 'here' (padrão) fixa no lugar como 'H' do pacotee float
\sublegend{figure}{Normal}
- \src{CTAN: \url{https://ctan.org/}}
+ \subsrc{CTAN: \url{https://ctan.org/}}
\label{fig:teste2:a}
- \subplace{\includegraphics[width=0.4\linewidth]{example-image-a}}
+ \begin{subplace}
+ \includegraphics[width=0.4\linewidth]{example-image-a}
+ \end{subplace}
% figura 2
\sublegend{figure}{Rotacionada}
- \src{CTAN: \url{https://ctan.org/}}
+ \subsrc{CTAN: \url{https://ctan.org/}}
\label{fig:teste2:b}
- \subplace{\includegraphics[width=0.4\linewidth,angle=45]{example-image-a}}
+ \begin{subplace}
+ \includegraphics[width=0.4\linewidth,angle=45]{example-image-a}
+ \end{subplace}
\end{multiplace}
-\end{figure}
-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!]
+A tabela pequena pode ser inseridas de forma análoga a da figura, mas deve usar o comando \verb+\legend+ devidamente com opção 'table'.
\begin{center}
\legend{table}{Um título}\label{tab:primeira}
\src{Elaboração do autor.}
-\place{%
+\begin{place}[here]% 'here' (padrão) fixa no lugar como 'H' do pacote float
\begin{tabular}{ll}
\toprule %\hline
produto & preço \\
@@ -308,11 +292,10 @@
total & R\$6,70 \\
\bottomrule %\hline
\end{tabular}
-}
+\end{place}
\end{center}
-\end{table}
-Não há suporte para tabelas longas (2024). Também não há suporte para quadros ainda (2024).
+Não há suporte para tabelas longas (2025). Também não há suporte para quadros ainda (2025).
Quem precisar de tabelas e quadros longos (e curtos), use o pacote como o \texttt{tabularray-abnt} do \url{https://ctan.org/pkg/tabularray-abnt}.
@@ -330,14 +313,13 @@
\chapter{Considerações Finais}
Conclusão do trabalho.
% PÓS TEXTUAL
-\clearpage
%% Referencias bibliográficas é obrigatório no ABNT
-% \phantomsection\addcontentsline{toc}{chapter}{\refname}%adicionando no sumário
-\phantomsection\addtoext{toc}{chapter}{\refname} %adicionando no sumário pelo comando de ABNTexto
+\clearpage\phantomsection\addcontentsline{toc}{chapter}{\protect\toclabelbox{}\refname}%
\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
+%\clearpage\phantomsection\addcontentsline{toc}{chapter}{\protect\toclabelbox{}\glossaryname}%
% inserir glossário pelo comando de acordo com o pacote usado: pacotes mais usados são acro e glossaries
+
%%Apêndices são opcionais no ABNT
%\clearpage
%\appendix{Primeiro Apêndice}
@@ -352,6 +334,6 @@
%\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
+% \clearpage\phantomsection\addcontentsline{toc}{chapter}{\protect\toclabelbox{}\indexname}%
% \printindex
\end{document}
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 2025-08-09 19:36:37 UTC (rev 76011)
+++ trunk/Master/texmf-dist/doc/latex/latex-via-exemplos/latex-via-exemplos.tex 2025-08-09 19:37:10 UTC (rev 76012)
@@ -1050,9 +1050,9 @@
% Decima segunda atualização: 19 de dezembro de 2024
% Decima terceira atualização: 29 de dezembro de 2024
% Decima quarta atualização: 31 de dezembro de 2024
-% Decima quinta atualização: 06 de janeiro de 2025
-% Décima sexta atualização:
-\date{09 de abril de 2025}
+% Decima quinta atualização: \date{06 de janeiro de 2025}
+% Decima sexta atualização:
+\date{08 de agosto de 2025}
%%%%%%%%%%%%%%%%%%%%%%%
% Documet start here
@@ -1164,7 +1164,8 @@
% Sorocaba, maio de 2022.
% Sorocaba, outubro de 2023.
% Sorocaba, dezembro de 2024.
-Sorocaba, abril de 2025.
+% Sorocaba, janeiro de 2025.
+Sorocaba, agosto de 2025.
\
@@ -10050,8 +10051,8 @@
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 com \TeX{} não está atualizada.
-Para usar a versão nova, deverá abaixar e instalar manualmente seguindo a instrução.
+O novo estilo bibliográfico de Bib\LaTeX{} para ABNT (conformidade com a nova regra ABNT, NBR 10520:2023) está em desenvolvimento no site \url{https://github.com/abntex/biblatex-abnt}, mas a versão beta foi postado no \href{https://ctan.org/}{CTAN} somente em outubro de 2024. Por este motivo, o estilo da referência bibliográfica distribuída junto com \TeX{} pode não estar de acordo com a norma atualizada.
+Se for o caso e deseja utilizar a versão nova, deverá abaixar e instalar manualmente seguindo a instrução do site.
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}
@@ -13432,6 +13433,17 @@
O \texttt{Windows} costuma não vir com visualizador de \texttt{PDF} instalados. Apesar de editores para \LaTeX{} costuma vir com visualizador de \texttt{PDF} integrados, é bom ter um visualizador dedicado. Uma das opções é instalar o \texttt{Sumatr PDF} (\url{https://www.sumatrapdfreader.org/}) que é muito leve. Ele não tem recursos de preenchimento de formulários ou acrescentar notas como o \texttt{Adobe Reader} (\url{https://get.adobe.com/br/reader/}), mas atende a maioria das necessidades.
\end{remark}
+\subsection*{TeXWorks\index{TeXWorks} e Gummi\index{Gummi}}
+
+\url{https://www.tug.org/texworks/}
+
+\url{https://alexandervdm.github.io/gummi/} (somente linux)
+
+O \texttt{TeXWorks} é um editor multiplataforma, leve e simples para \LaTeX. Apesar de ser desenvolvido para facilitar o uso pelos inciantes, não inclui o painel de inserçao de símbolos matemáticos e navegação na estrutura dos docuumentos.
+
+O \texttt{Gummi} é um editor leve para linux, com capacidade de compilação instantânea. Além de mostrar o documento compilado enquanto digita, ele usa o diretório temporário para compilar, mantendo a pasta do documento livre de arquivos intermediários que o \TeX{} costuma criar durante a compilação.
+Ele é indicado para documentos menores sem muita comlexidade por não conseguir desativar a compilação instantânea, assim como ausẽncia do painel de inserção de símbolos matemáticos e navegação na estrutura de documentos.
+
\section{Editor gráfico\index{editor gráfico}}
Editores gráficos ajudam a elaboração de ilustrações e similares.
@@ -13830,8 +13842,8 @@
site: \url{https://pandoc.org/}
-O \texttt{Pandoc} é um convertor de formato de documentos que suportam diversos formatos. Entre eles, tem a conversão de arquivos \texttt{MarkDown} para \LaTeX. Se não quer usar aplicativos do comando de linha, poderá usar do \texttt{GhostWriter} (\url{https://ghostwriter.kde.org/}) que é um editor de \texttt{MarkDown}, capaz de visualizar o resultado automaticamente em paralelo, assim como efetuar conversão pelo menu.
-O \texttt{MarkDown} é um formato de arquivo texto que pode ser lido diretamente, mas que também pode ser convertidos em \texttt{HTML} ou similar de forma rápida e simples. Este formato é popular no arquivo ``readme'' usado para descrição do programa ou similar, blogs, etc, além de elaboração de documentos simples (o \texttt{Pandoc} suporta fórmulas matemáticas no modo \TeX).
+O \texttt{Pandoc} é um convertor de formato de documentos que suportam diversos formatos, entre eles, o \LaTeX.
+% Entre eles, tem a conversão de arquivos \texttt{MarkDown} para \LaTeX.
\section{Outras ferramentas\index{ferramentas}}
@@ -13913,6 +13925,29 @@
%Gerador de \texttt{layout} das tabelas em \LaTeX.
% Parcialment gratuito? o que quer dizer "Seus 10 primieros clientes gratuitos"?
+\section{Algumas alternativas a \LaTeX}
+O \LaTeX{} é versátil e potente, porém a parte de programação (como desenvolvimento de pacotes e ajuste mais avançada de configurações) não é muito fácil por precisar programar em \TeX{}, o que apresenta a forma difernte das linguagens de programação usual. Apesar de Lua\TeX{} permitir programar na linguagem Lua, ele ainda não é considerada \TeX{} padrão (2025).
+Também existe caso na qual pretende elaborar documento mais rapidamente sem muita sofisticação, como efetuar anotações e similares. Para tanto, poderá procurar por outras alternativas, para ser usado em paralelo, ou até mesmo substituir o \LaTeX.
+
+\subsection*{MarkDown\index{MarkDown}}
+
+O \texttt{MarkDown} (\url{https://en.wikipedia.org/wiki/Markdown}) é um dos formatos de arquivo texto que pode ser lido diretamente, mas que também pode ser convertidos em \texttt{HTML}, \texttt{pdf}, ou similar de forma rápida e simples. Este formato é popular no arquivo ``readme'' usado para descrição do programa ou similar, blogs, anotações, etc (o \texttt{Pandoc} suporta fórmulas matemáticas no modo \TeX).
+Se não quer usar aplicativos do comando de linha como o \texttt{pandoc}, poderá usar o \texttt{GhostWriter} (\url{https://ghostwriter.kde.org/}) que é um editor de \texttt{MarkDown}, capaz de visualizar o resultado automaticamente em paralelo, assim como efetuar conversão pelo menu.
+
+\subsection*{typst\index{typst}}
+O \texttt{typst} é um sistema de diagramação científico em desenvolvimento com sintaxe inspirado em \texttt{MarkDown} e tem a compilação rápida. A parte de programação usa a linguagem \texttt{script} própria.
+O serviço \texttt{online} está em \url{https://typst.app/}, enquanto que o compilador em si para instalação local, está em \url{https://github.com/typst/typst}. Se quiser um editor dedicado, o \url{https://github.com/Bzero/typstwriter} é uma das opções gratuítas.
+
+\subsection*{SILE\index{SILE}}
+O SILE \url{https://sile-typesetter.org/} é um sistema de diagramação de documento científico em desenvolvimento, com sintaxe inspirado em \LaTeX. Para a parte de programação, usa nativamente a linguagem Lua.
+O compilador está em \url{https://github.com/sile.typesetter/sile/}.
+
+\subsection*{groff\index{groff}}
+O groff (\url{https://www.gnu.org/software/groff/}) é um sistema clássico, largamente utilizado para elaboração de documentos do projeto \texttt{GNU}.
+
+\subsection*{ConTeXt\index{ConTeXt}}
+O ConTeXt é um sistema baseado em \TeX{} (como o caso de \LaTeX). Enquanto que o \LaTeX{} tenta esconder as configurações de documentos (do usuário final) para que seja apropriado para submissão de arqtigos e simlares, ou a elaboração de documentos sem a necessidade do conhecimento técnico de diagramação, o ConTeXt facilita o acesso de tais recursos para os usuários, o que facilita a laboração de documentos genéricos.
+
% \clearpage
\clearpage\thispagestyle{empty}\cleardoublepage
\phantomsection
@@ -13945,7 +13980,7 @@
Estas classes implementam várias funcionalidades adicionais em relação as classes básicas.
Como existem pacotes específicos para cada assunto, é impossível conhecer todos eles.
-Mas, pelo menos podemos tentar conhecer os pacotes e classes populares existentes para área de atuação de cada um de nós.
+Mas, pelo menos podemos tentar conhecer alguns dos pacotes e classes populares existentes para área de atuação de cada um de nós.
%A quantidade de pacotes no \LaTeX{} é muito extensa.
%Assim, se precisar efetuar alguns ajustes refinados ou precisar de comandos ou ambientes complexos, vale a pena pesquisar se tem pacotes específicos para o que está pretendendo.
More information about the tex-live-commits
mailing list.