summaryrefslogtreecommitdiff
path: root/fonts/fontawesome5/doc/fontawesome5.tex
blob: e665fa20dd5e3aa77540a02b2c46d5d5945309ba (plain)
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
\documentclass{scrartcl}
\usepackage{hyperref}
\usepackage{shortvrb}
\usepackage{metalogo}
\usepackage{longtable}
\usepackage{fontawesome5}
\usepackage[utf8]{inputenc}
\usepackage{geometry}
\MakeShortVerb{\|}
\begin{document}
\title{The fontawesome5 package\thanks{This document corresponds to fontawesome5 version 5.9.0, dated 2019/06/07}}
\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 and the |light| style can be used.
Pro is only supported with \XeLaTeX{} and \LuaLaTeX.

\subsection*{Updates}
This package corresponds to Font Awesome 5.9.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}