% 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}
\usepackage{academicons}

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

\usepackage{totcount}
\newtotcounter{IconsCounter}
\setcounter{IconsCounter}{0}

% \EnableCrossrefs
% \CodelineIndex
% \RecordChanges

% \changes{v1.9.6}{2025/09/17}{pdfTeX support.}
% \changes{v1.9.4}{2023/10/29}{Release of v1.9.4.}
% \changes{v1.9.1-2}{2022/03/10}{Fix release: included some missing icons.}
% \changes{v1.9.1}{2021/11/26}{Release of v1.9.1.}
% \changes{v1.9.0}{2020/08/14}{Release of v1.9.0.}
% \changes{v1.8.6-2}{2018/06/27}{Fixed bugs in a few icon macros.}
% \changes{v1.8.6-1}{2018/06/25}{Removed \texttt{fontspec} dependency.}
% \changes{v1.8.6}{2018/04/03}{Release of v1.8.6.}
% \changes{v1.8.3}{2018/04/03}{Release of v1.8.3.}
% \changes{v1.8.0-1}{2018/03/27}{Enhancement release: adjusted \texttt{\textbackslash{}newfontfamily} to account for the font installed via \texttt{tlmgr}.}
% \changes{v1.8.0}{2017/05/15}{Major release of v1.8.0.}
% \changes{v1.7.2}{2016/06/12}{Fix release: corrected a bug in the style file.}
% \changes{v1.7.1}{2016/06/12}{Fix release: corrected a bug in the style file.}
% \changes{v1.7.0}{2016/05/16}{Major release of v1.7.0.}
% \changes{v1.6.0-1}{2016/03/02}{Better documentation.}
% \changes{v1.6.0}{2016/01/30}{Major release of v1.6.0.}
% \changes{v1.4.0-1}{2015/05/30}{Fix release: corrected a few typos and errors in the manual.}
% \changes{v1.4.0}{2015/05/28}{First public release (version number set to match the included \texttt{academicons.ttf} font version).}

\begin{document}
\title{The \textsf{\jobname} package\\
High quality icons of online academic profiles}
\author{%
  Diogo Fernandes\thanks{Email: \href{mailto:diogoabfernandes@gmail.com}{\tt diogoabfernandes@gmail.com}}~(\hologo{LaTeX} code)\\%
  James Walsh (font and icons design)}
\date{v1.9.6-2, released on the 20th of September, 2025}
\maketitle

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

\bigskip

\section{Description}
The \textsf{\jobname} package provides access in \hologo{(La)TeX} to \total{IconsCounter} high quality icons of online academic socials included in the free \emph{Academicons} font. This package works with both \hologo{Xe}\hologo{(La)TeX} or Lua\hologo{(La)TeX} by using \textsf{fontspec} to load the included font, as well as with pdf\hologo{(La)TeX} by loading a Type 1 converted format of the original 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 generic \cs{aiicon} macro takes as mandatory argument the lowercase \meta{name} of the desired icon. Icons can also be accessed directly by their respective macro in CamelCase. For example, \cs{aiicon\{googlescholar\}} yields the same result as \cs{aiGoogleScholar}.
%
The full list of icons with their respective names and direct macros can be found in the next pages.

\newenvironment{showcase}{%
   \begin{longtable}{cp{3.75cm}p{4.5cm}}%
   \cmidrule[\heavyrulewidth]{1-3}% \toprule
   % \bfseries \#&\bfseries Icon&{\bfseries Name} (\meta{name})&\bfseries Direct Macro\\
   \bfseries Icon&{\bfseries Name} (\meta{name})&\bfseries Direct Macro\\%
   \cmidrule{1-3}\endhead%
}{%
  \cmidrule[\heavyrulewidth]{1-3}% \bottomrule
  \end{longtable}%
}

\newcommand{\icon}[2]{%
  \stepcounter{IconsCounter}%
  % \arabic{IconsCounter}&%
  % \csname #2\endcsname%
  \aiicon{#1}&%
  \itshape #1&%
  \ttfamily\textbackslash #2\index{\ttfamily\textbackslash #2}\\%
  \stepcounter{IconsCounter}%
  % \arabic{IconsCounter}&%
  % \csname #2Square\endcsname%
  \aiicon{#1-square}&%
  \itshape #1-square&%
  \ttfamily\textbackslash #2Square\index{\ttfamily\textbackslash #2Square}\\%
}

\newpage
\subsection{Academicons Icons}

\begin{showcase}
  \icon{academia}{aiAcademia}
  \icon{acclaim}{aiAcclaim}
  \icon{acm}{aiACM}
  \icon{acmdl}{aiACMDL}
  \icon{ads}{aiADS}
  \icon{africarxiv}{aiAfricArXiv}
  \icon{archive}{aiArchive}
  \icon{arxiv}{aiarXiv}
  \icon{biorxiv}{aibioRxiv}
  \icon{ceur}{aiCEUR}
  \icon{ciencia-vitae}{aiCIENCIAVITAE}
  \icon{clarivate}{aiClarivate}
  \icon{closed-access}{aiClosedAccess}
  \icon{conversation}{aiConversation}
  \icon{coursera}{aiCoursera}
  \icon{crossref}{aiCrossref}
  \icon{cv}{aiCV}
  \icon{datacite}{aiDataCite}
  \icon{dataverse}{aiDataverse}
  \icon{dblp}{aidblp}
  \icon{depsy}{aiDepsy}
  \icon{doi}{aiDoi}
  \icon{dryad}{aiDryad}
  \icon{elsevier}{aiElsevier}
  \icon{figshare}{aiFigshare}
  \icon{googlescholar}{aiGoogleScholar}
  \icon{hal}{aiHAL}
  \icon{hypothesis}{aiHypothesis}
  \icon{ideas-repec}{aiIDEASRePEc}
  \icon{ieee}{aiIEEE}
  \icon{impactstory}{aiImpactstory}
  \icon{inaturalist}{aiiNaturalist}
  \icon{inpn}{aiINPN}
  \icon{inspire}{aiInspire}
  \icon{isidore}{aiISIDORE}
  \icon{isni}{aiIsni}
  \icon{jstor}{aiJSTOR}
  \icon{lattes}{aiLattes}
  \icon{mathoverflow}{aiMathOverflow}
  \icon{mendeley}{aiMendeley}
  \icon{moodle}{aiMoodle}
  \icon{mtmt}{aiMTMT}
  \icon{nakala}{aiNAKALA}
  \icon{obp}{aiOBP}
  \icon{open-access}{aiOpenAccess}
  \icon{open-data}{aiOpenData}
  \icon{open-materials}{aiOpenMaterials}
  \icon{openedition}{aiOpenEdition}
  \icon{orcid}{aiOrcid}
  \icon{osf}{aiOSF}
  \icon{overleaf}{aiOverleaf}
  \icon{philpapers}{aiPhilPapers}
  \icon{piazza}{aiPiazza}
  \icon{preregistered}{aiPreregistered}
  \icon{protocols}{aiProtocols}
  \icon{psyarxiv}{aiPsyArXiv}
  \icon{publons}{aiPublons}
  \icon{pubmed}{aiPubMed}
  \icon{pubpeer}{aiPubPeer}
  \icon{researcherid}{aiResearcherID}
  \icon{researchgate}{aiResearchGate}
  \icon{ror}{aiROR}
  \icon{sci-hub}{aiSciHub}
  \icon{scirate}{aiSciRate}
  \icon{scopus}{aiScopus}
  \icon{semantic-scholar}{aiSemanticScholar}
  \icon{springer}{aiSpringer}
  \icon{ssrn}{aiSSRN}
  \icon{stackoverflow}{aiStackOverflow}
  \icon{viaf}{aiViaf}
  \icon{wiley}{aiWiley}
  \icon{zenodo}{aiZenodo}
  \icon{zotero}{aiZotero}
\end{showcase}

% \PrintChanges
% \PrintIndex
\end{document}
