summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/awesomebox/README
blob: a27913d846d4791d2c4a7f8b69c0a5ae52857059 (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
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¹ icons to ease the
illustration of these blocks.

This means all the magic of this package only exists if you previously
installed FontAwesome on your system and made it available for use with
XeTeX. Yes, this package requires you to use XeLaTeX too.

The idea of admonition blocks comes from the ones you can easily do with
AsciiDoc².

We use the previous work of Honza Ustohal on fontawesome.sty³ to build
this package. However, we made two important modifications:

 1. we rename the internal commands of fontawesome.sty from \fa to
    \abIcon and the \FA font switch to \ABFamily to avoid collision if
    you want to use both of them;
 2. we remove most of the provided icons to only kept the one we really
    use in this package.

For more details, please refer to the awesomebox.pdf document.

¹ http://fontawesome.io/icons/
² http://asciidoctor.org/docs/user-manual/#admonition
³ https://gist.github.com/sway/3101743
⁴ https://github.com/milouse/latex-awesomebox/blob/master/awesomebox.pdf

* Requirements

 - a working XeLaTeX environment
 - the ifxetex, ifluatex, xltxtra, xcolor and tabularx LaTeX packages
 - FontAwesome (http://fontawesome.io/icons/)

* 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
XeLaTeX distribution.

* License

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