summaryrefslogtreecommitdiff
path: root/graphics/awesomebox/README.md
blob: 97a862fa097702a53612f46939c9b02ae10e25fa (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
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](https://fontawesome.com)
icons to ease the illustration of these blocks.

The idea of admonition blocks comes from the ones you can easily do with
[AsciiDoc](http://asciidoctor.org/docs/user-manual/#admonition).

For more details, please refer to the
[awesomebox.pdf](https://github.com/milouse/latex-awesomebox/blob/master/awesomebox.pdf)
document.

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 usefull 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.

License
=======

Awesome Box is released under the
[WTFPL](http://www.wtfpl.net/txt/copying/). A copy of this license is
distributed in this package.