% -----------------------------------------------------------------------
%%% tblr-extras-doc: Documentation for tblr-extras package.
%%% Version    : 1.2 - 2024-06-11
%%% Copyright  : 2024 (c) Manuel E. Merino <manuel.merino.pe@gmail.com>
%%% License    : The LaTeX Project Public License 1.3c
% -----------------------------------------------------------------------
%%% LPPL 1.3c Notice: ---------------------------------------------------
% This work may be distributed and/or modified under the
% conditions of the LaTeX Project Public License, either version 1.3c
% 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,11pt]{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.2}

\NewDocumentCommand{\tblrextras}{}{\textbf{\color{udep}tblr-extras}}

\begin{document}
	\begingroup%
	\centering
	\LARGE\textbf{Package \color{udep}tblr-extras}\par
	\large Manuel E. Merino\par
	\texttt{v\Version{} - 11/06/2024}\par
	\normalsize Extra libraries for tabularray package.\par
	\endgroup
	\tableofcontents
	\clearpage

	\section{Introduction}
	The \tblrextras{} package is a collection of extra libraries for the \texttt{tabularray} package.

	Currently, it includes two libraries: caption and babel.

	\section{Installation and use}

	To install the \tblrextras{} package download and unzip the \texttt{tblr-extras.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 \tblrextras{} package add the following command to the preamble of your document: \verb|\usepackage{tblr-extras}|

	\section{Available libraries}
	\subsection{caption library}

	This \tblrextras{} library changes the way \texttt{tabularray} typesets the captions of \texttt{talltblr} and \texttt{longtblr} environments, using the settings defined by the \texttt{caption} package.

	To enable this library, use \verb*|\UseTblrLibrary{caption}| after loading \tblrextras{} and \texttt{tabularray} packages.

	Since version 1.2, there is partial support for typesetting captions below tables. To enable this feature use the command \verb|\TblrCaptionBelow| to enable this feature. If you want to revert to captions above the table, use the command \verb|\TblrCaptionAbove|. Be aware that \texttt{longtblr} environments will position the caption hyperlink anchor in the lastfoot and the table will be listed in the List of Tables as if it was located in the last page occupied by the \texttt{longtblr}. environment.

	\subsection{babel library}
	Load this library using \verb|\UseTblrLibrary{babel}|

	The \tblrextras{} package redefines the \texttt{conthead-text} and \texttt{contfoot-text} for the \texttt{longtblr} environment, using the current babel language if this library is enabled.

	Currently only spanish, italian, portuguese, ngerman, russian, ukrainian and french variants are supported.

	\section{Bug reports and suggestions}

	For bug reports, suggestions amd support, please use GitHub or send an email to manuel.merino.pe@gmail.com.

	\section{License}

	The \tblrextras{} package and all its included files are licensed under the LPPL v1.3c or later.

	\section{Changelog}
	 v1.2 - Added new languages and an extension to caption library
	 \begin{itemize}
	 	\item Improved the caption library to support \texttt{label=empty} and \texttt{entry=none}.
	 	\item Added partial support for captions below the table using \verb|\TblrCaptionBelow| and to reverse the changes with \verb|\TblrCaptionAbove|.
	 	\item Added support for portuguese and italian languages in the babel library.
	 \end{itemize}

	 v1.1 - This version uses code contributions by GitHub user \textbf{sgolovan}. Thanks for your contribution.
		\begin{itemize}
			\item Improved the babel library using language hooks.
			\item Added support for polyglossia package.
			\item Added ukrainian and russian translations.
		\end{itemize}

	v1.0 - Initial release.

	\vfill
	\centering
	\footnotesize \tblrextras{} -- {\copyright} 2024 Manuel E. Merino. Licensed under LPPL v1.3c.
\end{document}