summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/fonts/fontawesome5
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2019-06-07 21:06:52 +0000
committerKarl Berry <karl@freefriends.org>2019-06-07 21:06:52 +0000
commit2aaf1c424a597d028346460500be0549ae136432 (patch)
tree6680d7f6ec9889448ab8264436a7ea9eb0e35f04 /Master/texmf-dist/doc/fonts/fontawesome5
parent270a8309e5c8563d1b8802752bb4f9da84a072c4 (diff)
fontawesome5 (7jun19)
git-svn-id: svn://tug.org/texlive/trunk@51339 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/fonts/fontawesome5')
-rw-r--r--Master/texmf-dist/doc/fonts/fontawesome5/fontawesome5.pdfbin162833 -> 695310 bytes
-rw-r--r--Master/texmf-dist/doc/fonts/fontawesome5/fontawesome5.tex14
-rw-r--r--Master/texmf-dist/doc/fonts/fontawesome5/fulllist.tex100
3 files changed, 110 insertions, 4 deletions
diff --git a/Master/texmf-dist/doc/fonts/fontawesome5/fontawesome5.pdf b/Master/texmf-dist/doc/fonts/fontawesome5/fontawesome5.pdf
index 22645fc1df9..de83e4bbcf4 100644
--- a/Master/texmf-dist/doc/fonts/fontawesome5/fontawesome5.pdf
+++ b/Master/texmf-dist/doc/fonts/fontawesome5/fontawesome5.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/fonts/fontawesome5/fontawesome5.tex b/Master/texmf-dist/doc/fonts/fontawesome5/fontawesome5.tex
index 596e0c2dcc7..e665fa20dd5 100644
--- a/Master/texmf-dist/doc/fonts/fontawesome5/fontawesome5.tex
+++ b/Master/texmf-dist/doc/fonts/fontawesome5/fontawesome5.tex
@@ -2,11 +2,13 @@
\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.8.0, dated 2019/03/20}}
+\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.
@@ -19,13 +21,15 @@ 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\footnote{For a full list see \url{https://fontawesome.com/cheatsheet}.} converted to CamelCase with the prefix |\fa|.
+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 with |\faIcon{the-icon-name}| or |\faIcon[style]{...}|.
+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}
@@ -65,7 +69,7 @@ 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.8.0.
+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}
@@ -77,4 +81,6 @@ 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}
diff --git a/Master/texmf-dist/doc/fonts/fontawesome5/fulllist.tex b/Master/texmf-dist/doc/fonts/fontawesome5/fulllist.tex
new file mode 100644
index 00000000000..071dd165b44
--- /dev/null
+++ b/Master/texmf-dist/doc/fonts/fontawesome5/fulllist.tex
@@ -0,0 +1,100 @@
+\ExplSyntaxOn
+\msg_new:nnnn {fontawesome5} {list/no-shorthand} {No~shorthand~defined~for~icon~#1.} {
+ It~looks~like~#1~need~special~handling~in~fulllist.tex~but~there~are~
+ no~appropriate~definitions.~Ask~a~wizard~to~add~#1~to~fulllist.tex~to~
+ fix~this.
+}
+\tl_new:N \g__fontawesome_last_name_tl
+\tl_new:N \g__fontawesome_last_cs_tl
+\prg_new_protected_conditional:Nnn \__fontawesome_if_regular_style:nn {T} {
+ \str_if_eq:nnTF {#1} {free3} {
+ \prg_return_false:
+ }
+ {
+ \group_begin:
+ \usefont{U}{fontawesome#1}{regular}{n}
+ \iffontchar\font#2
+ \group_insert_after:N \prg_return_true:
+ \else:
+ \group_insert_after:N \prg_return_false:
+ \fi:
+ \group_end:
+ }
+}
+\tracingonline1
+\showboxdepth\maxdimen
+\showboxbreadth\maxdimen
+\cs_new:Nn\__fontawesome_list_show_icon:nnnn{
+ \str_if_in:nnT{#3}{brands}{
+ \hfilneg\vbox to0.875em{\vfil\hbox to0pt{\hss\tiny\faTrademark\quad}\vfil}\hfil
+ }
+ \faIcon{#2}&\texttt{\textbackslash#1}&\texttt{\textbackslash faIcon\{#2\}}
+ \str_if_in:nnT{#3}{free}{
+ \__fontawesome_if_regular_style:nnT {#3} {#4} {
+ \\\faIcon[regular]{#2}&\texttt{\textbackslash#1[regular]}&\texttt{\textbackslash faIcon[regular]\{#2\}}
+ }
+ }
+ \tl_gset:Nn \g__fontawesome_last_cs_tl {#1}
+ \tl_gset:Nn \g__fontawesome_last_name_tl {#2}
+ \\
+}
+\cs_generate_variant:Nn \__fontawesome_list_show_icon:nnnn { fnnn }
+\cs_set:Nn\__fontawesome_def_icon:nnnnn{
+ \__fontawesome_list_show_icon:fnnn{
+ \tl_if_empty:nTF{#1}{
+ \str_if_eq:noTF{#2}{\g__fontawesome_last_name_tl-alt}{
+ \g__fontawesome_last_cs_tl*
+ }{
+ \cs_if_exist_use:cF {__fontawesome_list_real_cs_#2_tl} {
+ \msg_expandable_error:nnn {fontawesome5} {list/no-shorthand} {#2}
+ }
+ }
+ }{
+ \cs_to_str:N #1 % You might have noticed that #1 is a n-type argument, not N-type.
+ % This is not a mistake, the argument might contain additional characters after the initial cs
+ % which is passed to \cs_to_str:N
+ }
+ }{#2}{#3}{#4}
+}
+% Some icons are special for some reason. See fontawesome5.sty if you want to know why
+% they are singled out.
+\tl_const:cn{__fontawesome_list_real_cs_wifi_tl}{faWifi}
+\tl_const:cn{__fontawesome_list_real_cs_dice-d20_tl}{faDiceD20}
+\tl_const:cn{__fontawesome_list_real_cs_dice-d6_tl}{faDiceD6}
+\tl_const:cn{__fontawesome_list_real_cs_signal_tl}{faSignal}
+%
+\tl_const:cn{__fontawesome_list_real_cs_500px_tl}{faIcon\{500px\}}
+\tl_const:cn{__fontawesome_list_real_cs_arrows-alt_tl}{faArrows*}
+\tl_const:cn{__fontawesome_list_real_cs_cloud-download-alt_tl}{faCloudDownload*}
+\tl_const:cn{__fontawesome_list_real_cs_cloud-upload-alt_tl}{faCloudUpload*}
+\tl_const:cn{__fontawesome_list_real_cs_exchange-alt_tl}{faExchange*}
+\tl_const:cn{__fontawesome_list_real_cs_expand-arrows-alt_tl}{faExpandArrows*}
+\tl_const:cn{__fontawesome_list_real_cs_external-link-alt_tl}{faExternalLink*}
+\tl_const:cn{__fontawesome_list_real_cs_external-link-square-alt_tl}{faExternalLinkSquare*}
+\tl_const:cn{__fontawesome_list_real_cs_level-down-alt_tl}{faLevelDown*}
+\tl_const:cn{__fontawesome_list_real_cs_level-up-alt_tl}{faLevelUp*}
+\tl_const:cn{__fontawesome_list_real_cs_pencil-alt_tl}{faPencil*}
+\tl_const:cn{__fontawesome_list_real_cs_shield-alt_tl}{faShield*}
+\tl_const:cn{__fontawesome_list_real_cs_sign-in-alt_tl}{faSignIn*}
+\tl_const:cn{__fontawesome_list_real_cs_sign-out-alt_tl}{faSignOut*}
+\tl_const:cn{__fontawesome_list_real_cs_square-root-alt_tl}{faSquareRoot*}
+\tl_const:cn{__fontawesome_list_real_cs_tachometer-alt_tl}{faTachometer*}
+\tl_const:cn{__fontawesome_list_real_cs_ticket-alt_tl}{faTicket*}
+%
+\tl_const:cn{__fontawesome_list_real_cs_compress-arrows-alt_tl}{faCompressArrows*}
+\ExplSyntaxOff
+\newgeometry{textwidth=18cm}
+\subsection*{Full~icon~list~for~FontAwesome~5~Free}
+All icons marked with \vbox to0.875em{\vfil\hbox{\hss\tiny\faTrademark}\vfil} are brand icons.
+\begin{quote}
+ All brand icons are trademarks of their respective owners. The use of these
+ trademarks does not indicate endorsement of the trademark holder by Font
+ Awesome, nor vice versa. \emph{Please do not use brand logos for any purpose except
+ to represent the company, product, or service to which they refer.}
+\end{quote}
+\ExplSyntaxOn
+\begin{longtable}{cll}
+ \cs:w @@input\cs_end: fontawesome5-mapping.def~
+\end{longtable}
+\ExplSyntaxOff
+\restoregeometry