awesomebox (26nov18)

git-svn-id: svn://tug.org/texlive/trunk@49256 c570f23f-e606-0410-a88d-b1316a301751

4 files changed, 248 insertions, 160 deletions

diff --git a/Master/texmf-dist/doc/latex/awesomebox/README.md b/Master/texmf-dist/doc/latex/awesomebox/README.md
index c66ed3c1e28..47582479b91 100644
--- a/Master/texmf-dist/doc/latex/awesomebox/README.md
+++ b/Master/texmf-dist/doc/latex/awesomebox/README.md
@@ -1,26 +1,11 @@
 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](http://fontawesome.io/icons/) 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.
+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).
 
-We use the previous work of Honza Ustohal on
-[fontawesome.sty](https://gist.github.com/sway/3101743) 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](https://github.com/milouse/latex-awesomebox/blob/master/awesomebox.pdf)
 document.
@@ -28,10 +13,12 @@ document.
 Requirements
 ============
 
--   a working XeLaTeX environment
--   the `ifxetex`, `ifluatex`, `xltxtra`, `xcolor` and `tabularx` LaTeX
-    packages
--   [FontAwesome](http://fontawesome.io/icons/)
+The following LaTeX packages are required (they should be already
+included in your LaTeX distribution):
+
+-   `fontawesome5`
+-   `xcolor`
+-   `tabu`
 
 Installation
 ============
@@ -40,7 +27,7 @@ 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.
+LaTeX distribution.
 
 License
 =======
diff --git a/Master/texmf-dist/doc/latex/awesomebox/awesomebox.pdf b/Master/texmf-dist/doc/latex/awesomebox/awesomebox.pdf
index aa26ad521a8..1f21f7fc6e5 100644
--- a/Master/texmf-dist/doc/latex/awesomebox/awesomebox.pdf
+++ b/Master/texmf-dist/doc/latex/awesomebox/awesomebox.pdf
diff --git a/Master/texmf-dist/doc/latex/awesomebox/awesomebox.tex b/Master/texmf-dist/doc/latex/awesomebox/awesomebox.tex
index 6410cb2ace0..809c9c43694 100644
--- a/Master/texmf-dist/doc/latex/awesomebox/awesomebox.tex
+++ b/Master/texmf-dist/doc/latex/awesomebox/awesomebox.tex
@@ -3,6 +3,7 @@
 \usepackage{awesomebox}
 \setlength{\aweboxvskip}{0pt}
 
+\usepackage{xltxtra}
 \defaultfontfeatures{Scale=MatchLowercase}
 \setmonofont[Mapping=tex-text,Scale=0.9]{Inconsolata}
 \setromanfont[Mapping=tex-text]{Linux Libertine O}
@@ -11,12 +12,15 @@
 \usepackage{polyglossia}
 \setdefaultlanguage{english}
 
+% Comment out the lines above and uncomment the following lines to test
+% usage with pdflatex
+%\usepackage[utf8]{inputenc}
+%\usepackage[T1]{fontenc}
+%\usepackage[english,frenchb]{babel}
+
 \usepackage[vmargin=2cm,hmargin=3cm,includeheadfoot=true]{geometry}
 \linespread{1.2}
 
-\def\abIconRocket{\symbol{"F135}}
-\def\abIconHeart{\symbol{"F004}}
-
 \newcommand{\cf}[1]{(\emph{cf.} section \ref{#1}, %
   <<\,\nameref{#1}\,>>, p. \pageref{#1})}
 
@@ -24,7 +28,7 @@
 \newcommand{\colophon}{
   ~\vfill
   \begin{center}
-    \scriptsize Prepared with {\ABFamily\abIconHeart} from Nantes,
+    \scriptsize Prepared with \faHeart{} from Nantes,
     France\\
     Awesome Box is released under the
     \hrefcolor{http://www.wtfpl.net/txt/copying/}{WTFPL}. A copy of this
@@ -47,7 +51,7 @@
 
 \title{Awesome Boxes}
 \author{Étienne Deparis}
-\date{2018-01-31 v0.2}
+\date{2018-11-26 v0.4}
 
 \begin{document}
 
@@ -58,48 +62,12 @@
 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
-\hrefcolor{http://fontawesome.io/icons/}{FontAwesome} icons to ease the
+\hrefcolor{https://fontawesome.com/}{FontAwesome 5} icons to ease the
 illustration of these boxes.
 
-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 require you to use \XeLaTeX\ too.
-
 The idea of admonition blocks comes from the ones you can easily do with
 \hrefcolor{http://asciidoctor.org/docs/user-manual/\#admonition}{AsciiDoc}.
 
-We use the previous work of Honza Ustohal on
-\hrefcolor{https://gist.github.com/sway/3101743}{fontawesome.sty} to
-build this package. However, we made two important modifications:
-
-\begin{enumerate}
-\item we rename the internal commands of \texttt{fontawesome.sty} from
-  \texttt{\textbackslash{}fa} to \texttt{\textbackslash{}abIcon} and the
-  \texttt{\textbackslash{}FA} font switch to
-  \texttt{\textbackslash{}ABFamily} to avoid collision if you want to
-  use both of them;
-\item we remove most of the provided icons to only kept the one we
-  really use in this package. We'll see later how to add back some of
-  them \cf{sec:new-icons}.
-\end{enumerate}
-
-Therefore, the only symbols we kept are the following:
-
-\begin{description}
-  \item[{\ABFamily\abIconCheck}] \verb!\ABFamily\abIconCheck!
-  \item[{\ABFamily\abIconInfoCircle}] \verb!\ABFamily\abIconInfoCircle!
-  \item[{\ABFamily\abIconFire}] \verb!\ABFamily\abIconFire!
-  \item[{\ABFamily\abIconExclamationCircle}] \verb!\ABFamily\abIconExclamationCircle!
-  \item[{\ABFamily\abIconExclamationTriangle}] \verb!\ABFamily\abIconTriangle!
-  \item[{\ABFamily\abIconCogs}] \verb!\ABFamily\abIconCogs!
-  \item[{\ABFamily\abIconThumbsUp}] \verb!\ABFamily\abIconThumbsUp!
-  \item[{\ABFamily\abIconThumbsDown}] \verb!\ABFamily\abIconThumbsDown!
-  \item[{\ABFamily\abIconCertificate}] \verb!\ABFamily\abIconCertificate!
-  \item[{\ABFamily\abIconLightBulb}] \verb!\ABFamily\abIconLightBulb!
-  \item[{\ABFamily\abIconTwitter}] \verb!\ABFamily\abIconTwitter!
-  \item[{\ABFamily\abIconGithub}] \verb!\ABFamily\abIconGithub!
-\end{description}
-
 \section{How to use it?}
 
 Just download this package and call it at the beginning of your
@@ -110,6 +78,7 @@ document:
 \end{center}
 
 \section{Provided boxes}
+\subsection{Inline boxes}
 
 The provided boxes follow the name convention of the
 \hrefcolor{http://asciidoctor.org/docs/user-manual/\#admonition}{admonition
@@ -126,6 +95,8 @@ The provided boxes follow the name convention of the
   dictum felis. Pellentesque tortor lacus, semper et neque vitae,
   egestas commodo nisl.}
 
+\clearpage
+
 \begin{center}
 \verb!\tipbox{Lorem ipsum…}!
 \end{center}
@@ -137,8 +108,6 @@ The provided boxes follow the name convention of the
   dictum felis. Pellentesque tortor lacus, semper et neque vitae,
   egestas commodo nisl.}
 
-\clearpage
-
 \begin{center}
 \verb!\warningbox{Lorem ipsum…}!
 \end{center}
@@ -172,74 +141,128 @@ The provided boxes follow the name convention of the
   dictum felis. Pellentesque tortor lacus, semper et neque vitae,
   egestas commodo nisl.}
 
+\subsection{Environments}
+\label{sec:environments}
+
+You can also insert admonition blocks with an environment syntax. The
+same names can be used, but with a \emph{block} suffixe.
+
+\begin{verbatim}
+\begin{noteblock}
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nam
+aliquet libero quis lectus elementum fermentum.
+\end{noteblock}
+\end{verbatim}
+
+
+For the exactly same rendering:
+
+\vspace{5mm}
+
+\begin{noteblock}
+  Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nam aliquet
+  libero quis lectus elementum fermentum.
+
+  Fusce aliquet augue sapien, non efficitur mi ornare sed. Morbi at
+  dictum felis. Pellentesque tortor lacus, semper et neque vitae,
+  egestas commodo nisl.
+\end{noteblock}
+
 \section{How to add new icons?}
 \label{sec:new-icons}
 
-If you look at the \texttt{awesomebox.sty} source code, you'll see that
-the current icons are declared using the following command:
-\verb!\def\abIconFire{\symbol{"F06D}}!.
-
-As you can see, adding a new icon is as simple as creating a new
-\verb!\def! command with the right hexadecimal code. These codes can be
-found on the \hrefcolor{http://fontawesome.io/cheatsheet/}{FontAwesome
-  cheatsheet}. All you have to do is to convert the provided html-entity
-to the \TeX\ compatible code.
+This package use the
+\hrefcolor{https://www.ctan.org/pkg/fontawesome5}{FontAwesome5 package}
+under the hood. In order to use your own icons, just call the proper
+\verb!\faXxx! command.
 
 For example, if you want to add the \emph{rocket} icon
-({\ABFamily\abIconRocket}), you have to translate \verb![&#xf135;]! to
-\texttt{"F135}. And that's it:
-\verb!\def\abIconRocket{\symbol{"F135}}!.
-
-You can put this new \verb!\def! command at the beginning of your
-document, just before the \verb!\begin{document}! for exemple.
+(\faRocket), you just have to  insert \verb!\faRocket!.
 
 \section{How to create your own box?}
+\label{sec:howtoown}
+\subsection{Inline boxes}
 
 To create your own box, with your own colour, your own icon or your own
 rule width, you can use our meta command:
 
 \begin{center}
-\verb!\awesomebox{icon}{rulewidth}{color}{your text content}!
+\verb!\awesomebox[rulecolor]{rulewidth}{icon}{iconcolor}{your text content}!
 \end{center}
 
-\clearpage
+Here are some examples of custom boxes:
 
 \begin{center}
-\verb!\awesomebox{\abIconCertificate}{5pt}{magenta}{Lorem ipsum…}!
+\verb!\awesomebox{5pt}{\faCertificate}{magenta}{Lorem ipsum…}!
 \end{center}
 
-\awesomebox{\abIconCertificate}{5pt}{magenta}{Lorem ipsum dolor sit
-  amet, consectetur adipiscing elit. Nam aliquet libero quis lectus
-  elementum fermentum.
+\awesomebox{5pt}{\faCertificate}{magenta}{Lorem ipsum dolor sit amet,
+  consectetur adipiscing elit. Nam aliquet libero quis lectus elementum
+  fermentum.
 
   Fusce aliquet augue sapien, non efficitur mi ornare sed. Morbi at
   dictum felis. Pellentesque tortor lacus, semper et neque vitae,
   egestas commodo nisl.}
 
 \begin{center}
-\verb!\awesomebox{\abIconCogs}{0pt}{black}{Lorem ipsum…}!
+\verb!\awesomebox{0pt}{\faCogs}{black}{Lorem ipsum…}!
 \end{center}
 
-\awesomebox{\abIconCogs}{0pt}{black}{Lorem ipsum dolor sit amet,
-  consectetur adipiscing elit. Nam aliquet libero quis lectus elementum
-  fermentum.
+\begin{awesomeblock}{0pt}{\faCogs}{black}
+  Lorem ipsum dolor sit amet, consectetur
+  adipiscing elit. Nam aliquet libero quis lectus elementum fermentum.
 
   Fusce aliquet augue sapien, non efficitur mi ornare sed. Morbi at
   dictum felis. Pellentesque tortor lacus, semper et neque vitae,
-  egestas commodo nisl.}
+  egestas commodo nisl.
+\end{awesomeblock}
 
 \begin{center}
-\verb!\awesomebox{\abIconRocket}{2pt}{violet}{Lorem ipsum…}!
+\verb!\awesomebox[violet]{2pt}{\faRocket}{violet}{Lorem ipsum…}!
 \end{center}
 
-\awesomebox{\abIconRocket}{2pt}{violet}{Lorem ipsum dolor sit
-  amet, consectetur adipiscing elit. Nam aliquet libero quis lectus
-  elementum fermentum.
+\awesomebox[violet]{2pt}{\faRocket}{violet}{Lorem ipsum dolor sit amet,
+  consectetur adipiscing elit. Nam aliquet libero quis lectus elementum
+  fermentum.
 
   Fusce aliquet augue sapien, non efficitur mi ornare sed. Morbi at
   dictum felis. Pellentesque tortor lacus, semper et neque vitae,
   egestas commodo nisl.}
 
+\subsection{Environments}
+
+To create your own box, with your own colour, your own icon or your own
+rule width, you can use our meta command:
+
+\begin{verbatim}
+\begin{awesomeblock}[rulecolor]{rulewidth}{icon}{iconcolor}
+  your text content
+\end{awesomeblock}
+\end{verbatim}
+
+For example, we can rewrite the first previous example as:
+
+\begin{verbatim}
+\begin{awesomeblock}[magenta]{5pt}{\faCertificate}{magenta}
+  Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nam aliquet
+  libero quis lectus elementum fermentum.
+\end{awesomeblock}
+\end{verbatim}
+
+Which will render this way:
+
+\vspace{5mm}
+
+\begin{awesomeblock}[magenta]{5pt}{\faCertificate}{magenta}
+  Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nam aliquet
+  libero quis lectus elementum fermentum.
+
+  Fusce aliquet augue sapien, non efficitur mi ornare sed. Morbi at
+  dictum felis. Pellentesque tortor lacus, semper et neque vitae,
+  egestas commodo nisl.
+\end{awesomeblock}
+
+
 \section{Other options}
 
 Finally, you can also modify some internal options in order to modify
@@ -259,7 +282,7 @@ with (5mm is the default): \verb!\setlength{\aweboxvskip}{5mm}!.
 \subsection{Sign raise}
 
 This length is used to raise (or lower) the left icon. Its default value
-is −5mm and you can change it with:
+is -5mm and you can change it with:
 \verb!\setlength{\aweboxsignraise}{-5mm}!.
 
 \subsection{Rule width}
@@ -268,7 +291,15 @@ This width is used for the vertical rule of our four default boxes. Its
 default value is 2pt and you can change it with:
 \verb!\setlength{\aweboxrulewidth}{2pt}!.
 
-\section{In other environments}
+\subsection{Rule default color}
+
+The rule color is an optional argument passed to the commands or
+environments. Its default value is the following (to match the one
+defined by AsciiDoctor) and you can change it this way:
+
+\verb!\definecolor{abvrulecolor}{RGB}{221,221,216}!
+
+\section{With other environments}
 
 Awesome boxes may be used in any other environments, like in a list.
 
@@ -280,12 +311,67 @@ Awesome boxes may be used in any other environments, like in a list.
 \end{itemize}
 \end{verbatim}
 
+will give:
+
 \begin{itemize}
 \item My first item
 \item My second item with \notebox{A note box!}
 \item Last and finally
 \end{itemize}
 
+It may contain other environments too, but in that case, you should
+prefer the environment API (see Section \ref{sec:environments}):
+
+\begin{verbatim}
+\begin{importantblock}
+  \begin{itemize}
+  \item My first item
+  \item My second item with \notebox{A note box!}
+  \item Last and finally
+  \end{itemize}
+\end{importantblock}
+\end{verbatim}
+
+will give:
+
+\vspace{5mm}
+
+\begin{importantblock}
+  \begin{itemize}
+  \item My first item
+  \item My second item with \notebox{A note box!}
+  \item Last and finally
+  \end{itemize}
+\end{importantblock}
+
+\section{Breaking changes}
+
+The version 0.4 of this package introduces a way to customize the rule
+color. Thus, the commands and environments arguments have been
+reorganized to be in a more logical order.
+
+Historically, the \verb!\awesomebox! command used the following syntax:
+
+\begin{center}
+\verb!\awesomebox{icon}{rulewidth}{iconcolor}{your text content}!
+\end{center}
+
+This syntax will now leads to compiling errors, as you must now write it
+as the following example show you (and as explained in the Section
+\ref{sec:howtoown} "\nameref{sec:howtoown}"), to avoid an alternate
+declaration of rule and icon options:
+
+\begin{center}
+\verb!\awesomebox[rulecolor]{rulewidth}{icon}{iconcolor}{your text content}!
+\end{center}
+
+If you only use the provided boxes and environments (the
+\verb!\notebox!, \verb!\tipbox!, \verb!\warningbox!, \verb!\cautionbox!,
+and \verb!\importantbox! or the \texttt{noteblock}, \texttt{tipblock},
+\texttt{cautionblock}, \texttt{warningblock}, \texttt{importantblock}
+environment) you are not affected by this change and your documents will
+work without any change.
+
 \colophon
 
 \end{document}
diff --git a/Master/texmf-dist/tex/latex/awesomebox/awesomebox.sty b/Master/texmf-dist/tex/latex/awesomebox/awesomebox.sty
index d14b1e667a2..7db70cbaf66 100644
--- a/Master/texmf-dist/tex/latex/awesomebox/awesomebox.sty
+++ b/Master/texmf-dist/tex/latex/awesomebox/awesomebox.sty
@@ -1,64 +1,46 @@
 \NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{awesomebox}[2018/01/31 v0.2]
+\ProvidesPackage{awesomebox}[2018/11/26 v0.4]
 
 % Awesome Box has been written by Étienne Deparis and is released under
 % the WTFPL (http://www.wtfpl.net/txt/copying/).
 % A copy of this license is distributed in this package.
-
-
-\RequirePackage{ifxetex,ifluatex}
-\newif\ifawesomebox@notxetex\awesomebox@notxetextrue
-\ifxetex
-  \awesomebox@notxetexfalse
-\else
-  \ifluatex
-    \awesomebox@notxetexfalse
-  \fi
-\fi
-
-\ifawesomebox@notxetex
-\PackageError{awesomebox}{%
-  You are trying to use awesomebox\MessageBreak
-  with something else than xelatex or luatex
-}{%
-  Please abort now with <ctrl+d>
-}
-\fi
-
-% This package heavily uses the work of Honza Ustohal, known under the
-% name FontAwesome bindings for (Xe)LaTeX:
-% https://gist.github.com/sway/3101743
-%
-% Translation of FontAwesome's private range characters into XeTeX
-% symbols. All icons are camel-cased and prefixed with 'abIcon', i.e. what
-% was .icon-align-center the CSS version of FontAwesome becomes
-% \abIconAlignCenter
 %
-% New icons code could be retrieve from this page
-% http://fontawesome.io/cheatsheet/
-
-\def\abIconCheck{\symbol{"F00C}}
-\def\abIconInfoCircle{\symbol{"F05A}}
-\def\abIconFire{\symbol{"F06D}}
-\def\abIconExclamationCircle{\symbol{"F06A}}
-\def\abIconExclamationTriangle{\symbol{"F071}}
-\def\abIconCogs{\symbol{"F085}}
-\def\abIconThumbsUp{\symbol{"F087}}
-\def\abIconThumbsDown{\symbol{"F088}}
-\def\abIconCertificate{\symbol{"F0A3}}
-\def\abIconLightBulb{\symbol{"F0EB}}
-\def\abIconTwitter{\symbol{"F099}}
-\def\abIconGithub{\symbol{"F09B}}
-
-\RequirePackage{xltxtra}
-\newfontfamily{\ABFamily}{FontAwesome}
-
-% Some basic colors
+% Contributors:
+% v0.2: Vincent Goulet https://github.com/vigou3
+% v0.3: Gilbert Fuerer https://github.com/foreachthing
+% * Remove xelatex/luatex requirement and add pdflatex compatibility
+% v0.4: Marcel Krüger https://github.com/zauguin
+% * Fontawesome5 compatibility
+% Gilbert Fuerer
+% * Custom rule color
+
+
+% Try to just depend on fontawesome5 package
+% https://ctan.org/pkg/fontawesome5
+\RequirePackage{fontawesome5}
+
+% Compatibility with old version of this package
+\def\abIconCheck{\faCheck}
+\def\abIconInfoCircle{\faInfoCircle}
+\def\abIconFire{\faFire}
+\def\abIconExclamationCircle{\faExclamationCircle}
+\def\abIconExclamationTriangle{\faExclamationTriangle}
+\def\abIconCogs{\faCogs}
+\def\abIconThumbsUp{\faThumbsUp}
+\def\abIconThumbsDown{\faThumbsDown}
+\def\abIconCertificate{\faCertificate}
+\def\abIconLightBulb{\faLightbulb[regular]}
+\def\abIconTwitter{\faTwitter}
+\def\abIconGithub{\faGithub}
+
+% https://ctan.org/pkg/xcolor
 \RequirePackage{xcolor}
+% Some basic colors
 \definecolor{abnote}{RGB}{25,64,122}
 \definecolor{abcaution}{RGB}{188,50,0}
 \definecolor{abwarning}{RGB}{188,103,0}
 \definecolor{abimportant}{RGB}{188,0,0}
+\definecolor{abvrulecolor}{RGB}{221,221,216}
 
 \newlength{\aweboxleftmargin}
 \setlength{\aweboxleftmargin}{9mm}
@@ -69,30 +51,63 @@
 \newlength{\aweboxrulewidth}
 \setlength{\aweboxrulewidth}{2pt}
 
-\RequirePackage{tabularx}
+% https://ctan.org/pkg/tabu
+\RequirePackage{tabu}
 
-% \awesomebox{icon}{rulewidth}{color}{content}
-\newcommand{\awesomebox}[4]{%
+% Commands API
+% \awesomebox[rulecolor]{rulewidth}{icon}{iconcolor}{content}
+\newcommand{\awesomebox}[5][abvrulecolor]{%
   \vspace{\aweboxvskip}
   \noindent
-  \begin{tabularx}{\linewidth}{%
-      m{\aweboxleftmargin}!{\color{#3}\vrule width #2}X}
-    \raisebox{\aweboxsignraise}{\textcolor{#3}{\Huge\ABFamily#1}} & #4 \\
-  \end{tabularx}
+  \begin{tabu} to \linewidth
+    {m{\aweboxleftmargin}!{\color{#1}\vrule width #2}X}
+    \raisebox{\aweboxsignraise}{\textcolor{#4}{\Huge#3}} & #5 \\
+  \end{tabu}
   \vspace{\aweboxvskip}}
 
 \newcommand{\notebox}[1]{%
-  \awesomebox{\abIconInfoCircle}{\aweboxrulewidth}{abnote}{#1}}
+  \awesomebox[abnote]{\aweboxrulewidth}{\abIconInfoCircle}{abnote}{#1}}
 
 \newcommand{\tipbox}[1]{%
-  \awesomebox{\abIconLightBulb}{\aweboxrulewidth}{black}{#1}}
+  \awesomebox{\aweboxrulewidth}{\abIconLightBulb}{black}{#1}}
 
 \newcommand{\warningbox}[1]{%
-  \awesomebox{\abIconExclamationTriangle}{\aweboxrulewidth}{abwarning}{#1}}
+  \awesomebox[abwarning]{\aweboxrulewidth}{\abIconExclamationTriangle}{abwarning}{#1}}
 
 \newcommand{\cautionbox}[1]{%
-  \awesomebox{\abIconFire}{\aweboxrulewidth}{abcaution}{#1}}
+  \awesomebox[abcaution]{\aweboxrulewidth}{\abIconFire}{abcaution}{#1}}
 
 \newcommand{\importantbox}[1]{%
-  \awesomebox{\abIconExclamationCircle}{\aweboxrulewidth}{abimportant}{#1}}
+  \awesomebox[abimportant]{\aweboxrulewidth}{\abIconExclamationCircle}{abimportant}{#1}}
+
+% Environments API
+% \begin{awesomeblock}[rulecolor]{rulewidth}{icon}{iconcolor}
+%   content
+% \end{awesomeblock}
+\newenvironment{awesomeblock}[4][abvrulecolor]%
+{\vspace{\aweboxvskip}\noindent
+  \begin{tabu} to \linewidth %
+    {m{\aweboxleftmargin}!{\color{#1}\vrule width #2}X}%
+    \raisebox{\aweboxsignraise}{\textcolor{#4}{\Huge#3}} & }
+  {\\\end{tabu}\vspace{\aweboxvskip}}
+
+\newenvironment{noteblock}%
+{\begin{awesomeblock}[abnote]{\aweboxrulewidth}{\abIconInfoCircle}{abnote}}
+  {\end{awesomeblock}}
+
+\newenvironment{tipblock}%
+{\begin{awesomeblock}{\aweboxrulewidth}{\abIconLightBulb}{black}}
+  {\end{awesomeblock}}
+
+\newenvironment{warningblock}%
+{\begin{awesomeblock}[abwarning]{\aweboxrulewidth}{\abIconExclamationTriangle}{abwarning}}
+  {\end{awesomeblock}}
+
+\newenvironment{cautionblock}%
+{\begin{awesomeblock}[abcaution]{\aweboxrulewidth}{\abIconFire}{abcaution}}
+  {\end{awesomeblock}}
+
+\newenvironment{importantblock}%
+{\begin{awesomeblock}[abimportant]{\aweboxrulewidth}{\abIconExclamationCircle}{abimportant}}
+  {\end{awesomeblock}}
 \endinput