1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
|
\documentclass{scrartcl}
\usepackage{hyperref}
\usepackage{shortvrb}
\usepackage{metalogo}
\usepackage{longtable}
\usepackage{fontawesome5}
% \usepackage{xcolor}
% \usepackage[pro]{fontawesome5}
% \faStyle{duotone}
\usepackage[utf8]{inputenc}
\usepackage{geometry}
\MakeShortVerb{\|}
\begin{document}
\title{The fontawesome5 package\thanks{This document corresponds to fontawesome5 version 5.13.0, dated 2020/03/24}}
\author{Font Awesome\thanks{More information at \url{https://fontawesome.com}} (The font)\and Marcel Krüger\thanks{E-Mail: \href{mailto:tex@2krueger.de}{\nolinkurl{tex@2krueger.de}}} (The \LaTeX{} package)}
\maketitle
This package provides \LaTeX{} support for the Font Awesome 5 icons.
To use Font Awesome 5 icons in your document, include the package with
\begin{verbatim}
\usepackage{fontawesome5}
\end{verbatim}
Alternatively you can add the |fixed| option to get fixed-width icons:
\begin{verbatim}
\usepackage[fixed]{fontawesome5}
\end{verbatim}
For every icon a macro is provided: Just use the official icon names converted to CamelCase with the prefix |\fa|.
For example to use the |hand-point-up| icon, use |\faHandPointUp|.
For icons ending with |-alt|, append a |*| instead.
An optional argument can be added to select the style (|solid| or |regular|).
The default style is |solid|, it can be changed with |\faStyle{...}|
Every icon can also be accessed using the official icon name. To do this, you can use |\faIcon{the-icon-name}| or |\faIcon[style]{the-icon-name}|.
A list of all included icons with their respective commands can be found at the end of this document.
\subsection*{Example}
\begin{verbatim}
...
\usepackage{fontawesome5}
...
\begin{document}
...
A simple icon: \faHandPointUp\\
Multiple versions of the file icon:
\faFile~
\faFile*~
\faFile[regular]~
\faFile*[regular].\\
Alternative syntax:
\faIcon{file}~
\faIcon*{file}~
\faIcon[regular]{file}~
\faIcon*[regular]{file}.
...
\end{document}
\end{verbatim}
A simple icon: \faHandPointUp\\
Multiple versions of the file icon: \faFile~\faFile*~\faFile[regular]~\faFile*[regular].\\
Alternative syntax: \faIcon{file}~\faIcon*{file}~\faIcon[regular]{file}~\faIcon*[regular]{file}.
\subsection*{Font Awesome Pro}
Font Awesome 5 is available in a Free and a Pro version.
This package uses the free version by default.
If you own a Pro license and have the Font Awesome 5 Pro desktop fonts installed in your system font path, you can use Pro instead.
For this, load the package with the |[pro]| option:
\begin{verbatim}
\usepackage[pro]{fontawesome5}
\end{verbatim}
Now additional icons, the |duotone| and the |light| style can be used.
The second color for |duotone| icons can be set though |\faDuotoneSetSecondary|:
\begin{verbatim}
\faDuotoneSetSecondary{green}% From here on, the secondary layer
% will be green.
\end{verbatim}
Pro is only supported with \XeLaTeX{} and \LuaLaTeX.
\subsection*{Updates}
This package corresponds to Font Awesome 5.13.0.
In case there is a newer version available on the Font Awesome homepage, check for updates on \url{https://ctan.org/pkg/fontawesome5}. Should there be no corresponding update on CTAN, you can write a mail to \href{mailto:tex@2krueger.de}{\nolinkurl{tex@2krueger.de}}.
If you use \XeLaTeX{} or \LuaLaTeX{}, you can also directly download the new Desktop Fonts from \url{https://fontawesome.com} into your \TeX{} tree. If you save them with the filenames\\
{\ttfamily\begin{tabular}{l}
FontAwesome5Brands-Regular-400.otf\\
FontAwesome5Free-Regular-400.otf\\
FontAwesome5Free-Solid-900.otf
\end{tabular}}\\
the package will start using the new version right away.
\subsection*{Bugs}
For bug reports and feature requests, write to \href{mailto:tex@2krueger.de}{\nolinkurl{tex@2krueger.de}}.
\input{fulllist}
\end{document}
|
