%!TeX root=../tikz-shields-doc.tex
\section{Use logos with \textsf{fontawesome}}

As pointed out in \drawBadge[logo=\faDotCircleO, link=https://github.com/thomas-saigre/tikz-shields/issues/9, baseline=1.8mm]{Issue}{\#9},
there might be some issues of compatibility if a different version of \textsf{fontawesome} is loaded.

This can be set with the option \texttt{fa} when loading the package: \mintinline[breaklines]{tex}{\usepackage[fa=<n>]{tikz-shields}}.
\begin{center}
    \begin{tblr}{
        colspec = {Q[c,m, cmd=\texttt]Q[c,m]Q[c,m]},
        row{1} = {cmd=\textbf, bg=default-blue, fg=white},
        vlines, hlines,
        width = \textwidth,
    }
    \texttt{n} & Package loaded & Note  \\
    0 & None & You can manually load any package you want. \\
    1 & \drawBadge[logo=\ctan, link=https://ctan.org/pkg/fontawesome, baseline=1.8mm]{}{fontawesome} & Default value, used for this document.  \\
    5 & \drawBadge[logo=\ctan, link=https://ctan.org/pkg/fontawesome5, baseline=1.8mm]{}{fontawesome5} &  \\
    6 & \drawBadge[logo=\ctan, link=https://ctan.org/pkg/fontawesome6, baseline=1.8mm]{}{fontawesome6} &  \\
    7 & \drawBadge[logo=\ctan, link=https://ctan.org/pkg/fontawesome7, baseline=1.8mm]{}{fontawesome7} &  \\
    \end{tblr}
\end{center}

With this option comes the definition of macros for the logos, that can be manually changed.
If no logo package is loaded, or if the desired logo is not present in the packages, then these macro are empty:

\begin{center}
    \begin{tblr}{
        colspec = {Q[c,m, cmd=\texttt]Q[c,m]Q[c,m]},
        row{1} = {cmd=\textbf, bg=default-blue, fg=white},
        vlines, hlines,
        width = \textwidth,
    }
    Macro & Description & Example (with \texttt{fa=1})  \\
    \textbackslash tikzshieldGithub & GitHub logo & \tikzshieldGithub \\
    \textbackslash tikzshieldGitlab & GitLab logo & \tikzshieldGitlab \\
    \textbackslash tikzshieldLicence & Balance icon & \tikzshieldLicence \\
    \end{tblr}
\end{center}
