% Copyright 2015 Diogo A. B. Fernandes
%
% This work may be distributed and/or modified under the
% conditions of the LaTeX Project Public License version 1.3c,
% available at http://www.latex-project.org/lppl/.

\documentclass{ltxdoc}

\usepackage[numbered]{hypdoc}
\usepackage{hologo}
\usepackage{hyperref,xcolor}
\usepackage{longtable,booktabs}
\usepackage{\jobname}

\definecolor{blue}{rgb}{0.19,0.31,0.54}
\hypersetup{colorlinks=true, linkcolor=blue, urlcolor=blue, hyperindex}

\EnableCrossrefs
\CodelineIndex
\RecordChanges

\begin{document}
\title{The \textsf{\jobname} package\\
High quality icons of online academic profiles}
\author{%
  Diogo A. B. Fernandes\thanks{Email: \href{mailto:diogoabfernandes@gmail.com}{\tt diogoabfernandes@gmail.com}}~(\hologo{LaTeX} code)\\%
  James Walsh (font and icons design)}
\date{Version 1.4, released on May 28, 2015}
\maketitle

\begin{abstract}
The \textsf{\jobname} package provides specific \hologo{(La)TeX} bindings with the free \emph{Academicons} font, allowing to access 20 high quality icons of online academic profiles.
\end{abstract}

\changes{v1.4-1}{2015/05/30}{Fix release: corrected a few typos and errors in the manual.}
\changes{v1.4}{2015/05/28}{First public release (version number set to match the included \texttt{academicons.ttf} font version).}

\bigskip

\section{Description}
The \textsf{\jobname} package provides access in \hologo{(La)TeX} to 20 high quality icons of online academic profiles included in the free \emph{Academicons} font. This package requires the \textsf{fontspec} package and either the \hologo{Xe}\hologo{(La)TeX} or Lua\hologo{(La)TeX} engine to load the included \texttt{academicons.ttf} font. 

The \emph{Academicons} font was designed by James Walsh and released\footnote{See \url{http://jpswalsh.github.io/academicons/}.} under the open SIL Open Font License\footnote{Available at \url{http://scripts.sil.org/OFL}.}. This package is a redistribution of the free \emph{Academicons} font with specific bindings for \hologo{(La)TeX}. It is inspired and based on the \textsf{fontawesome}\footnote{Available at \url{http://www.ctan.org/pkg/fontawesome}.} package.

\section{Usage}
\DescribeMacro{\aiicon}
The \textsf{\jobname} package provides the generic \cs{aiicon} command to access icons, which takes as mandatory argument the \meta{name} of the desired icon. It also provides individual direct commands for each specific icon. The full list of icons and their respective names and direct commands can be found below. For example, \cs{aiicon\{googlescholar\}} yields the same result as \cs{aiGoogleScholar}.

\newenvironment{showcase}%
  {%
   \begin{longtable}{cp{3.5cm}p{4cm}}
   \cmidrule[\heavyrulewidth]{1-3}% \toprule
   \bfseries Icon&{\bfseries Name} (\meta{name})&\bfseries Direct Command\\
   \cmidrule{1-3}\endhead}
  {\cmidrule[\heavyrulewidth]{1-3}% \bottomrule
   \end{longtable}}
\newcommand{\icon}[2]{\aiicon{#1}& \itshape #1&\ttfamily\textbackslash #2\index{\ttfamily\textbackslash #2}\\}

\newpage
\subsection{Academicons Icons}
\label{sec:icons}

\begin{showcase}
  \icon{googlescholar}{aiGoogleScholar}
  \icon{googlescholar-square}{aiGoogleScholarSquare}
  \icon{researchgate}{aiResearchGate}
  \icon{researchgate-square}{aiResearchGateSquare}
  \icon{mendeley}{aiMendeley}
  \icon{mendeley-square}{aiMendeleySquare}
  \icon{orcid}{aiOrcid}
  \icon{orcid-square}{aiOrcidSquare}
  \icon{impactstory}{aiImpactstory}
  \icon{impactstory-square}{aiImpactstorySquare}
  \icon{academia}{aiAcademia}
  \icon{academia-square}{aiAcademiaSquare}
  \icon{zotero}{aiZotero}
  \icon{zotero-square}{aiZoteroSquare}
  \icon{figshare}{aiFigshare}
  \icon{figshare-square}{aiFigshareSquare}
  \icon{dryad}{aiDryad}
  \icon{dryad-square}{aiDryadSquare}
  \icon{arxiv}{aiArxiv}
  \icon{arxiv-square}{aiArxivSquare}
\end{showcase}

\PrintChanges
\PrintIndex
\end{document}

