Awesome Boxes is all about drawing admonition blocks around text to inform or alert your readers about something particular. The specific aim of this package is to use FontAwesome 5 icons to ease the illustration of these blocks.
The idea of admonition blocks comes from the ones you can easily do with AsciiDoc.
For more details, please refer to the awesomebox.pdf document.
If you like my work, you can help me a lot by giving me some tip, either through Liberapay or Paypal. Thank you very much!
Requirements
The following LaTeX packages are required (they should be already included in your LaTeX distribution):
array
fontawesome5
ifthen
xcolor
xparse
Installation
Download the awesomebox.sty
file and put it in the same
folder of the document your are composing.
For system wide installation, please refer to the documentation of your LaTeX distribution.
Compatibility
This repository also hosts the package
awesomebox-compat
, which depends on the
fontawesome
package, instead of fontawesome5
.
Apart from that, it has the exact same features set.
This can be useful for you if you want to use it with an old LaTeX
distribution, which does not embed fontawesome5
yet (like
Overleaf system). To use it, download the file
awesomebox-compat.sty
in this repository, put it near your
tex files and just replace your \usepackage{awesomebox}
instruction by \usepackage{awesomebox-compat}
.
Be aware that icon names changes between FontAwesome and FontAwesome5 and thus using the compatibility package may break your current files. FontAwesome also requires you to use XeLaTeX or LuaTeX: you cannot use PDFLaTeX with the compatibility package.
Contribution
See CONTRIBUTING file.
License
Awesome Box is released under the WTFPL. A copy of this license is distributed in this package.