% !TEX root = ./Main.tex
% ==============================================================================
% Document Preamble
% ==============================================================================
% Description: Document-specific configuration and settings
%              This file contains all document-specific configurations that
%              customize the HSRTReport class for your particular document
% Author: [Your Name]
% Date: [Date]
% ==============================================================================

% ------------------------------------------------------------------------------
% Bibliography Configuration
% ------------------------------------------------------------------------------
% Configure BibLaTeX bibliography management
% The bibliography file (Main.bib) contains all references in BibTeX format
% Additional .bib files can be added with multiple \addbibresource commands
% ------------------------------------------------------------------------------
\addbibresource{Main.bib}

% ------------------------------------------------------------------------------
% Citation Hyperlink Configuration
% ------------------------------------------------------------------------------
% Make entire citation content clickable (Author, Year) instead of just parts
% This uses BibLaTeX's internal commands for better compatibility with APA style
% ------------------------------------------------------------------------------

% Use AtBeginDocument to ensure our settings override the APA style
\AtBeginDocument{%
	% Store original definitions
	\let\origparencite\parencite
	\let\origtextcite\textcite
	\let\origcite\cite

	% Redefine parencite to make entire content clickable
	\DeclareCiteCommand{\parencite}[\mkbibparens]
	{\usebibmacro{prenote}}
	{\bibhyperref{%
			\usebibmacro{citeindex}%
			\usebibmacro{cite}%
		}}
	{\multicitedelim}
	{\usebibmacro{postnote}}

	% Redefine textcite to make entire content clickable
	\DeclareCiteCommand{\textcite}
	{\boolfalse{cbx:parens}%
		\usebibmacro{prenote}}
	{\bibhyperref{%
			\usebibmacro{citeindex}%
			\printnames{labelname}%
			\setunit{\addspace}%
			\bibopenparen\usebibmacro{citeyear}\bibcloseparen%
		}}
	{\ifbool{cbx:parens}
		{\bibcloseparen\global\boolfalse{cbx:parens}}
		{}%
		\multicitedelim}
	{\usebibmacro{postnote}}

	% Redefine cite to make entire content clickable
	\DeclareCiteCommand{\cite}
	{\usebibmacro{prenote}}
	{\bibhyperref{%
			\usebibmacro{citeindex}%
			\usebibmacro{cite}%
		}}
	{\multicitedelim}
	{\usebibmacro{postnote}}
}

% ------------------------------------------------------------------------------
% Document Settings Import
% ------------------------------------------------------------------------------
% Load document-specific settings from external files
% This modular approach keeps the preamble clean and organized
% ------------------------------------------------------------------------------
\input{Settings/General}    % General document settings (title, author, etc.)
\input{Settings/Logos}      % Logo configuration and positioning
\input{Settings/CleverefNames} % Cleveref cross-reference names configuration

% ------------------------------------------------------------------------------
% Custom Commands and Macros (Optional)
% ------------------------------------------------------------------------------
% Add your custom LaTeX commands here
% Example: \newcommand{\mycommand}[1]{#1}
% ------------------------------------------------------------------------------

% ------------------------------------------------------------------------------
% Additional Package Loading (Optional)
% ------------------------------------------------------------------------------
% Load additional packages not included in the HSRTReport class
% Note: Most common packages are already loaded by the class
% Example: \usepackage{mypackage}
% ------------------------------------------------------------------------------

% ------------------------------------------------------------------------------
% Package Configuration (Optional)
% ------------------------------------------------------------------------------
% Configure packages that require specific settings
% Example: \setpackageoption{value}
% ------------------------------------------------------------------------------

% ==============================================================================
% End of Preamble
% ==============================================================================