%% udepcolor-doc-EN.sty
%% Copyright 2024 Manuel E. Merino
%
% This work may be distributed and/or modified under the
% conditions of the LaTeX Project Public License, either version 1.3
% of this license or (at your option) any later version.
% The latest version of this license is in
%   https://www.latex-project.org/lppl.txt
% and version 1.3c or later is part of all distributions of LaTeX
% version 2008 or later.
%
% This work has the LPPL maintenance status `maintained'.
% 
% The Current Maintainer of this work is Manuel E. Merino
%
\documentclass[a4paper,12pt]{article}
\usepackage{fontspec}
\setmainfont{montserrat}
\setsansfont{montserrat}
\setmonofont[Scale=MatchLowercase]{Roboto Mono}
\usepackage{microtype}
\usepackage[english]{babel}
\usepackage{xcolor}
\usepackage{graphicx}
\usepackage{udepcolor}
\usepackage[margin=2.5cm]{geometry}
\usepackage{parskip}
\usepackage[hidelinks]{hyperref}

\newcommand{\Version}{1.0}

\NewDocumentCommand{\udepcolor}{}{\textbf{\color{udep}udepcolor}}

\NewDocumentCommand{\ColorPreview}{m}{%
		\fcolorbox{black}{#1}{%
		\vbox to 40pt {\vfil
			\hbox to 140pt{\hfil\colorbox{white}{\ttfamily#1}\hfil}%
			\vfil
		}%
}}

\begin{document}
	\begingroup%
	\centering
	\LARGE\textbf{Package \color{udep}udepcolor}\par
	\large Manuel E. Merino\par
	\texttt{v\Version{} - 04/02/2024}\par
	\normalsize Institutional and corporate colors of the University of Piura for electronic documents and digital formats for use with \LaTeXe.\par
	\noindent\ColorPreview{udep}
	\ColorPreview{udep-oscuro}\\
	\ColorPreview{udep-gris}
	\ColorPreview{udep-claro}\par
	\ColorPreview{udep-med-0}
	\ColorPreview{udep-med-1}
	\ColorPreview{udep-med-2}
	\ColorPreview{udep-arq-0}
	\ColorPreview{udep-arq-1}
	\ColorPreview{udep-arq-2}
	\ColorPreview{udep-emp-0}
	\ColorPreview{udep-emp-1}
	\ColorPreview{udep-emp-2}
	\ColorPreview{udep-ing-0}
	\ColorPreview{udep-ing-1}
	\ColorPreview{udep-ing-2}
	\ColorPreview{udep-der-0}
	\ColorPreview{udep-der-1}
	\ColorPreview{udep-der-2}
	\ColorPreview{udep-psi-0}
	\ColorPreview{udep-psi-1}
	\ColorPreview{udep-psi-2}
	\ColorPreview{udep-com-0}
	\ColorPreview{udep-com-1}
	\ColorPreview{udep-com-2}
	\ColorPreview{udep-edu-0}
	\ColorPreview{udep-edu-1}
	\ColorPreview{udep-edu-2}
	\ColorPreview{udep-hum-0}
	\ColorPreview{udep-hum-1}
	\ColorPreview{udep-hum-2}
	\ColorPreview{udep-eco-0}
	\ColorPreview{udep-eco-1}
	\ColorPreview{udep-eco-2}%
	\par
	\endgroup
	\clearpage
	\normalfont
	\tableofcontents
	
	\section{Introduction}
	The \udepcolor{} package has been designed with the purpose of providing simple and efficient access to the institutional and corporate color palette of the University of Piura (UDEP) within the \LaTeX{} system. 
	
	The colors have been selected and implemented using the \texttt{xcolor} package and following the brand and visual identity guidelines of the University of Piura.
	
	\section{Installation and use}
	
	To install the \udepcolor{} package download and unzip the \texttt{udepcolor.sty} file and place it in a folder accessible to \LaTeX{} (this can be the current working folder or a subfolder in the TEXMF directory).

	To use the \udepcolor{} package add the following command to the preamble of your document: \verb|usepackage{udepcolor}| 
	
	\section{Available colors}
	\subsection{Institutional colors}
	
	The \udepcolor{} package defines the 4 institutional colors: \texttt{udep}, \texttt{udep-gris}, \texttt{udep-oscuro} and \texttt{udep-claro}.
	
	\begin{center}
	\ColorPreview{udep}
	\ColorPreview{udep-gris}\\
	\ColorPreview{udep-oscuro}
	\ColorPreview{udep-claro}
	\end{center}
	
	\subsection{Corporate colors}
	
	The 3 colors corresponding to each faculty have been defined according to the following naming convention: \texttt{udep-fac-n} where \texttt{fac} is a 3-letter identifier, unique for each faculty and \texttt{n} is a number that can be 0, 1 or 2.
	
	For example, for the faculty of Engineering, its unique identifier would be \texttt{ing} being the 3 colors available: \texttt{udep-ing-0}, \texttt{udep-ing-1} and \texttt{udep-ing-2}.
	
	
	\begin{center}
		\ColorPreview{udep-ing-0}
		\ColorPreview{udep-ing-1}
		\ColorPreview{udep-ing-2}
	\end{center}
	
	For a complete list of available colors, see the first page of this document.
	
	\section{Bug reports and suggestions}
	
	For bug reports and suggestions, please use GitHub or send an email to manuel.m.pe@gmail.com.
	
	\section{License}
	
	The \udepcolor{} package and all its included files are licensed under the LPPL v1.3c or later.
	
	\vfill
	\centering
	\footnotesize \udepcolor{} -- {\copyright} 2024 Manuel E. Merino. Licensed under LPPL v1.3c.  
\end{document}