\documentclass[12pt,a4paper]{article}
\usepackage{NORSOTL}
% --- Macro placeholders ---
\newcommand{\PaperAuthors}{author \& al}
\newcommand{\PaperYear}{2025}
\newcommand{\PaperDOI}{10.1234/norsotl.2025.001}
\newcommand{\ArticleType}{INQUIRY ARTICLE} % INQUIRY ARTICLE / THINKING PIECE / ORIGINAL IDEA
\newcommand{\ArticleTitle}{Title of the article} 
\newcommand{\volume}{XXXX}
\newcommand{\yearPublished}{XXXX}
\newcommand{\ReceivedDate}{Received: XXXX}
\newcommand{\AcceptedDate}{Accepted: XXXX}
\newcommand{\PublishedDate}{Published: XXXX}
\newcommand{\Editors}{Editors: XXX}

\title{\large \ArticleType  \par
	\LARGE \ArticleTitle}
\author{%
\begin{minipage}[t]{\textwidth}
	\raggedright
	\textbf{Alice Smith \textsuperscript{1*}, Bob Johnson \textsuperscript{1}, Carol Lee \textsuperscript{2}}\\[6pt]
	\textsuperscript{1}Geophysical Institute, University of Bergen\\
	\textsuperscript{2}Department of Education, University of Bergen\\
	$^{*}$\url{alice.smith@example.com}\\[8pt]
\end{minipage}
}

\addbibresource{references.bib}
% =============================
%  Document
% =============================

\begin{document}
	
	% abstract and keywords
	\NORSOTLFrontmatter
	{
		\lipsum[1]
	}
	{keyword 1, keyword 2, keyword 3} % keywords
	
	
\section{Introduction}

This document is a \LaTeX{} template intended for submissions to \emph{NorSoTL} (Norwegian Journal for the Scholarship of Teaching and Learning). The primary purpose of this section is to demonstrate common manuscript elements --figures, tables, cross-references, and APA7-style citations using \texttt{biblatex} with \texttt{biber}. Replace the placeholder text with your own study context, methods, and findings before submission.

When drafting a NorSoTL manuscript, aim for clear signposting and ensure that every visual element is introduced in the running text. For example, Figure~\ref{fig:fig1} is referenced before it appears, and Table~\ref{tab:opportunities_challenges_wind_energy} is similarly introduced and briefly interpreted. This helps reviewers and readers understand why each element is included and what it contributes to the argument.

To illustrate APA7 citations with \texttt{biblatex}+\texttt{biber}, this template includes both a textual citation (author is part of the sentence) and a parenthetical citation (author is not part of the sentence). For instance, \textcite{bengtsen2022} is used as a textual citation, whereas a parenthetical citation looks like this \parencite{sinclair2004pedagogy}.

\subsection{Figures}

Figures are useful for showing a diagram, a screenshot of a learning activity (where appropriate and permitted), a conceptual model, or a visual summary of results.  Here is some fillers: \lipsum[2]

\begin{figure}[t!]
	\centering
	\includegraphics[width=0.5\linewidth]{figures/seagull}
	\caption{Example figure included with \texttt{\textbackslash includegraphics}. Replace the file and caption with your own content.}
	\label{fig:fig1}
\end{figure}



\subsection{Tables}

Tables should present structured information that is easier to scan than to read in prose. Keep tables self-contained by writing captions that clarify what the table is, how to read it, and (if relevant) what it is adapted from.

Table~\ref{tab:opportunities_challenges_wind_energy} demonstrates a compact two-column layout. In your own work, consider whether the table communicates a pattern, comparison, or categorisation that is later discussed in the text (rather than duplicating what is already stated).

% NOTE: This table uses \toprule/\midrule/\bottomrule, so ensure the preamble includes \usepackage{booktabs}.
\begin{table}[t!]
	\centering
	\caption{Example table layout with a source note in the caption (replace the citation key and content as needed).}
	\footnotesize{
		\begin{tabular*}{\linewidth}{l @{\extracolsep{\fill}}l}
			\toprule
			\textbf{Category A} & \textbf{Category B} \\
			\midrule
			Placeholder entry 1 & Placeholder entry 1 \\
			Placeholder entry 2 & Placeholder entry 2 \\
			Placeholder entry 3 & Placeholder entry 3 \\
			\bottomrule
		\end{tabular*}
	}
	\label{tab:opportunities_challenges_wind_energy}
\end{table}


\subsection{Cross-references and citation forms}

Use \texttt{\textbackslash ref} consistently for figures and tables (e.g., Figure~\ref{fig:fig1}, Table~\ref{tab:opportunities_challenges_wind_energy}). For citations with APA7 in \texttt{biblatex}, use:
\begin{itemize}
	\item \texttt{\textbackslash textcite\{key\}} for textual citations (e.g., \textcite{bengtsen2022}),
	\item \texttt{\textbackslash parencite\{key\}} for parenthetical citations (e.g., \parencite{sinclair2004pedagogy}).
\end{itemize}

		
\subsection{Additional citation patterns}

Multiple sources can be cited in a single parenthetical reference \parencite{bengtsen2022,sinclair2004pedagogy}. If you need a page-specific reference (when supported by your \texttt{biblatex} setup), use an optional locator, for example \parencite[p.~23]{bengtsen2022}.
	
	
	\small{
		\paragraph{Acknowledgments}
		
		Acknowledgments go there
	}
	
	% -----------------------------
	% About the authors
	% -----------------------------
\section*{About the Authors}	
	
\textbf{Alice Smith} is an academic researcher with experience in teaching and scholarly writing. Her work spans multiple areas of interest within higher education, and she regularly contributes to peer-reviewed publications and collaborative research projects.\\[6pt]

\noindent \textbf{Bob Johnson} is a graduate researcher engaged in advanced studies. His academic activities include research development, data analysis, and participation in collaborative academic work. He contributed to this article as part of a joint writing effort.\\[6pt]

\noindent \textbf{Carol Lee} is a senior academic with extensive experience in research coordination and academic program development. She has been involved in a range of scholarly initiatives and provided general guidance during the preparation of this manuscript.

\section*{Ethics, consent, and data availability}

If the manuscript involves student data, course artifacts, observations, interviews, surveys, learning analytics, or other person-related information, authors should clarify the ethical basis for the work (e.g., consent procedures, anonymisation, and any institutional review considerations). If applicable, state where data, instruments, or analysis materials can be accessed (e.g., repository link) or explain any restrictions.

	
	\printbibliography
	
\end{document}
