texlive[75960] Master: fontawesomescaled (3aug25)
commits+karl at tug.org
commits+karl at tug.org
Sun Aug 3 21:06:54 CEST 2025
Revision: 75960
https://tug.org/svn/texlive?view=revision&revision=75960
Author: karl
Date: 2025-08-03 21:06:53 +0200 (Sun, 03 Aug 2025)
Log Message:
-----------
fontawesomescaled (3aug25)
Modified Paths:
--------------
trunk/Master/tlpkg/bin/tlpkg-ctan-check
trunk/Master/tlpkg/libexec/ctan2tds
trunk/Master/tlpkg/tlpsrc/collection-fontsextra.tlpsrc
Added Paths:
-----------
trunk/Master/texmf-dist/doc/latex/fontawesomescaled/
trunk/Master/texmf-dist/doc/latex/fontawesomescaled/README.md
trunk/Master/texmf-dist/doc/latex/fontawesomescaled/fontawesomescaled-doc.pdf
trunk/Master/texmf-dist/doc/latex/fontawesomescaled/fontawesomescaled-doc.tex
trunk/Master/texmf-dist/tex/latex/fontawesomescaled/
trunk/Master/texmf-dist/tex/latex/fontawesomescaled/fontawesomescaled.sty
trunk/Master/tlpkg/tlpsrc/fontawesomescaled.tlpsrc
Added: trunk/Master/texmf-dist/doc/latex/fontawesomescaled/README.md
===================================================================
--- trunk/Master/texmf-dist/doc/latex/fontawesomescaled/README.md (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/fontawesomescaled/README.md 2025-08-03 19:06:53 UTC (rev 75960)
@@ -0,0 +1,9 @@
+fontawesomescaled is a package with additional macros for fontawesome icons with custom scale.
+
+----------------------------------------------------------------------------------------------
+
+Author : Cédric Pierquet
+
+email : cpierquet at outlook.fr
+
+Licence : Released under the LaTeX Project Public License v1.3c or later, see http://www.latex-project.org/lppl.txt
\ No newline at end of file
Property changes on: trunk/Master/texmf-dist/doc/latex/fontawesomescaled/README.md
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/latex/fontawesomescaled/fontawesomescaled-doc.pdf
===================================================================
(Binary files differ)
Index: trunk/Master/texmf-dist/doc/latex/fontawesomescaled/fontawesomescaled-doc.pdf
===================================================================
--- trunk/Master/texmf-dist/doc/latex/fontawesomescaled/fontawesomescaled-doc.pdf 2025-08-03 19:06:00 UTC (rev 75959)
+++ trunk/Master/texmf-dist/doc/latex/fontawesomescaled/fontawesomescaled-doc.pdf 2025-08-03 19:06:53 UTC (rev 75960)
Property changes on: trunk/Master/texmf-dist/doc/latex/fontawesomescaled/fontawesomescaled-doc.pdf
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/pdf
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/latex/fontawesomescaled/fontawesomescaled-doc.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/fontawesomescaled/fontawesomescaled-doc.tex (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/fontawesomescaled/fontawesomescaled-doc.tex 2025-08-03 19:06:53 UTC (rev 75960)
@@ -0,0 +1,182 @@
+% !TeX TXS-program:compile = txs:///arara
+% arara: pdflatex: {shell: no, synctex: no, interaction: batchmode}
+% arara: pdflatex: {shell: no, synctex: no, interaction: batchmode}
+
+\documentclass{article}
+\usepackage[margin=1in]{geometry}
+\usepackage[versionfa=5]{fontawesomescaled}
+\usepackage{tabularray}
+\usepackage{codehigh}
+\usepackage{hyperref}
+\usepackage{fancyvrb}
+\usepackage{fvextra}
+\usepackage{shortvrb}
+\MakeShortVerb{\|}
+\setlength{\parindent}{0pt}
+
+\begin{document}
+
+\title{The \textsf{fontawesomescaled} package (0.1.0) -- \today}
+\author{%
+ Cédric Pierquet\\%
+ \url{https://github.com/cpierquet/latex-packages/tree/main/fontawesomescaled}%
+}
+\date{cpierquet -- at -- outlook . fr}\maketitle
+
+This package provides \LaTeX{} support for (automatic) scaling \texttt{fontawesome(s)} icons (\texttt{0.85} by default).
+
+\medskip
+
+To use \texttt{fontawesomescaled} in your document, include the package with |\usepackage{fontawesomescaled}|.
+
+\section{Usage and option}
+
+\subsection{Global usage}
+
+The package don't load (by default) \texttt{fontawesome(x)} package, it define macro in order to use \texttt{fontawesome(x)} icons.
+
+By default, a scale of \texttt{0.85} is applied, within a \texttt{scalebox}, and if the scale is set to \texttt{1}, \textit{normal} insertion is used, w/o \texttt{scalebox}.
+
+Few \textit{options} (which can be combined) are available within the loading :
+
+\begin{itemize}
+ \item with option \texttt{[versionfa=<version>]}, \texttt{fontawesome<version>} can be automatically loaded;
+ \item with option \texttt{[hook]}, an automatic patch with |\smaller| macro of \texttt{relsize} package is used, when |\faIcon| is used;
+ \item with option \texttt{[scale=<value>]}, a global scale is applied.
+\end{itemize}
+
+\begin{Verbatim}[frame=single]
+\usepackage{fontawesomescaled} %default loading (no fa + scale=0.85)
+\usepackage[versionfa=1]{fontawesomescaled} %with fontawesome loaded
+\usepackage[versionfa=5]{fontawesomescaled} %with fontawesome5 loaded
+\usepackage[versionfa=6]{fontawesomescaled} %with fontawesome6 loaded
+\usepackage[versionfa=7]{fontawesomescaled} %with fontawesome7 loaded
+\usepackage[hook]{fontawesomescaled} %\smaller (rellsize) usage for \faIcon{...}
+\usepackage[scale=0.925]{fontawesomescaled} %with global scale of 0.925
+\end{Verbatim}
+
+\begin{Verbatim}[frame=single]
+\DefineFaScale{<value>} %change default value of the scaling
+\end{Verbatim}
+
+\subsection{Used packages}
+
+\texttt{ifthen}, \texttt{graphicx}, \texttt{xkeyval}, \texttt{simplekv}, and optionally \texttt{relsize}, are loaded and used by the package.
+
+\subsection{Bugs}
+
+For bug reports and feature requests, report on the GitHub repository \url{https://github.com/cpierquet/latex-packages/issues}.
+
+\pagebreak
+
+\section{The macros}
+
+\subsection{Normal version}
+
+Normal version of the main macro is |\faIconScaled| (relative to |\faIcon|!).
+
+Starred version (for \texttt{fontawesome5}), and \texttt{[regular]} version can be specified.
+
+\begin{Verbatim}[frame=single]
+For example, \faIconScaled{exclamation-circle}%
+\faIconScaled[scale=1]{exclamation-circle}%
+\faIconScaled[scale=0.5]{exclamation-circle}.
+\end{Verbatim}
+
+\textbf{Result:} For example, \faIconScaled{exclamation-circle}\faIconScaled[scale=1]{exclamation-circle}\faIconScaled[scale=0.5]{exclamation-circle}.
+
+\begin{Verbatim}[frame=single]
+%patched version of \faIcon(*)[regular]{<name>} %if * and regular are available!
+
+\faIconScaled(*)[regular=TF,scale=<value>]{<name>}
+\end{Verbatim}
+
+\begin{tblr}{hlines,vlines,colspec={ccccc},cells={font=\footnotesize}}
+ \SetCell[r=1,c=5]{c}{\texttt{scale=0.85} by default}&&&&\\
+ \textbf{Name} & \textbf{Initial macro} & \textbf{Initial version} & \textbf{Patched macro} & \textbf{Patched version} \\
+ \SetCell[r=4,c=1]{c}{file}&\fakeverb{\faIcon{file}} & \faIcon{file}~test & \fakeverb{\faIconScaled{file}} & \faIconScaled{file}~test \\
+ &\fakeverb{\faIcon*{file}} & \faIcon*{file}~test & \fakeverb{\faIconScaled*{file}} & \faIconScaled*{file}~test \\
+ &\fakeverb{\faIcon[regular]{file}} & \faIcon[regular]{file}~test & \fakeverb{\faIconScaled[regular]{file}} & \faIconScaled[regular]{file}~test \\
+ &\fakeverb{\faIcon*[regular]{file}} & \faIcon*[regular]{file}~test & \fakeverb{\faIconScaled*[regular]{file}} & \faIconScaled*[regular]{file}~test \\
+\end{tblr}
+
+\DefineFaScale{0.66}
+\begin{tblr}{hlines,vlines,colspec={ccccc},cells={font=\footnotesize}}
+ \SetCell[r=1,c=5]{c}{\texttt{scale=0.66} with \fakeverb{\DefineFaScale{0.66}}}&&&&\\
+ \textbf{Name} & \textbf{Initial macro} & \textbf{Initial version} & \textbf{Patched macro} & \textbf{Patched version} \\
+ \SetCell[r=4,c=1]{c}{file}&\fakeverb{\faIcon{file}} & \faIcon{file}~test & \fakeverb{\faIconScaled{file}} & \faIconScaled{file}~test \\
+ &\fakeverb{\faIcon*{file}} & \faIcon*{file}~test & \fakeverb{\faIconScaled*{file}} & \faIconScaled*{file}~test \\
+ &\fakeverb{\faIcon[regular]{file}} & \faIcon[regular]{file}~test & \fakeverb{\faIconScaled[regular]{file}} & \faIconScaled[regular]{file}~test \\
+ &\fakeverb{\faIcon*[regular]{file}} & \faIcon*[regular]{file}~test & \fakeverb{\faIconScaled*[regular]{file}} & \faIconScaled*[regular]{file}~test \\
+\end{tblr}
+
+\DefineFaScale{1.25}
+\begin{tblr}{hlines,vlines,colspec={ccccc},cells={font=\footnotesize}}
+ \SetCell[r=1,c=5]{c}{\texttt{scale=1.25} with \fakeverb{\DefineFaScale{1.25}}}&&&&\\
+ \textbf{Name} & \textbf{Initial macro} & \textbf{Initial version} & \textbf{Patched macro} & \textbf{Patched version} \\
+ \SetCell[r=4,c=1]{c}{file}&\fakeverb{\faIcon{file}} & \faIcon{file}~test & \fakeverb{\faIconScaled{file}} & \faIconScaled{file}~test \\
+ &\fakeverb{\faIcon*{file}} & \faIcon*{file}~test & \fakeverb{\faIconScaled*{file}} & \faIconScaled*{file}~test \\
+ &\fakeverb{\faIcon[regular]{file}} & \faIcon[regular]{file}~test & \fakeverb{\faIconScaled[regular]{file}} & \faIconScaled[regular]{file}~test \\
+ &\fakeverb{\faIcon*[regular]{file}} & \faIcon*[regular]{file}~test & \fakeverb{\faIconScaled*[regular]{file}} & \faIconScaled*[regular]{file}~test \\
+\end{tblr}
+
+\pagebreak\DefineFaScale{0.85}
+
+\subsection{Alias version}
+
+Alias version of the main macro is |\faScaled| (relative to |\fa<alias>|!).
+
+Starred version (for \texttt{fontawesome5}), and \texttt{[regular]} version can be specified.
+
+\begin{Verbatim}[frame=single]
+For example, \faScaled{Eye}%
+\faScaled[scale=1]{Eye}%
+\faScaled[scale=0.5]{Eye}.
+\end{Verbatim}
+
+\textbf{Result:} For example, \faScaled{Eye}\faScaled[scale=1]{Eye}\faScaled[scale=0.5]{Eye}.
+
+\begin{Verbatim}[frame=single]
+%patched version of \fa<Alias>(*)[regular] %if * and regular are available!
+
+\faScaled(*)[regular=TF,scale=<value>]{<Alias>}
+\end{Verbatim}
+
+\begin{tblr}{hlines,vlines,colspec={ccccc},cells={font=\footnotesize}}
+ \SetCell[r=1,c=5]{c}{\texttt{scale=0.85} by default}&&&&\\
+ \textbf{Alias} & \textbf{Initial macro} & \textbf{Initial version} & \textbf{Patched macro} & \textbf{Patched version} \\
+ \SetCell[r=4,c=1]{c}{File}&\fakeverb{\faFile} & \faFile~test & \fakeverb{\faScaled{File}} & \faScaled{File}~test \\
+ &\fakeverb{\faFile*} & \faFile~test & \fakeverb{\faScaled*{File}} & \faScaled*{File}~test \\
+ &\fakeverb{\faFile[regular]} & \faFile[regular]~test & \fakeverb{\faScaled[regular]{File}} & \faScaled[regular]{File}~test \\
+ &\fakeverb{\faFile*[regular]} & \faFile*[regular]~test & \fakeverb{\faScaled*[regular]{File}} & \faScaled*[regular]{File}~test \\
+\end{tblr}
+
+\DefineFaScale{0.66}
+\begin{tblr}{hlines,vlines,colspec={ccccc},cells={font=\footnotesize}}
+ \SetCell[r=1,c=5]{c}{\texttt{scale=0.66} with \fakeverb{\DefineFaScale{0.66}}}&&&&\\
+ \textbf{Alias} & \textbf{Initial macro} & \textbf{Initial version} & \textbf{Patched macro} & \textbf{Patched version} \\
+ \SetCell[r=4,c=1]{c}{File}&\fakeverb{\faFile} & \faFile~test & \fakeverb{\faScaled{File}} & \faScaled{File}~test \\
+ &\fakeverb{\faFile*} & \faFile~test & \fakeverb{\faScaled*{File}} & \faScaled*{File}~test \\
+ &\fakeverb{\faFile[regular]} & \faFile[regular]~test & \fakeverb{\faScaled[regular]{File}} & \faScaled[regular]{File}~test \\
+ &\fakeverb{\faFile*[regular]} & \faFile*[regular]~test & \fakeverb{\faScaled*[regular]{File}} & \faScaled*[regular]{File}~test \\
+\end{tblr}
+
+\DefineFaScale{1.25}
+\begin{tblr}{hlines,vlines,colspec={ccccc},cells={font=\footnotesize}}
+ \SetCell[r=1,c=5]{c}{\texttt{scale=1.25} with \fakeverb{\DefineFaScale{1.25}}}&&&&\\
+ \textbf{Alias} & \textbf{Initial macro} & \textbf{Initial version} & \textbf{Patched macro} & \textbf{Patched version} \\
+ \SetCell[r=4,c=1]{c}{File}&\fakeverb{\faFile} & \faFile~test & \fakeverb{\faScaled{File}} & \faScaled{File}~test \\
+ &\fakeverb{\faFile*} & \faFile~test & \fakeverb{\faScaled*{File}} & \faScaled*{File}~test \\
+ &\fakeverb{\faFile[regular]} & \faFile[regular]~test & \fakeverb{\faScaled[regular]{File}} & \faScaled[regular]{File}~test \\
+ &\fakeverb{\faFile*[regular]} & \faFile*[regular]~test & \fakeverb{\faScaled*[regular]{File}} & \faScaled*[regular]{File}~test \\
+\end{tblr}
+
+\pagebreak
+
+\section{The code}
+
+\fvset{frame=single,numbers=left,numbersep=3pt,fontsize=\footnotesize,breaklines=true}
+\VerbatimInput{fontawesomescaled.sty}
+
+
+\end{document}
\ No newline at end of file
Property changes on: trunk/Master/texmf-dist/doc/latex/fontawesomescaled/fontawesomescaled-doc.tex
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/Master/texmf-dist/tex/latex/fontawesomescaled/fontawesomescaled.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/fontawesomescaled/fontawesomescaled.sty (rev 0)
+++ trunk/Master/texmf-dist/tex/latex/fontawesomescaled/fontawesomescaled.sty 2025-08-03 19:06:53 UTC (rev 75960)
@@ -0,0 +1,96 @@
+% Author : C. Pierquet
+% licence : Released under the LaTeX Project Public License v1.3c or later, see http://www.latex-project.org/lppl.txt
+
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesPackage{fontawesomescaled}[2025/08/02 0.1.0 Small patchs for scaling fontawesome icons]
+
+%====HISTORY
+% v 0.1.0 Initial version
+
+%====PACKAGES
+\RequirePackage{xkeyval} %keyval for package
+\RequirePackage{ifthen} %tests
+\RequirePackage{graphicx} %for scalebox
+\RequirePackage{simplekv} %keyval for macro
+\RequirePackage{relsize} %for \smaller
+
+%====OPTIONS
+\newif\if at hook\@hookfalse
+\DeclareOptionX{versionfa}[0]{\def\fascaled at fa@version{#1}}
+\DeclareOptionX{scale}[0.85]{\def\fascaled at fa@scale{#1}}
+\DeclareOptionX{hook}{\@hooktrue}
+\DeclareOptionX*{}
+\ExecuteOptionsX{versionfa,hook,scale}
+\ProcessOptionsX\relax
+
+%====FONTAWESOME
+\ifnum\fascaled at fa@version=1
+ \RequirePackage{fontawesome}
+\fi
+\ifnum\fascaled at fa@version=5
+ \RequirePackage{fontawesome5}
+\fi
+\ifnum\fascaled at fa@version=6
+ \RequirePackage{fontawesome6}
+\fi
+\ifnum\fascaled at fa@version=7
+ \RequirePackage{fontawesome7}
+\fi
+
+%====KEYS
+\defKV[faIconScaled]{scale=\def\faiconscale{#1}}
+\setKVdefault[faIconScaled]{regular=false,scale=\fascaled at fa@scale}
+
+%====MAIN MACROS
+\NewDocumentCommand\faIconScaled{sO{}m}{%
+ \restoreKV[faIconScaled]%
+ \setKV[faIconScaled]{#2}%
+ \ifboolKV[faIconScaled]{regular}%
+ {%
+ \ifthenelse{\equal{\faiconscale}{1}}%
+ {\IfBooleanTF{#1}{\faIcon*[regular]{#3}}{\faIcon[regular]{#3}}}%
+ {%
+ \scalebox{\faiconscale}[\faiconscale]%
+ {\IfBooleanTF{#1}{\faIcon*[regular]{#3}}{\faIcon[regular]{#3}}}%
+ }%
+ }%
+ {%
+ \ifthenelse{\equal{\faiconscale}{1}}%
+ {\IfBooleanTF{#1}{\faIcon*{#3}}{\faIcon{#3}}}%
+ {\scalebox{\faiconscale}[\faiconscale]{\IfBooleanTF{#1}{\faIcon*{#3}}{\faIcon{#3}}}}%
+ }%
+}
+
+\NewDocumentCommand\faScaled{sO{}m}{%
+ \restoreKV[faIconScaled]%
+ \setKV[faIconScaled]{#2}%
+ \ifboolKV[faIconScaled]{regular}%
+ {%
+ \ifthenelse{\equal{\faiconscale}{1}}%
+ {\IfBooleanTF{#1}{\csname fa#3\endcsname*[regular]}{\csname fa#3\endcsname[regular]}}%
+ {%
+ \scalebox{\faiconscale}[\faiconscale]%
+ {\IfBooleanTF{#1}{\csname fa#3\endcsname*[regular]}{\csname fa#3\endcsname[regular]}}%
+ }%
+ }%
+ {%
+ \ifthenelse{\equal{\faiconscale}{1}}%
+ {\IfBooleanTF{#1}{\csname fa#3\endcsname*}{\csname fa#3\endcsname}}%
+ {%
+ \scalebox{\faiconscale}[\faiconscale]%
+ {\IfBooleanTF{#1}{\csname fa#3\endcsname*}{\csname fa#3\endcsname}}%
+ }%
+ }%
+}
+
+\NewDocumentCommand\DefineFaScale{m}{%
+ \setKVdefault[faIconScaled]{scale=#1}%
+}
+
+\if at hook
+ \RequirePackage{relsize}
+ \AddToHook{cmd/faIcon/before}{\begingroup\smaller}
+ \AddToHook{cmd/faIcon/after}{\endgroup}
+\fi
+
+\endinput
\ No newline at end of file
Property changes on: trunk/Master/texmf-dist/tex/latex/fontawesomescaled/fontawesomescaled.sty
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/Master/tlpkg/bin/tlpkg-ctan-check
===================================================================
--- trunk/Master/tlpkg/bin/tlpkg-ctan-check 2025-08-03 19:06:00 UTC (rev 75959)
+++ trunk/Master/tlpkg/bin/tlpkg-ctan-check 2025-08-03 19:06:53 UTC (rev 75960)
@@ -365,7 +365,7 @@
fn2end fnbreak fncychap fncylab fnpara fnpct fnspe fntproof fnumprint
foekfont foilhtml foliono fonetika
font-change font-change-xetex
- fontawesome fontawesome5 fontawesome6 fontawesome7
+ fontawesome fontawesome5 fontawesome6 fontawesome7 fontawesomescaled
fontaxes fontbook fontch fontinst
fontinstallationguide fontmfizz fontools
fonts-churchslavonic fonts-tlwg
Modified: trunk/Master/tlpkg/libexec/ctan2tds
===================================================================
--- trunk/Master/tlpkg/libexec/ctan2tds 2025-08-03 19:06:00 UTC (rev 75959)
+++ trunk/Master/tlpkg/libexec/ctan2tds 2025-08-03 19:06:53 UTC (rev 75960)
@@ -1798,6 +1798,7 @@
'fenetrecas' => '&POST_onelevel',
'fixme' => '&POSTfixme',
'font-change-xetex' => '&POSTfont_change_xetex',
+ 'fontawesomescaled' => '&POST_onelevel',
'fontsetup' => '&POST_onelevel',
'formation-latex-ul' => '&POSTformation_latex_ul',
'fpl' => '&POSTfpl',
Modified: trunk/Master/tlpkg/tlpsrc/collection-fontsextra.tlpsrc
===================================================================
--- trunk/Master/tlpkg/tlpsrc/collection-fontsextra.tlpsrc 2025-08-03 19:06:00 UTC (rev 75959)
+++ trunk/Master/tlpkg/tlpsrc/collection-fontsextra.tlpsrc 2025-08-03 19:06:53 UTC (rev 75960)
@@ -158,6 +158,7 @@
depend fontawesome5
depend fontawesome6
depend fontawesome7
+depend fontawesomescaled
depend fontmfizz
depend fonts-churchslavonic
depend fontscripts
Added: trunk/Master/tlpkg/tlpsrc/fontawesomescaled.tlpsrc
===================================================================
More information about the tex-live-commits
mailing list.