texlive[75980] Master/texmf-dist: fontawesomescaled (5aug25)

[commits+karl at tug.org]

Revision: 75980
          https://tug.org/svn/texlive?view=revision&revision=75980
Author:   karl
Date:     2025-08-05 22:36:09 +0200 (Tue, 05 Aug 2025)
Log Message:
-----------
fontawesomescaled (5aug25)

Modified Paths:
--------------
    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/fontawesomescaled.sty

Added Paths:
-----------
    trunk/Master/texmf-dist/doc/latex/fontawesomescaled/fontawesomescaled-doc.zip

Modified: trunk/Master/texmf-dist/doc/latex/fontawesomescaled/fontawesomescaled-doc.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/fontawesomescaled/fontawesomescaled-doc.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/fontawesomescaled/fontawesomescaled-doc.tex	2025-08-05 20:35:52 UTC (rev 75979)
+++ trunk/Master/texmf-dist/doc/latex/fontawesomescaled/fontawesomescaled-doc.tex	2025-08-05 20:36:09 UTC (rev 75980)
@@ -16,7 +16,7 @@
 
 \begin{document}
 
-\title{The \textsf{fontawesomescaled} package (0.1.0) -- \today}
+\title{The \textsf{fontawesomescaled} package (0.1.1) -- 04/08/2025}
 \author{%
 	Cédric Pierquet\\%
 	\url{https://github.com/cpierquet/latex-packages/tree/main/fontawesomescaled}%
@@ -25,6 +25,8 @@
 
 This package provides \LaTeX{} support for (automatic) scaling \texttt{fontawesome(s)} icons (\texttt{0.85} by default).
 
+It can also provide \textit{universal} custom aliases compatible with several version of \texttt{fontawesome(s)}
+
 \medskip
 
 To use \texttt{fontawesomescaled} in your document, include the package with |\usepackage{fontawesomescaled}|.
@@ -51,7 +53,7 @@
 \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[hook]{fontawesomescaled}        %\smaller (relsize) usage for \faIcon{...}
 \usepackage[scale=0.925]{fontawesomescaled} %with global scale of 0.925
 \end{Verbatim}
 
@@ -173,6 +175,44 @@
 
 \pagebreak
 
+\subsection{Macro for creating universal alias with \texttt{fa<x>} version}
+
+Some icons have changed names between different versions of \texttt{fontawesome<x>}.
+
+This macro can create \textit{universal} alias with compatibility with different versions of \texttt{fontawesome<x>}.
+
+\begin{Verbatim}[frame=single]
+\CreateAliasFa{<\globalalias>}%
+  [<default value>]%
+  {<fa macro>}%
+  {<f5 macro>}%
+  {<fa6 macro>}%
+  {<fa7 macro>}
+\end{Verbatim}
+
+For example, the \textit{ambulance} is named |\faAmbulance| for \texttt{fa/fa5} and is named |\faTruckMedical| for \texttt{fa6/fa7}.
+
+\begin{Verbatim}[frame=single]
+\CreateAliasFa{\myfaambulance}%
+  [nofa]                %w/o any fa package loaded
+  {\faAmbulance}        %with fa loaded
+  {\faAmbulance}        %with fa5 loaded
+  {\faTruckMedical}     %with fa6 loaded
+  {\faTruckMedical}     %with fa7 loaded
+\end{Verbatim}
+
+\textbf{Result:} |\myfaambulance| will produce :
+
+\begin{itemize}
+	\item w/o \texttt{fontawesome<x>}: \fbox{\raisebox{-\depth}{\includegraphics{testaliaswithout.pdf}}}
+	\item with \texttt{fontawesome}: \fbox{\raisebox{-\depth}{\includegraphics{testaliaswithfa.pdf}}}
+	\item with \texttt{fontawesome5}: \fbox{\raisebox{-\depth}{\includegraphics{testaliaswithfa5.pdf}}}
+	\item with \texttt{fontawesome6}: \fbox{\raisebox{-\depth}{\includegraphics{testaliaswithfa6.pdf}}}
+	\item with \texttt{fontawesome6}: \fbox{\raisebox{-\depth}{\includegraphics{testaliaswithfa7.pdf}}}
+\end{itemize}
+
+\pagebreak
+
 \section{The code}
 
 \fvset{frame=single,numbers=left,numbersep=3pt,fontsize=\footnotesize,breaklines=true}

Added: trunk/Master/texmf-dist/doc/latex/fontawesomescaled/fontawesomescaled-doc.zip
===================================================================
(Binary files differ)

Index: trunk/Master/texmf-dist/doc/latex/fontawesomescaled/fontawesomescaled-doc.zip
===================================================================
--- trunk/Master/texmf-dist/doc/latex/fontawesomescaled/fontawesomescaled-doc.zip	2025-08-05 20:35:52 UTC (rev 75979)
+++ trunk/Master/texmf-dist/doc/latex/fontawesomescaled/fontawesomescaled-doc.zip	2025-08-05 20:36:09 UTC (rev 75980)

Property changes on: trunk/Master/texmf-dist/doc/latex/fontawesomescaled/fontawesomescaled-doc.zip
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Modified: trunk/Master/texmf-dist/tex/latex/fontawesomescaled/fontawesomescaled.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/fontawesomescaled/fontawesomescaled.sty	2025-08-05 20:35:52 UTC (rev 75979)
+++ trunk/Master/texmf-dist/tex/latex/fontawesomescaled/fontawesomescaled.sty	2025-08-05 20:36:09 UTC (rev 75980)
@@ -2,9 +2,10 @@
 % 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]
+\ProvidesPackage{fontawesomescaled}[2025/08/04 0.1.1 Small patchs for fontawesome icons]
 
 %====HISTORY
+% v 0.1.1  Macro for alias fa<x>
 % v 0.1.0  Initial version
 
 %====PACKAGES
@@ -83,10 +84,12 @@
     }%
 }
 
+%====MACRO CHANGE LOCAL SCALE
 \NewDocumentCommand\DefineFaScale{m}{%
   \setKVdefault[faIconScaled]{scale=#1}%
 }
 
+%====MACRO HOOK GLOBAL WITH RELSIZE
 \if at hook
   \RequirePackage{relsize}
   \AddToHook{cmd/faIcon/before}{\begingroup\smaller}
@@ -93,4 +96,14 @@
   \AddToHook{cmd/faIcon/after}{\endgroup}
 \fi
 
+%====MACRO FOR (UNIVERSAL) ALIAS CREATING ?
+\NewDocumentCommand\CreateAliasFa{mO{}mmmm}{%
+  %1 = gen macro / %2 = default / %3 = fa / %4 = fa5 / %5 = fa6 / %6 = fa7
+  \def#1{#2}%
+  \@ifpackageloaded{fontawesome}{\def#1{#3}}{}%
+  \@ifpackageloaded{fontawesome5}{\def#1{#4}}{}%
+  \@ifpackageloaded{fontawesome6}{\def#1{#5}}{}%
+  \@ifpackageloaded{fontawesome7}{\def#1{#5}}{}%
+}
+
 \endinput
\ No newline at end of file