texlive[74977] Master/texmf-dist: asmejour (18apr25)
commits+karl at tug.org
commits+karl at tug.org
Fri Apr 18 22:55:59 CEST 2025
Revision: 74977
https://tug.org/svn/texlive?view=revision&revision=74977
Author: karl
Date: 2025-04-18 22:55:59 +0200 (Fri, 18 Apr 2025)
Log Message:
-----------
asmejour (18apr25)
Modified Paths:
--------------
trunk/Master/texmf-dist/doc/latex/asmejour/README.md
trunk/Master/texmf-dist/doc/latex/asmejour/asmejour-template.pdf
trunk/Master/texmf-dist/doc/latex/asmejour/asmejour-template.tex
trunk/Master/texmf-dist/doc/latex/asmejour/sample-figure-1.pdf
trunk/Master/texmf-dist/tex/latex/asmejour/asmejour.cls
Modified: trunk/Master/texmf-dist/doc/latex/asmejour/README.md
===================================================================
--- trunk/Master/texmf-dist/doc/latex/asmejour/README.md 2025-04-18 15:03:01 UTC (rev 74976)
+++ trunk/Master/texmf-dist/doc/latex/asmejour/README.md 2025-04-18 20:55:59 UTC (rev 74977)
@@ -1,7 +1,7 @@
#asmejour: A template for ASME journal papers#
- Version 1.25 dated 2025/04/07.
+ Version 1.26 dated 2025/04/18.
####Overview####
This class provides a template to format preprints in the style of journal papers published by the American Society of Mechanical Engineers.
@@ -21,8 +21,7 @@
sample-figure-1.pdf,
sample-figure-2a.pdf,
sample-figure-2b.pdf -- figures for the example template
- /asmewide_example -- directory includes asmewide.sty and examples of wide equations```
-
+ /asmewide_example -- directory includes asmewide.sty and examples of wide equations```
The .tex and .cls files are commented and should be self-explanatory.
@@ -67,20 +66,29 @@
####Change log####
+v1.26 (2025/04/18)
+ - Disable loading of exscale package by extarticle.cls (was causing spurious formula tag in section headings)
+ - Correct order of setting the lsmgreek and fsmgreek symbol fonts
+ - Move \\allowdisplaybreaks out of .cls and into .tex file, to allow user to control
+ - Drop unnecessary bookmark "Appendices"
+ - Add additional code/text around dropped option \[mathalfa=ccc=ddd\]
+ - Replace Figure 1 with a new pdf to end A-3u validation problem in pdfTeX
+ - Other minor changes in code and documentation
+
v1.25 (2025/04/07)
- - Add support for unicode-math, using fonts from TeX Live. Lualatex now loads unicode-math by default.
+ - Add support for unicode-math, using fonts from TeX Live. LuaLaTeX now loads unicode-math by default.
- Drop these packages: titlesec, enumitem, ifthen, iftex, totcount, hyperxmp, inputenc, bookmark, glyphtounicode
- Move hologo package loading from .cls file to .tex file
- - Drop \[mathalfa\] class option. User can instead load mathalpha in the preamble when using pdftex
+ - Drop \[mathalfa\] class option. User can instead load mathalpha in the preamble when using pdfTeX
- Drop legacy PDF/A options \[pdf-a, pdfaconformance, pdfapart\]. Use \\DocumentMetadata instead
- Select larger small caps from newtxtext by default, drop \[largesc\] option
- - Switch to \LaTeX's native keyvalue mechanism; load kvoptions package only for backward compatibility
+ - Switch to LaTeX's native keyvalue mechanism; load kvoptions package only for backward compatibility
- Change vertical skip adjustment on multline environment from 7pt to 10pt (= \\jot in this class)
- - Reduce use of etoolbox in favor of Latex's hook mechanisms; this limits asmejour to Latex formats dated 2020/10 or later
+ - Reduce use of etoolbox in favor of LaTeX's hook mechanisms; this limits asmejour to LaTeX formats dated 2020/10 or later
- Fixed operator encoding for sans and sansbold math versions (to OT1)
- - Add pages and chapter to @book reference in asmejour.bst; use pages= rather than eid= in sample .bib
+ - Add pages and chapter to @book{.. entry in asmejour.bst; use pages= rather than eid= in sample .bib
- Reduce space between items in lists
- - This version is backward compatible to the 2020/10 latex format. Older versions will not compile.
+ - This version is backward compatible to the 2020/10 LaTeX format. Older formats will not compile this version.
- Convert sample images to PDF/A-3u
- Convert remaining title block code to expl3
- Add error message for unused \\author command
Modified: trunk/Master/texmf-dist/doc/latex/asmejour/asmejour-template.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/asmejour/asmejour-template.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/asmejour/asmejour-template.tex 2025-04-18 15:03:01 UTC (rev 74976)
+++ trunk/Master/texmf-dist/doc/latex/asmejour/asmejour-template.tex 2025-04-18 20:55:59 UTC (rev 74977)
@@ -3,7 +3,7 @@
%%
%% This file is asmejour-template.tex, a template to format papers in the style of ASME journal papers.
%%
-%% This file is version 1.25 dated 2024/04/07
+%% This file is version 1.26 dated 2024/04/18
%%
%% Author: John H. Lienhard V
%% Department of Mechanical Engineering
@@ -23,7 +23,7 @@
%%
%% * Option to balance column heights on final page [balance]. This option sometimes
%% * misbehaves, so use it with an awareness that it can create unexpected problems.
-%% * This option is not compatible with line numbering and requires [nolists] option.
+%% * This option is not compatible with line numbering.
%%
%% * Options for copyright notices:
%% * Omit the ASME copyright from the footer [nocopyright]
@@ -80,7 +80,10 @@
%% If you have problems with these lines, your LaTeX format may be out of date. You can comment them out.
\DocumentMetadata{%
- pdfstandard=A-3u,% A-2b, A-2u, A-3b, or A-3u; don't use A-3u with pdftex
+% testphase={phase-III,math,table,firstaid,title},% testphase for producing tagged pdf.
+% pdfstandard = ua-2,
+% pdfversion = 2.0,
+ pdfstandard=A-3u,% A-2b, A-2u, A-3b, or A-3u
pdfversion=1.7,
lang=en-US,
}
@@ -87,10 +90,15 @@
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-%% Class options are described above. Use only the options you need. (Note: mathalfa option dropped in v1.25;
-%% load mathalpha in your preamble instead.)
-\documentclass[nocopyright,upint,varvw,hyphenate,barcolor=Goldenrod3,german]{asmejour}%
+%% Class options are described above. Use only the options you need.
+%% Note: the [mathalfa=ccc=ddd] option was dropped in v1.25; load mathalpha in your preamble instead
+\documentclass[balance,nocopyright,upint,varvw,hyphenate,barcolor=Goldenrod3,german]{asmejour}%
+
+
+\allowdisplaybreaks % from amsmath package, allows multiline equations to break across pages (delete if not wanted)
+ % using \\* instead of \\ will prevent specific lines from being pagebreaks.
+
\usepackage{hologo} % access various latex logos if needed
@@ -415,7 +423,7 @@
\subsection{Controlling Calligraphic, Script, Fraktur, or BB Fonts}
-With \hologo{pdfLaTeX}, the \texttt{[mathalpha]} package may be loaded in the preamble~\cite{sharpe2}.\footnote{As of v1.25, the \texttt{[mathalfa]} class option has been dropped.} This package supports variety of font for calligraphic, fraktur, script, and blackboard bold fonts. For example,
+With \hologo{pdfLaTeX}, the \texttt{[mathalpha]} package may be loaded in the preamble~\cite{sharpe2}.\footnote{As of v1.25, the \texttt{[mathalfa=ccc=ddd]} class option has been dropped.} This package supports variety of font for calligraphic, fraktur, script, and blackboard bold fonts. For example,
\begin{center}
\verb|\usepackage[cal=euler,frak=boondox]{mathalpha}|
\end{center}
@@ -624,7 +632,7 @@
When more than one language option is included in \verb|\documentclass[..]{asmejour}|, English will be
assumed to be the main language of the document. (To choose a different main language, set the class option \texttt{[main=..]}).
-The standard caption and section names will follow \texttt{babel}'s dictionary for primary languages other than English. Users may additionally change ``Keywords'', ``Nomenclature'', and ``Corresponding author'' by renewing the commands \verb|\keywordname|, \verb|\nomname|, and \verb|\CAwords|. Changes to the page footer were described in Sec.~\ref{sec:footer}. The pdf bookmark for ``Appendices'' by be changed by renewing \verb|\appendicesname|.
+The standard caption and section names will follow \texttt{babel}'s dictionary for primary languages other than English. Users may additionally change ``Keywords'', ``Nomenclature'', and ``Corresponding author'' by renewing the commands \verb|\keywordname|, \verb|\nomname|, and \verb|\CAwords|. Changes to the page footer were described in Sec.~\ref{sec:footer}.
The font encoding is set to T1 (\hologo{pdfLaTeX}) or TU (\hologo{LuaLaTeX}), and utf-8 input is supported:
%% If you have trouble with the next line, your file may not be saved in utf-8 format. You can delete these lines to resolve the issue.
Modified: trunk/Master/texmf-dist/doc/latex/asmejour/sample-figure-1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/tex/latex/asmejour/asmejour.cls
===================================================================
--- trunk/Master/texmf-dist/tex/latex/asmejour/asmejour.cls 2025-04-18 15:03:01 UTC (rev 74976)
+++ trunk/Master/texmf-dist/tex/latex/asmejour/asmejour.cls 2025-04-18 20:55:59 UTC (rev 74977)
@@ -5,8 +5,8 @@
%% The asmejour.cls file should be used with the files asmejour.bst (for citations) and asmejour-template.tex.
%%
%% This file's version and date are:
- \def\versionno{1.25}
- \def\versiondate{2025/04/07\space}
+ \def\versionno{1.26}
+ \def\versiondate{2025/04/18\space}
%%
%% Author: John H. Lienhard V
%% Department of Mechanical Engineering
@@ -61,11 +61,15 @@
\NeedsTeXFormat{LaTeX2e}
\ProvidesClass{asmejour}[\versiondate asmejour paper format (JHL)]
-\LoadClass[twoside,9pt]{extarticle}% twocolumn format initiated by \maketitle command 2024/07/20
+\ExplSyntaxOn
+\cs_if_exist:NT \disable at package@load { \disable at package@load{exscale}{\relax} }
+ % stop extarticle from loading exscale: not using CMR + breaks tagging of \section with \mathversion{..}
+
+\LoadClass[twoside,9pt]{extarticle}% twocolumn format is initiated by the \maketitle command 2024/07/20
+
\newif\ifasmejour at pdftex
\newif\ifPDFtex
-\ExplSyntaxOn
\sys_if_engine_pdftex:T {
\asmejour at pdftextrue
\PDFtextrue % for end user
@@ -116,6 +120,9 @@
\newif\ifasmejour at mainset
+\typeout{^^J If~you~see~an~error~"Use~of~\string\???~doesn't~match~its~definition...Misplaced~'='~in~key-value~input",~remove~
+ the~deprecated~option~[mathalfa=ccc=ddd]~from~\string\documentclass. ^^J}
+
%% Now create options and keys
\IfFormatAtLeastTF{2022/11/01}{
\str_new:N \asmejour at barcolor
@@ -125,7 +132,7 @@
\cs_new:Nn \__asmejour_setupmain:n {
\PassOptionsToPackage{ main=#1 }{babel}
\asmejour at mainsettrue
- \msg_note:nnn { \ClassName } { mainlang } {#1}
+ \msg_term:nnn { \ClassName } { mainlang } {#1}
}
\DeclareKeys[\ClassName]
{
@@ -220,7 +227,7 @@
%% if main language was not was chosen explicitly, default to English
\ifasmejour at mainset\relax\else
\PassOptionsToPackage{main=english}{babel}%
- \ClassNoteNoLine{\ClassName}{Selecting~English~as~the~primary~language,~since~main=~not~set}%
+ \msg_log:nnn { \ClassName } { mainlang } {English}
\fi
\ExplSyntaxOff
@@ -386,7 +393,8 @@
\IfFontExistsTF{XITSMath-Bold.otf}{
\setmathfont{XITSMath-Bold.otf}[Scale=MatchUppercase,version=bold]% font is missing \cdot U+22C5
\setmathfontface\mathrm{XITSMath-Bold.otf}[Scale=MatchUppercase,version=bold]
- \AddToHook{begindocument/end} % this command added to LaTeX, 2020/10
+ % the next command added to LaTeX, 2020/10; not clear why /end is required when other begindocument hooks come first
+ \AddToHook{begindocument/end}
{
\NewCommandCopy{\standardcdot}{\cdot} % thanks to Enrico Gregorio and David Carlisle for this solution
\cs_set_protected:Npn \cdot
@@ -432,6 +440,10 @@
Scale=MatchUppercase,
version=sans,
]
+ \DeclareSymbolFont{lsmgreek}{TU}{lsm}{m}{n}% NFSSFamily lsm set above
+ \SetSymbolFont{lsmgreek}{normal}{TU}{lsm}{m}{n}
+ \SetSymbolFont{lsmgreek}{bold}{TU}{lsm}{b}{n}% This needs to come before math version bold is declared
+%
\setmathfont{STIXTwoMath-Regular}[% In TeX Live. Substitution for bigger integrals (similar to newtxmath)
Extension = .otf,
Scale=MatchUppercase,
@@ -460,6 +472,10 @@
BoldFont=*,
BoldFeatures = {FakeBold=4},
]
+ \DeclareSymbolFont{fsmgreek}{TU}{fsm}{m}{n}% NFSSFamily fsm set above
+ \SetSymbolFont{fsmgreek}{normal}{TU}{fsm}{m}{n}
+ \SetSymbolFont{fsmgreek}{bold}{TU}{fsm}{b}{n}% This needs to come before math version bold is declared
+%
\setmathfontface\mathrm{FiraMath-Regular.otf}[
Scale=MatchUppercase,
version=sans,
@@ -481,11 +497,11 @@
\setmathfontface\mathsf{texgyreheros-bold.otf}[Scale=0.91,version=sansbold] % for sf
\setmathfontface\mathit{texgyreheros-bolditalic.otf}[Scale=0.91,version=sansbold] % for it
\setmathfontface\mathtt{Inconsolatazi4-Bold.otf}[Scale=1.0,version=sansbold] % for tt
-
+%
\setmathfontface\mathsf{texgyreheros-regular.otf}[Scale=0.91,version=sans] % for sf
\setmathfontface\mathit{texgyreheros-italic.otf}[Scale=0.91,version=sans] % for it
\setmathfontface\mathtt{Inconsolatazi4-Regular.otf}[Scale=1.0,version=sans] % for tt
-%%
+%
\setoperatorfont\normalfont % to enable sans or bold operators, etc.
\fi
@@ -510,9 +526,9 @@
\DeclareFontShape{T1}{qhvc}{m}{n}{<-> s*[0.91] ec-qhvcr}{} %% see t1qhvc.fd; 0.9-->0.94 2022/01/15; 0.94-->0.91 2022/06/26
\DeclareFontShape{T1}{qhvc}{b}{n}{<-> s*[0.91] ec-qhvcb}{} %% see t1qhvc.fd; 0.9-->0.94 2022/01/15; 0.94-->0.91 2022/06/26
\newcommand*{\CondSans}{\fontencoding{T1}\fontfamily{qhvc}\selectfont}% remove extra \selectfont, 2023/10/21
-\newcommand\Condhuge{\@setfontsize\huge{14}{14}} %... for author names only
+\newcommand*\Condhuge{\@setfontsize\huge{14}{14}} %... for author names only
\newcommand*{\CondSansBold}{\renewcommand\bfdefault{b}\fontencoding{T1}\fontfamily{qhvc}\selectfont\bfseries}
-\newcommand\CondHuge{\@setfontsize\Huge{26.5}{26.5}} %... for title only
+\newcommand*\CondHuge{\@setfontsize\Huge{26.5}{26.5}} %... for title only
\ifasmejour at pdftex
%% sans math version, potential value with PGFPlots, etc., 2021/01/25 %%%
@@ -519,12 +535,10 @@
\DeclareMathVersion{sans}
\SetSymbolFont{letters}{sans}{OML}{ntxsfmi}{m}{it}
\SetSymbolFont{lettersA}{sans}{U}{ntxsfmia}{m}{it}
- \IfFormatAtLeastTF{2016/01/05}{%
- \SetSymbolFont{symbols}{sans}{LMS}{ntxsy}{m}{n}
- }{\relax}
+ \SetSymbolFont{symbols}{sans}{LMS}{ntxsy}{m}{n}
\SetSymbolFont{largesymbols}{sans}{LMX}{ntxexx}{m}{n}
\SetSymbolFont{largesymbolsTXA}{sans}{U}{ntxexa}{m}{n}
- \SetSymbolFont{operators}{sans}{OT1}{\sfdefault}{m}{n}% fixed encoding 2025/04/04
+ \SetSymbolFont{operators}{sans}{OT1}{\sfdefault}{\rmdefault}{n}% fixed encoding 2025/04/04; fix \rmdefault 2025/04/18
\SetMathAlphabet{\mathsf}{sans}{\encodingdefault}{\sfdefault}{m}{n}% make upright 2021/01/31.
%
%% sans serif italic and sans serif bold italic math
@@ -540,19 +554,18 @@
\fi
%%%%%%%%%%%%%% Sans serif upright greek and sans mathversion %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-% revised 2025/04/03
+% revised 2025/04/17
%
\ifasmejour at pdftex
%% Provide sans-serif *upright* Greek letters, following a suggestion by Michael Sharpe (March 2019).
%% Following Sharpe's newtxsf implementation of the STIX fonts, under the LaTeX Project Public License.
%% (Note that \mathversion{sansbold} provides sans-serif *italic* Greek letters.)
-
\DeclareSymbolFont{lettersAB}{U}{ntxsfmia}{m}{it}
\SetSymbolFont{lettersAB}{normal}{U}{ntxsfmia}{m}{it}
\SetSymbolFont{lettersAB}{bold}{U}{ntxsfmia}{b}{it}
\SetSymbolFont{lettersAB}{sans}{U}{ntxsfmia}{m}{it}
\SetSymbolFont{lettersAB}{sansbold}{U}{ntxsfmia}{b}{it}
-
+
\DeclareMathSymbol{\sfGamma}{\mathalpha}{lettersAB}{0}% adjust to avoid overwriting newtxmath commands, 2021/01/25
\DeclareMathSymbol{\sfDelta}{\mathalpha}{lettersAB}{1}
\DeclareMathSymbol{\sfTheta}{\mathalpha}{lettersAB}{2}
@@ -609,14 +622,8 @@
\else
\IfFontExistsTF{LeteSansMath-Bold}
{
- \DeclareSymbolFont{lsmgreek}{TU}{lsm}{m}{n}% NFSSFamily lsm set above
- \SetSymbolFont{lsmgreek}{normal}{TU}{lsm}{m}{n}
- \SetSymbolFont{lsmgreek}{bold}{TU}{lsm}{b}{n}
\def\ac at sansgreek{\symlsmgreek}
}{
- \DeclareSymbolFont{fsmgreek}{TU}{fsm}{m}{n}% NFSSFamily fsm set above
- \SetSymbolFont{fsmgreek}{normal}{TU}{fsm}{m}{n}
- \SetSymbolFont{fsmgreek}{bold}{TU}{fsm}{b}{n}
\def\ac at sansgreek{\symfsmgreek}
}
% uppercase greek
@@ -744,7 +751,7 @@
\Umathchardef\sfbfvarpi="0 \ac at sansgreek "1D6E1
\fi
-% and simple cheat to avoid errors when switching from luatex to pdftex with the template example
+% and a simple cheat to avoid errors when switching from luatex to pdftex with the template example
\providecommand*\mitDelta{\Delta}
@@ -758,9 +765,7 @@
\AddToHook{env/multline/begin}{\addtolength\abovedisplayskip{-10pt}}% 2025/04/06 increase to 10pt from 7pt, use hooks rather than etoolbox
\AddToHook{env/multline/end}{\addtolength\abovedisplayskip{+10pt}}
-\allowdisplaybreaks % ASME allows these breaks
-
%%%%%%%%%%%%%%%%% Equation and Line Numbering %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%% ASME puts equation tags in blue
@@ -920,9 +925,9 @@
\RequirePackage[labelfont={sf,bf},hypcap=false]{caption}
\RequirePackage[hypcap=false,list=true]{subcaption}
-%% This option is experimental and documented only here, 2025/04/01
-%% purpose is to allow tagged pdf based on current latex-lab code
-%% subcaptions are not specifically addressed in this patch
+%% This option is experimental and documented only here, 2025/04/01.
+%% purpose is to allow tagged pdf based on current latex-lab code.
+%% subcaptions are not specifically addressed in this patch.
%% babel [spanish] option is NOT compatible with tagging.
\ifasmejour at captionpatch
%% see github discussion of this patch by Ulrike Fischer
@@ -988,10 +993,8 @@
\patchcmd{\@seccntformat}{\quad}{\hspace*{1em}}{}{}
\let\paragraph\subsubsection
-% note, 2025/04/07: \mathversion{bold} gets tagged as a formula in display headings, which \@xsect, etc. handle differently. Unclear why this happens.
-
% Insert period at end of subsection and subsubsection titles
-% Would prefer a more streamlined approach, but no simple hook for #8 in \section
+% ...would prefer a more streamlined approach, but there's no simple hook for #8 in \section.
\let\oldsubsection\subsection
\RenewDocumentCommand{\subsection}{s o m}{%
\IfBooleanTF{#1} % starred version
@@ -1056,7 +1059,6 @@
}
}
-\providecommand*{\appendicesname}{Appendices}
\renewcommand{\appendix}{
\par
\__asmejour_change_hangindent:
@@ -1063,7 +1065,6 @@
\setcounter{section}{0}
\setcounter{subsection}{0}
\@addtoreset{equation}{section}
- \pdfbookmark[1]{\appendicesname}{appendices}
\gdef\theequation{\@Alph\c at section\@arabic\c at equation}
\gdef\thesection{\@Alph\c at section}
\gdef\thesubsection{\@Alph\c at section.\@arabic\c at subsection}
@@ -1099,10 +1100,6 @@
\itemsep 0\p@
}
}
-%\AtBeginDocument{
-% \patchcmd{\@listi}{\parsep 4\p@ \@plus 2\p@ \@minus \p@}{\parsep 0\p@}{}{}
-% \patchcmd{\@listi}{\itemsep \parsep}{\itemsep 0\p@}{}{}
-%}
%%%%%%%%%%%%%%%%% Hyperref %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -1110,7 +1107,6 @@
%%% to assist with unicode glyph mapping, following M. Sharpe's recommendation in the newtx documentation.
%%% as of 2024/07/28, these are still necessary with \DocumentMetadata{pdfstandard=A-3u}.
\InputIfFileExists{glyphtounicode-cmr.tex}{}{} %% additional mappings
- \InputIfFileExists{glyphtounicode-cmex.tex}{}{} %% additional mappings in latex-lab.
\InputIfFileExists{glyphtounicode-ntx.tex}{}{} %% additional mappings
\fi
More information about the tex-live-commits
mailing list.