diff options
author | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
commit | e0c6872cf40896c7be36b11dcc744620f10adf1d (patch) | |
tree | 60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/latex/contrib/ijsra |
Initial commit
Diffstat (limited to 'macros/latex/contrib/ijsra')
-rw-r--r-- | macros/latex/contrib/ijsra/README.md | 39 | ||||
-rw-r--r-- | macros/latex/contrib/ijsra/ijsra.cls | 633 | ||||
-rw-r--r-- | macros/latex/contrib/ijsra/ijsra.pdf | bin | 0 -> 387846 bytes | |||
-rw-r--r-- | macros/latex/contrib/ijsra/ijsra.tex | 461 | ||||
-rw-r--r-- | macros/latex/contrib/ijsra/ijsra_logo.png | bin | 0 -> 329827 bytes |
5 files changed, 1133 insertions, 0 deletions
diff --git a/macros/latex/contrib/ijsra/README.md b/macros/latex/contrib/ijsra/README.md new file mode 100644 index 0000000000..694a6a6cd9 --- /dev/null +++ b/macros/latex/contrib/ijsra/README.md @@ -0,0 +1,39 @@ +document class __ijsra__ +======= + +_2017/07/24 v1.1_ + +Copyright (c) 2017 Lukas C. Bossert + +Email: [lukas@digitales-altertum.de](mailto:lukas@digitales-altertum.de) + +This is a document class called *ijsra* which is used for the __[International Journal of Student Research in Archaeology](http://www.ijsra.org) (IJSRA)__. + +--- + +This style contains: + +documentation: + +- ijsra.tex +- ijsra.pdf + +and its style: + +* ijsra.cls + +and the required logo: + +* ijsra_logo.png + + +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 [http://www.latex-project.org/lppl.txt](http://www.latex-project.org/lppl.txt) and version 1.3 or later is part of all distributions of LaTeX +version 2005/12/01 or later. + +--- +This work has the LPPL maintenance status _maintained_. +The current maintainer of this work is [Lukas C. Bossert](https://github.com/LukasCBossert). + diff --git a/macros/latex/contrib/ijsra/ijsra.cls b/macros/latex/contrib/ijsra/ijsra.cls new file mode 100644 index 0000000000..1a7a30f71c --- /dev/null +++ b/macros/latex/contrib/ijsra/ijsra.cls @@ -0,0 +1,633 @@ +%% This is file `ijsra.cls', +%% +%% LaTeX Class for ``International Journal of Student Research in Archaeology''. +%% +%% Copyright (C) 2016,2017- +%% Lukas C. Bossert +%% +%% It 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 +%% http://www.latex-project.org/lppl.txt +%% and version 1.3c or later is part of all distributions of LaTeX +%% version 2005/12/01 or later. + +\listfiles +\NeedsTeXFormat{LaTeX2e}[1999/12/01] + +\ProvidesClass{ijsra} +\RequirePackage{ifxetex,ifluatex,ifpdf,ifvtex} +\RequirePackage{xkeyval,etoolbox} + +\def\IJSRAversion{1.1} +\def\IJSRAversiondate{2017/07/24} + +\newbool{issue} +\newbool{nobib} + +\boolfalse{nobib} +\boolfalse{issue} + + + +\newcommand*\IJSRAmonth{{\scshape proof}} +\newcommand*\IJSRAyear{{\scshape proof}}% \edef\issueyear{\the\year} +\newcommand*\IJSRAvolume{{\scshape proof}} +\newcommand*\IJSRAnumber{{\scshape proof}} +\newcommand*\IJSRAtitlefigure{{\color{mygold}\rule{\linewidth}{410pt}}} +\newcommand*\IJSRAidentifier{\jobname} +\newcommand*\yearnumber{\IJSRAyear\,|\,\IJSRAnumber} + + +\DeclareOptionX{draft}{\PassOptionsToClass{\CurrentOption}{scrbook}} +\DeclareOptionX{month}{\def\IJSRAmonth{#1}} +\DeclareOptionX{year}{\def\IJSRAyear{#1}} +\DeclareOptionX{completeissue}{\booltrue{issue}} +\DeclareOptionX{volume}{\def\IJSRAvolume{Vol.\addspace #1}} +\DeclareOptionX{number}{\def\IJSRAnumber{#1}} +\DeclareOptionX{titlefigure}{\def\IJSRAtitlefigure{\includegraphics[width=\linewidth]{figures/#1}}} +\DeclareOptionX*{\OptionNotUsed} +\ProcessOptionsX\relax + + +\RequirePackage{scrhack}% Andere Pakete KOMA-Script-freundlich machen + + +\LoadClass[% + parskip=half, + twoside=true, % onesite or twoside printing + open=any, % doublepage cleaning ends up right side + chapterprefix=false, % prefix for chapter marks (Löscht "Kapitel" bei Kapitel) + headings=optiontohead, % \chapter[tocentry={}]{} + fontsize=11pt, % font size + titlepage=on, % own page for each title page + captions=tableabove, % display table captions above the float env + numbers=noenddot, +]{scrbook}% + +\RequirePackage{filecontents} +\RequirePackage{fontspec} +%\RequirePackage[osf]{libertine} +% \RequirePackage{unicode-math} +\setsansfont{Libertinus Sans} +\setmainfont[Numbers = {Monospaced, OldStyle}]{Libertinus Serif} +\defaultfontfeatures[AnonymousPro] + { + Extension = .ttf , + BoldFont = AnonymousPro-Bold , + ItalicFont = AnonymousPro-BoldItalic , + BoldItalicFont = AnonymousPro-Italic , + UprightFont = AnonymousPro-Regular , + } +\setmonofont[Scale= MatchLowercase]{AnonymousPro} + +\RequirePackage[french, ngerman, spanish, italian, main=english]{babel} +\RequirePackage[% +,protrusion=true +,expansion=true +,verbose=true +,final=true +,letterspace=100 +,babel=true +]{microtype} +\RequirePackage{colortbl} +\RequirePackage{abbrevs} +\RequirePackage[shortlabels]{enumitem} + +\RequirePackage{alertmessage} +\RequirePackage{marginnote} +\RequirePackage{lettrine} % The lettrine is the first enlarged letter at the beginning of the text +\LettrineTextFont{\itshape} +\setcounter{DefaultLines}{3} +\renewcommand{\LettrineTextFont}{\normalfont}%für zweite Klammer +\renewcommand{\LettrineFontHook}{\normalfont} +\RequirePackage{paralist} % Used for the compactitem environment which makes bullet points with less space between them +\RequirePackage{currfile} +\RequirePackage{enumerate} +\RequirePackage{currfile-abspath} + +\RequirePackage[ +detect-all, %Zahlen werden in der aktuellen Schrift angezeigt + exponent-to-prefix = true, + round-mode = places, + group-minimum-digits = 4, + group-separator ={,}, % für "12.345" statt "12 345" + range-phrase = {$\times$},% + zero-decimal-to-integer = true, %aus "2.0" wird "2" + range-units =single, % --> 2 x 2 m, - auskommentieren für 2 m x 2 m + ]{siunitx} +\RequirePackage[ % advanced quotes + strict=true, + style=english, +]{csquotes} + +\renewcommand*{\mkccitation}[1]{ (#1)} +\renewcommand*{\mkcitation}[1]{ (#1)} + +\renewenvironment{quote} + {%\small + \list{}{\rightmargin=0em \leftmargin=2em}% + \item\relax} + {\endlist} +\newenvironment{IJSRAquote}[1]% +{\begin{quote} +\alertwarning{\sffamily THIS FEATURE IS DEPRECATED!\newline +Use \textbackslash blockcquote or \textbackslash foreignblockcquote. \newline +See the documentation online.} +} + {\end{quote}} + +%------------------------------------------- + +\RequirePackage[ %% use for bibliography + backend=biber, + style=ijsra, + ]{biblatex} +\addbibresource{\jobname.bib} + + +\RequirePackage{etoolbox} +\RequirePackage{graphicx} +\graphicspath{{figures/}} +\RequirePackage{wrapfig} % Paket zur Positionierung einbinden +\RequirePackage{booktabs}%für schönere Tabellen +\RequirePackage{multirow} +\RequirePackage{xspace} +\RequirePackage{xcolor} +\RequirePackage{hologo} +\RequirePackage{url} +\urlstyle{same} +\definecolor{myblue}{rgb}{0,0,51} +\definecolor{mygold}{RGB}{204,153,51} +\definecolor{mybluetitle}{RGB}{28,40,65} % HEX 1c2841 + +\definecolor{codeblue}{RGB}{0,65,137} +\definecolor{codegreen}{RGB}{147,193,26} +\definecolor{codegray}{rgb}{0.5,0.5,0.5} +\definecolor{codepurple}{rgb}{0.58,0,0.82} +\definecolor{backcolour}{rgb}{0.95,0.95,0.92} + +\RequirePackage{pdfpages} + + + +\newcommand\submission{} +\newcommand\acceptance{} + + +%----------------------------------------- +\RequirePackage[ % page layout modifications + paper=a4paper, % - use A4 paper size + head=4\baselineskip, % - no header + foot =4\baselineskip, + bindingoffset=0.5cm, % - binding correction + top=3cm, % - total body: top margin + left=2cm, % - total body: left margin (odd pages) + right=5cm, % - total body: right margin (odd pages) + bottom=5cm, % - total body: bottom margin + marginparwidth=4cm, % - width for side note +]{geometry} +\RequirePackage{multicol} % Used for the two-column layout of the document +\RequirePackage[% + %hang, + small, + labelfont=bf, + up, + singlelinecheck=off, + justification=raggedright, + textfont=it, + up, + ]{caption} % Custom captions under/above floats in tables or figures +\RequirePackage{subcaption} +\RequirePackage{setspace} % for line spacing, e.g. \onehalfspacing +\RequirePackage{booktabs} % Horizontal rules in tables +\RequirePackage{nth} +\RequirePackage[content={Figure omitted due to faster compiling.}]{draftfigure} + + +\RequirePackage{chngcntr} %Voraussetzung fuer Fussnoten durch alle Kapitel durchnummerieren +\RequirePackage{listings} +\AtBeginDocument{\counterwithin{lstlisting}{chapter}} + +\counterwithout{footnote}{chapter} %Fussnoten durch alle Kapitel durchnummerieren +\counterwithout{figure}{chapter} +\counterwithout{table}{chapter} + +%------------------------------------------- +\newcommand*{\ijsradate}[1]{\expandafter\@ijsradate#1\@nil} +\newcommand*{\@ijsradate}{} +\def\@ijsradate#1-#2-#3\@nil{\begingroup + \year=#1\relax + \month=#2\relax + \day=#3\relax + % \DayName{#1}{#2}{#3}, % + \today% + \endgroup} + +\RequirePackage[ + headsepline, + draft=false, + ]{scrlayer-scrpage} +\pagestyle{scrheadings} +\clearscrheadfoot +\addtokomafont{pageheadfoot}{\normalfont\sffamily\footnotesize} + +\lohead{\ifdefempty{\shorttitle}{}{\shorttitle%\ \ifdefempty{\ppages}{}{$\bullet$ \ppages} +}} +\rehead{\shortauthor} +\rohead{\textbf{\thepage}} +\lehead{\textbf{\thepage}} +\refoot{International Journal of Student Research in Archaeology} +\lofoot{\yearnumber} +\automark[subsection]{section} + + +\newpairofpagestyles[scrheadings]{ijsrachapter}{\clearscrheadfoot +\chead{International Journal of Student Research in Archaeology | IJSRA\hfill\yearnumber\\ + \ifdefempty{\submission}{}{submission: \ijsradate{\submission}} + \ifdefempty{\acceptance}{}{| acceptance: \ijsradate{\acceptance}} + \hfill pp.\,\ppages% +\marginnote{\vspace{-5em}\includegraphics[width=\linewidth]{ijsra_logo}}} +} + + + +\newpairofpagestyles[scrheadings]{part}{\clearscrheadfoot} +\renewcommand\partpagestyle{part} +\renewcommand\chapterpagestyle{ijsrachapter} + + +%----------------------------- +\setkomafont{partnumber}{\normalfont\Huge} +\setkomafont{part}{\normalfont\scshape\Huge} +\setkomafont{chapter}{\normalfont\LARGE}%\uppercase +\setkomafont{section}{\normalfont\Large}%\uppercase +\setkomafont{subsection}{\normalfont}%\uppercase +\setkomafont{subsubsection}{\normalfont}%\uppercase +\setkomafont{paragraph}{\normalfont\scshape}%\uppercase +\addtokomafont{descriptionlabel}{\normalfont\sffamily}%\textsf\large}%\uppercase +\addtokomafont{sectioning}{\linespread{1}\selectfont} %einfacher Zeilenabstand in Überschriften +\addtokomafont{headsepline}{\color{mygold}} +\addtokomafont{labelinglabel}{\sffamily\bfseries} + +\setfootnoterule{0pt} + +\addtolength{\skip\footins}{.5\baselineskip} % Abstand Text <-> +\KOMAoptions{headsepline=3pt} + +\clubpenalty=10000 % prevent single lines at the beginning of a paragraph (Schusterjungen) +\widowpenalty=10000 % prevent single lines at the end of a paragraph (Hurenkinder) +\displaywidowpenalty=10000 % +%----------------------------------------- +\RequirePackage[% + marginal, + ragged,% + hang, % + bottom% + ]{footmisc} %Fussnoten +\raggedbottom + +\deffootnote{0em}{1em}{{\sffamily\textbf\thefootnotemark}\ }%Ausgabe der Fußnotenziffer in normal +%-------------------------------------- +\robustify{\DateMark} % after having loaded abbrevs + + +\ifstr{\KOMAScriptVersion}{2015/07/02 v3.18 KOMA-Script}{% + \ifx\par@update\default@par@update\else + \AtBeginDocument{\par@updaterelative}% + \fi +}{} + +\renewcommand{\marginfont}{\noindent\rule{0pt}{0.7\baselineskip}\color{mygold}\small\sffamily} +%\RequirePackage{marginfix} +%\appto\quote{\normalsize\singlespacing} +%----------------------------------------- +\newcommand\ppages{\pagerange{firstpage\IJSRAidentifier}{lastpage\IJSRAidentifier}} +\newcommand\shorttitle{} +\newcommand\maintitle{} +\newcommand\maintitletoc{\let\\ \relax\maintitle} +\newcommand\shortauthor{} +\newcommand\cmail{} +\newcommand\affiliation{} +\newcommand\thanknote{} + + + + +\def\keywords{} +\def\keywordname{Keywords} + +\newcommand\mypagesize{\newgeometry{% + bindingoffset=0.5cm, % - binding correction + top=3cm, % - total body: top margin + left=2cm, % - total body: left margin (odd pages) + right=2cm, % - total body: right margin (odd pages) + marginparwidth=0cm, % - width for side note + marginparsep=0cm, % - space between notes and body text (content) + bottom=2cm, % - total body: bottom margin + }} +\newcommand\mypartstyle[1]{ +\mypagesize +\part{#1} +\restoregeometry} + + +\newcommand\pcref[1]{\parentext{\cref{#1}}} + +\newcommand{\IJSRAsection}[1]{% + \marginnote{#1}\pdfbookmark[1]{#1}{#1\IJSRAidentifier}% +} +\newcommand{\IJSRAsubsection}[1]{% + \marginnote{#1}\pdfbookmark[2]{#1}{#1\IJSRAidentifier}% +} + \let\ijsrasection\IJSRAsection + \let\ijsrasubsection\IJSRAsubsection +% + +\newcommand\authorone{} +\newcommand\authortwo{} +\newcommand\authorthree{} +\newcommand\authorfour{} +\newcommand\authorfive{} + +\newcommand\affilone{} +\newcommand\affiltwo{} +\newcommand\affilthree{} +\newcommand\affilfour{} +\newcommand\affilfive{} + +\newcommand\affiloneauthor{} +\newcommand\affiltwoauthor{} +\newcommand\affilthreeauthor{} +\newcommand\affilfourauthor{} +\newcommand\affilfiveauthor{} + +\newcommand\bioone{} +\newcommand\biotwo{} +\newcommand\biothree{} +\newcommand\biofour{} +\newcommand\biofive{} + +\newcommand\abstract{} +\undef\abstract{} + +\def\submission{} +\def\acceptance{} + +\undef\authorone{} +\undef\authortwo{} +\undef\authorthree{} +\undef\authorfour{} +\undef\authorfive{} + +\undef\affilone{} +\undef\affiltwo{} +\undef\affilthree{} +\undef\affilfour{} +\undef\affilfive{} + +\undef\affiloneauthor{} +\undef\affiltwoauthor{} +\undef\affilthreeauthor{} +\undef\affilfourauthor{} +\undef\affilfiveauthor{} + +\undef\bioone{} +\undef\biotwo{} +\undef\biothree{} +\undef\biofour{} +\undef\biofive{} + +\def\shortauthor{% + \ifdef{\authorone}{\authorone}{}% + \ifdef{\authortwo}{, \authortwo}{}% + \ifdef{\authorthree}{, \authorthree}{}% + \ifdef{\authorfour}{, \authorfour}{}% + \ifdef{\authorfive}{, \authorfive}{} +} + + + + + + +\newenvironment{IJSRAabstract} +{\list{}{\rightmargin\leftmargin}% +\item \footnotesize\sffamily\textbf\keywordname : \keywords\\ + \itshape + \noindent\item\relax + } +{\endlist} + +\newcommand{\IJSRAseparator}{% + \begin{center} + * * * + \end{center}} + +\newcommand\email{{\normalfont\href{mailto:\cmail}{\cmail}}} + +\newbool{@page} +\newcommand{\pagerange}[2]{%pp.~ + \edef\tempa{\getpagerefnumber{#1}\booltrue{@page}}% + \edef\tempb{\getpagerefnumber{#2}}% + \ifboolexpr{bool{@page}}{}{\tempa--\tempb}} + %\ifdefequal{\tempa}{\tempb}{}{ + + +\providecommand\IJSRAopening{% +\ifbool{issue}{}{\begin{document}} + \begin{refsection} + \setcounter{footnote}{0} + \setcounter{table}{0} + \setcounter{figure}{0} + \renewcommand*{\thefootnote}{\fnsymbol{footnote}} + \phantomsection + \pagestyle{ijsrachapter} + \chapter*{\maintitle} + % \vspace*{2em} +% {\LARGE\sffamily\maintitle}\\[-.3em] + \ifbool{issue}{% +% \pdfbookmark[1]{\shortauthor | \shorttitle}{\shortauthor} + \addcontentsline{toc}{chapter}{\normalfont\shortauthor\protect\newline\emph{\maintitletoc}}}{} + \begin{center} + {\Large\scshape% + \authorone\ifdef{\bioone}{{\footnote[1]{\bioone}}}{}% + \ifdef{\authortwo}{, \authortwo\ifdef{\biotwo}{{\footnote[2]{\biotwo}}}{}}{}% + \ifdef{\authorthree}{, \authorthree\ifdef{\biothree}{{\footnote[3]{\biothree}}}{}}{}% + \ifdef{\authorfour}{, \authorfour\ifdef{\biofour}{{\footnote[4]{\biofour}}}{}}{}% + \ifdef{\authorfive}{, \authorfive\ifdef{\biofive}{{\footnote[5]{\biofive}}}{}}{}% + }% + \\[1em] + \email + \ifdef{\affilone}{\\ \textsuperscript{\ifdef{\affiloneauthor}{$\affiloneauthor$}{}}\affilone}{}% + \ifdef{\affiltwo}{\\ \ifdef{\affiltwoauthor}{\textsuperscript{$\affiltwoauthor$}}{}\affiltwo}{}% + \ifdef{\affilthree}{\\ \ifdef{\affilthreeauthor}{\textsuperscript{$\affilthreeauthor$}}{}\affilthree}{}% + \ifdef{\affilfour}{\\ \ifdef{\affilfourauthor}{\textsuperscript{$\affilfourauthor$}}{}\affilfour}{}% + \ifdef{\affilfive}{\\ \ifdef{\affilfiveauthor}{\textsuperscript{$\affilfiveauthor$}}{}\affilfive}{}% +\end{center} + \vspace{3em} + \pagestyle{scrheadings} + \setcounter{footnote}{0} + \renewcommand*{\thefootnote}{\arabic{footnote}} + \label{firstpage\IJSRAidentifier} + +\ifdef\abstract{% +\begin{IJSRAabstract} +\abstract +\end{IJSRAabstract} +}{} +} + + +\providecommand\IJSRAclosing{% +\ifbool{nobib}{}{\IJSRAseparator\vspace*{-3em} + \printbibliography[heading=subbibliography]} + \end{refsection} + \label{lastpage\IJSRAidentifier} +\undef\authorone{} +\undef\authortwo{} +\undef\authorthree{} +\undef\authorfour{} +\undef\authorfive{} + +\undef\affilone{} +\undef\affiltwo{} +\undef\affilthree{} +\undef\affilfour{} +\undef\affilfive{} + +\undef\affiloneauthor{} +\undef\affiltwoauthor{} +\undef\affilthreeauthor{} +\undef\affilfourauthor{} +\undef\affilfiveauthor{} + +\undef\abstract{} + +\def\submission{} +\def\acceptance{} + +\undef\bioone{} +\undef\biotwo{} +\undef\biothree{} +\undef\biofour{} +\undef\biofive{} +\ifbool{issue}{}{\end{document}}} + +\def\Put(#1,#2)#3{\makebox(0,0){\put(#1,#2){#3}}} + +\def\IJSRAtitlepage{% +\pdfbookmark[1]{Titlepage}{title} +\definecolor{mybluetitle}{RGB}{28,40,65} % HEX 1c2841 +\newgeometry{% + head=0cm, % - no header + foot =0cm, + bindingoffset=0cm, % - binding correction + top=0cm, % - total body: top margin + left=0cm, % - total body: left margin (odd pages) + right=0cm, % - total body: right margin (odd pages) + bottom=0cm, % - total body: bottom margin + marginparwidth=0cm, % - width for side note +} +\thispagestyle{empty} +\pagecolor{mybluetitle} +\Put(0,-.85\textheight+5.3cm){\IJSRAtitlefigure}\\ +\Put(0,-.85\textheight+6cm){\color{mygold}\rule{1.5\linewidth}{5pt}} +\Put(.5\linewidth-3.5cm,-.85\textheight){\includegraphics[width=7cm]{ijsra_logo.png}}\\ + +\vspace{.6\linewidth} +\begin{center}\color{white} +\fontsize{40}{40}\selectfont +International Journal of \\ +Student Research in \\ +Archaeology + +\vfill +\fontsize{15}{15}\selectfont +ISSN: 2398-2012\\ +Issue \IJSRAnumber\,|\,\IJSRAmonth\ \IJSRAyear + +\vspace{2em} +{ijsra.org} +\end{center} +\clearpage\restoregeometry\pagecolor{white}} + + + \DeclareCaptionFormat{listing}{#1#2#3} + \captionsetup[lstlisting]{format=listing,% + singlelinecheck=false, + margin=0pt, + font={sf}, + size=footnotesize} + + + +\renewcommand{\lstlistingname}{Example}%rename caption +\renewcommand{\lstlistlistingname}{List of examples}%rename caption + + +\lstdefinestyle{code}{% + language=[LaTeX]TeX, + backgroundcolor=\color{backcolour}, + commentstyle=\color{codegreen}, + keywordstyle=\color{codeblue}, + numberstyle=\tiny\color{codegray}, + stringstyle=\color{codepurple}, + escapeinside={*@}{@*}, % if you want to add LaTeX within your code + texcsstyle=*\color{codeblue}, + morekeywords={cites, parencites, parencite, textcite, textcites, citeauthor, citetitle,@String, + @Article, @Book,@Collection,@Proceedings,@Reference,@Thesis, + @Inproceedings,@Talk,@Review,@Inreference,@Incollection, + }, + basicstyle=\ttfamily\footnotesize, + breakatwhitespace=false, + breaklines=true, + numberbychapter=false, + captionpos=b, + keepspaces=true, + %framexleftmargin=5mm, + %frame=shadowbox, + rulesepcolor=\color{codeblue}, + numbers=left, + numbersep=5pt, + showspaces=false, + showstringspaces=false, + showtabs=false, + tabsize=2, + literate= + *{\{}{{{\color{codegreen}{\{}}}}{1} + {\}}{{{\color{codegreen}{\}}}}}{1} + {[}{{{\color{codegreen}{[}}}}{1} + {]}{{{\color{codegreen}{]}}}}{1}, +} + + +\lstset{style=code} +%\lstMakeShortInline[style=code]| +% + + +%------------------------------------ + +\RequirePackage{hyperref} % For hyperlinks in the PDF +\hypersetup{ % setup the hyperref-package options + unicode, + colorlinks = true, %Colours links instead of ugly boxes + urlcolor = myblue, %Colour for external hyperlinks + linkcolor = myblue, %Colour of internal links + citecolor = mygold, %Colour of citations + linktoc=page, + pdfborder={0 0 0}, % - + breaklinks=true, % - allow line break inside links + % bookmarksnumbered=true, % + bookmarksopenlevel=2, + % bookmarksopen=false, % + % bookmarks=true, + final=true % = true, only with web-Documents!! +} +\RequirePackage{bookmark} +\RequirePackage{cleveref} + + +\endinput
\ No newline at end of file diff --git a/macros/latex/contrib/ijsra/ijsra.pdf b/macros/latex/contrib/ijsra/ijsra.pdf Binary files differnew file mode 100644 index 0000000000..d4637e4a66 --- /dev/null +++ b/macros/latex/contrib/ijsra/ijsra.pdf diff --git a/macros/latex/contrib/ijsra/ijsra.tex b/macros/latex/contrib/ijsra/ijsra.tex new file mode 100644 index 0000000000..6d9c6ad839 --- /dev/null +++ b/macros/latex/contrib/ijsra/ijsra.tex @@ -0,0 +1,461 @@ +\documentclass[ +% year=2016, +% month=October, +% number=1, +% volume=2, + ]{ijsra} +\def\IJSRAidentifier{\currfilebase} +%--------Author’s names------------ +\def\authorone{Lukas C. Bossert} +%-------Biographical information------------- +\def\bioone{The coding of this documentclass is done at \href{https://github.com/LukasCBossert/documentclass-ijsra}{https://github.com/LukasCBossert/documentclass-ijsra} +\alertwarning{Please know that this documentation may be deprecated since all developments are written down it the wiki of the journal’s repository: \url{https://github.com/LukasCBossert/ijsra/wiki}.}} +%-------Title------------- +\def\maintitle{The \texttt{ijsra}-class, Version \IJSRAversion\ -- \IJSRAversiondate} +\def\shorttitle{\maintitle} +\def\abstract{This is a documentation of the class \texttt{ijsra} which is used for the + \emph{International Journal of Student Research in Archaeology}. + Read this documentation carefully. + When you start editing do it according to the structure shown in \cref{document}.} +%------University/Institution-------------- +\def\affilone{digitales-altertum|de} +%--------Email------------ +\def\cmail{lukas@digitales-altertum.de} +%\def\keywordname{} +\def\keywords{documentclass, \LaTeX , IJSRA} +%-------------------------------------------------------------- + + +\begin{filecontents}{\IJSRAidentifier.bib} + + @Book{Winckelmann2006, + title = {History of the Art of Antiquity}, + publisher = {Getty Research Institute}, + year = {2006}, + author = {Winckelmann, J. J.}, + location = {Los Angeles}, + origdate = {1764}, + related = {Winckelmann1764}, + relatedtype = {translationof}, + translator = {Mallgrave, Harry Francis}, + } + + @Book{Winckelmann1764, + title = {Geschichte der Kunst des Alterthums}, + publisher = {Walther}, + year = {1764}, + author = {Winckelmann, J. J.}, + location = {Dresden}, + } + + +@Incollection{Orengo2015, + author = {Orengo, H.}, + title = {Open Source GIS and Geospatial Software in Archaeology}, + subtitle = {Towards Their Integration into Everyday Archaeological Practice}, + pages = {64--82}, + editor = {Wilson, A. T. and Edwards, B.}, + booktitle = {Open Source Archaeology}, + booksubtitle = {Ethics and Practice}, + publisher = {deGruyter Open}, + location = {Warsaw}, + year = {2015}, +} + +@Article{Pikirayi2015, + author = {Pikirayi, I.}, + title = {The Future of Archaeology in Africa}, + journaltitle = {Antiquity}, + volume = {89}, + pages = {531--541}, + year = {2015}, + issue = {345}, +} + +@Article{Bossert-ijsra, + author = {Lukas C. Bossert}, + title = {›ijsra‹ -- bib\LaTeX-style which is used for the \emph{International Journal of Student Research in Archaeology}}, + subtitle = {Version: 0.1}, + url = {http://www.ctan.org/pkg/biblatex-ijsra}, + keywords = {latex}, + year ={2016}, + note = {https://github.com/LukasCBossert/biblatex-ijsra}, + owner = {Lukas C. Bossert}, + timestamp = {2016-07-04}, +} + +\end{filecontents} + +\lstMakeShortInline[style=code]| +\IJSRAopening + + +%\IJSRAseparator + +\lettrine{E}{very} article\IJSRAsection{starting} starts with a lettrine as the first letter. +This bigger letter functions as an eye catcher to make clear where the article starts. +It effects the whole word: The first letter reaches down to the third line, the other letters of the word are capitalised. +In \cref{lettrine} you see the code how this is achieved. + + \begin{lstlisting}[label=lettrine,caption={Starting letter}] +\lettrine{E}{very} article ... +\end{lstlisting} +If you have a letter which is rather slanted you can define the slope. +Let’s have a look at the letter ›A‹. + \begin{lstlisting}[label=lettrine,caption={Starting letter ›A‹}] +\lettrine[slope=4pt,findent=-3pt]{A}{rchaeologists} … +\end{lstlisting} +And it changes of course if we start the article with a ›W‹. + \begin{lstlisting}[label=lettrine,caption={Starting letter ›W‹}] +\lettrine[slope=-4pt,nindent=-4pt]{W}{hen} ... +\end{lstlisting} + +\IJSRAseparator +The |tex|-file \IJSRAsection{document class}of each article starts with the definition of the document class. +Herefor we use the destinctive class |ijsra| and load it with this line: +\begin{lstlisting}[label=documentclass,caption={First line of tex-file.}] +\documentclass[<options>]{ijsra} +\end{lstlisting} +For |<options>| you can use e.g. |draft|: this will omitt the figures and gives you a white frame with the size of the figures instead. +The advantage is faster compiling. + +\IJSRAseparator +Each article contains several information about the author(s), title etc. +The document class can cope easily with one to five authors and their affiliation. +Above that manual work is needed. +The information about author, title, affiliation, biography etc are written into curly brackets. +\begin{lstlisting}[label=information,caption={Information about the article}] +\def\IJSRAidentifier{\currfilebase} %<---- do not change this! +%-------Title | Email | Keywords | Abstract------------- +\def\shorttitle{Jons short title} +\def\maintitle{Jons very long title about his paper} +\def\cmail{John@Doe.com}%<---- corresponding email-address +\def\keywords{Research, Archaeology, ...} +%\def\keywordname{}%<--- redefine the name ›Keywords‹ in needed language +\def\abstract{In his paper Jon is showing ...} +%--------Author names------------ +\def\authorone{Jon Doe} +%\def\authortwo{}%<---- comment/delete if there is no second author. +%\def\authorthree{}%<---- comment/delete if there is no third author. +%\def\authorfour{}%<---- comment/delete if there is no fourth author. +%\def\authorfive{}%<---- comment/delete if there is no fifth author. +%-------Biographical information------------- +\def\bioone{Jon Doe is doing his research about ...} +%\def\biotwo{}%<---- comment/delete if there is no second author. +%\def\biothree{}%<---- comment/delete if there is no third author. +%\def\biofour{}%<---- comment/delete if there is no fourth author. +%\def\biofive{}%<---- comment/delete if there is no fifth author. +%------University/Institution-------------- +\def\affilone{Jon Doe’s university or institution} +%\def\affiltwo{}%<---- comment/delete if there is no second author. +%\def\affilthree{}<---- comment/delete if there is no third author. +%\def\affilfour{}<---- comment/delete if there is no fourth author. +%\def\affilfive{}<---- comment/delete if there is no fifth author. +%--------Mapping of authors to their affiliations------------ +%% authorone:--> * <--- copy/paste that symbol +%% authortwo:--> † <--- copy/paste that symbol +%% authorthree:--> ‡ <--- copy/paste that symbol +%% authorfour: --> § <--- copy/paste that symbol +%% authorfive: --> ¶ <--- copy/paste that symbol +%----------------------------------------------------------------- +%\def\affiloneauthor{}%<---- paste the symbol of the authors into {} +%\def\affiltwoauthor{}%<---- paste the symbol of the authors into {} +%\def\affilthreeauthor{}%<---- paste the symbol of the authors into {} +%\def\affilfourauthor{}%<---- paste the symbol of the authors into {} +%\def\affilfiveauthor{}%<---- paste the symbol of the authors into {} +\end{lstlisting} +\IJSRAseparator +After the definitions there is the block regarding the bibliographical entries. +Those are written in the section +\begin{lstlisting}[label=bibliography,caption={Bibliographical information}] +\begin{filecontents}{\IJSRAidentifier.bib} %<--- do not change this + +@Incollection{Orengo2015, + author = {Orengo, H.}, + title = {Open Source GIS and Geospatial Software in Archaeology}, + subtitle = {Towards Their Integration into Everyday Archaeological Practice}, + pages = {64--82}, + editor = {Wilson, A. T. and Edwards, B.}, + booktitle = {Open Source Archaeology}, + booksubtitle = {Ethics and Practice}, + publisher = {deGruyter Open}, + location = {Warsaw}, + year = {2015}, +} + +@Article{Pikirayi2015, + author = {Pikirayi, I.}, + title = {The Future of Archaeology in Africa}, + journaltitle = {Antiquity}, + volume = {89}, + pages = {531--541}, + year = {2015}, + issue = {345}, +} + +@Article{Bossert-ijsra, + author = {Lukas C. Bossert}, + title = {›ijsra‹ -- bib\LaTeX-style which is used for the \emph{International Journal of Student Research in Archaeology}}, + subtitle = {Version: 0.1}, + url = {http://www.ctan.org/pkg/biblatex-ijsra}, + keywords = {latex}, + note = {https://github.com/LukasCBossert/biblatex-ijsra}, + owner = {Lukas C. Bossert}, + timestamp = {2016-07-04}, +} +. +. +. + @Book{Winckelmann2006, + title = {History of the Art of Antiquity}, + publisher = {Getty Research Institute}, + year = {2006}, + author = {Winckelmann, J. J.}, + location = {Los Angeles}, + origdate = {1764}, + related = {Winckelmann1764}, + relatedtype = {translationof}, + translator = {Mallgrave, Harry Francis}, + } + + @Book{Winckelmann1764, + title = {Geschichte der Kunst des Alterthums}, + publisher = {Walther}, + year = {1764}, + author = {Winckelmann, J. J.}, + location = {Dresden}, + } + + +\end{filecontents} +\end{lstlisting} + +After that we have completed the preamble and get to main part of the document. +Here we define the layout of the headline. + +\begin{lstlisting}[label=headline,caption={Headline layout}] +\IJSRAopening %<---- do not change or forget this +\end{lstlisting} + +\IJSRAseparator +Then you can copy/paste the text of the article and make further editing. +At the very end you have to insert +\begin{lstlisting}[label=closing,caption={IJSRAclosing}] +\IJSRAclosing +\end{lstlisting} + + +Following there is a minimal template how the plain document should look like when you begin to edit and there is only one author. +\begin{lstlisting}[label=document,caption={Plain document}] +\documentclass{ijsra} +\def\IJSRAidentifier{\currfilebase} %<---- do not change this! +\def\shorttitle{Jons short title} +\def\maintitle{Jons very long title about his paper} +\def\cmail{John@Doe.com} +\def\keywords{Research, Archaeology, ...} +%\def\keywordname{} +\def\abstract{In his paper Jon is showing ...} +\def\authorone{Jon Doe} +\def\bioone{Jon Doe is doing his research about ...} +\def\affilone{Jon Doe’s university or institution} +\begin{filecontents}{\IJSRAidentifier.bib} +Bibliography-files +\end{filecontents} + +\begin{document} +\IJSRAopening + +\lettrine{M}{ain} text ... + +\IJSRAclosing +\end{document} +\end{lstlisting} +Since we only have one author there is no need to specify the connection of |\authorone| to |\affilone| since this is done automatically. +As soon as you have more than one author you need to do the mapping by copying the symbols ( * † ‡ § ¶ ) into the right |\affiloneauthor| or |\affiltwoauthor|. + +Before we have a closer look how to do certain editing +let me give you some advice about naming the |tex|-file and the related figures. +The |tex|-file has to be saved under an unique and individual name. +Usually this is the family name of the author: e.g. |winckelmann.tex| +If you think this is not enough because the author has quite a common family (as it might be with \emph{Johnson}) +plese use a word from the title, e.g. |Johnson_prehistory.tex|. +Notice there must not be a blank in the name, use instead |_| or |-|. + +The name of the |tex|-file is what we have defined as the |\IJSRAidentifier|, +with that we can differentiate between all the texts from the authors. + +We need this |IJSRAidentifier| again for the figures: +put the figures in a folder called |figures|. +Do not name the figures e.g. |figure1|, |figure2| etc. but use again this +|IJSRAidentifier| (e.g. |Johnson_prehistory|) and name the figures like this: +|Johnson_prehistory_fig01.jpg| or |winckelmann_fig01.png|. +You can also name tables in the same way: +|Johnson_prehistory_tab01.jpg| or |winckelmann_tab01.png|. + +\alertinfo{But please make sure that the \emph{IJSRAidentifier} is used with correct spelling of the author’s name etc.} + +\IJSRAseparator +As \IJSRAsection{sections}a subdivison of the paper into section we use the code |\IJSRAsection{<<section name>>}|. + +Be aware to insert the code \emph{after} the first word of the paragraph under the section heading. + +\begin{lstlisting}[label=section,caption={Section}] +This\IJSRAsection{New Paragraph} is a new paragraph under the section with the title ›New Paragraph‹. +\end{lstlisting} +There is also the possibility to do a \IJSRAsubsection{subsections} |\IJSRAsubsection{<<subsection name>>}|. It will be displayed as a |\IJSRAsection{<<section name>>}| but in the pdf-bookmarks there is a differentiation. + +\alertwarning{This code may conflict with wrapfigures since the section title and the wrapfigure use the margin space. +In that case you have to move the wrapfigure further up or further down.} + + +\IJSRAseparator +How to do quotes:\IJSRAsection{quotes} +Quotes are inserted between the enviroment |IJSRAquote|. +Let me give you an example: + +\begin{lstlisting}[label=quote,caption={Quote}] +\blockcquote[see][112]{Winckelmann2006}{Grace can never properly be said to exist without beauty; for it is only in the elegant proportions of beautiful forms that can be found that harmonious variety of line and motion which is the essence and charm of grace.} +\end{lstlisting} +It will be displayed as this: + + +\blockcquote[see][112]{Winckelmann2006}{Grace can never properly be said to exist without beauty; for it is only in the elegant proportions of beautiful forms that can be found that harmonious variety of line and motion which is the essence and charm of grace.} + +There is also a way to cite foreigntext-quotes: +\begin{lstlisting}[label=quoteforeign,caption={Quote}] +\foreignblockcquote{ngerman}[see][12]{Winckelmann1764}{Es kann leichter von der Schönheit gesagt werden, was sie nicht ist, als was sie ist; und es verhält sich einigermaßen mit der Schönheit und ihrem Gegenteile, wie mit Gesundheit und Krankheit: diese fühlen wir und jene nicht.} +\end{lstlisting} +\foreignblockcquote{ngerman}[see][12]{Winckelmann1764}{Es kann leichter von der Schönheit gesagt werden, was sie nicht ist, als was sie ist; und es verhält sich einigermaßen mit der Schönheit und ihrem Gegenteile, wie mit Gesundheit und Krankheit: diese fühlen wir und jene nicht.} + +Of course you can also use |\blockquote[Author]{QUOTE}| for a not-citable author of the quote. +Same for |\foreignblockquote[Author]{QUOTE}| + +\IJSRAseparator +You can\IJSRAsection{separator} insert a separation mark between some paragraphs, +as it is inserted automatically just before the bibliography. +For that we edited a special form a separation mark. +You can use it with |\IJSRAseparator|. +\IJSRAseparator +There \IJSRAsection{figures}are two ways to insert a figure into the text. +First by using the plain enviroment |figure| + +\begin{lstlisting}[label=figure,caption={figure}] +\begin{figure} +\includegraphics[width=\linewidth]{NAME_OF_THE_FIGURE_WITHOUT_SUFFIX} +\caption{<<Description of the figure>> + {\normalfont \\ \copyright\ by NAME OF COPYRIGHT HOLDER}} +\label{fig:NAME_OF_THE_FIGURE_WITHOUT_SUFFIX} +\end{figure} +\end{lstlisting} + +Second by using the enhanced enviroment |wrapfigure| + +\begin{lstlisting}[label=wrapfigure,caption={wrapfigure}] +\begin{wrapfigure}{O}{0.5\textwidth} +\centering +\includegraphics[width=\linewidth]{NAME_OF_THE_FIGURE_WITHOUT_SUFFIX} +\caption{<<Description of the figure>> + {\normalfont \\ \copyright\ by NAME OF COPYRIGHT HOLDER}} +\label{fig:NAME_OF_THE_FIGURE_WITHOUT_SUFFIX} +\end{wrapfigure} +\end{lstlisting} +Since you (hopefully) place the figures into the folder named |figures| there is no need to tell the path, the figure name is sufficient. +\IJSRAseparator +When suitable \IJSRAsection{caption}we try to insert figures as a |wrapefigure| into the text. +Otherwise we insert them into the |figure|-enviroment. + +If you have a table which is saved as a figure, +you have to make a change to the caption. +I show you how to do that. +\begin{lstlisting}[label=caption,caption={Modify the caption}] +\captionof{table}{Put the caption here.} +\end{lstlisting} + +\IJSRAseparator +Modifying\IJSRAsection{references} e.g. the caption is important for referencing in the text. +We use the special macro |\cref{label}| to reference to a figure, a table or anything else. +It makes it easier because we can omit to write ›fig.‹ or ›table‹ before the number of the figure or the table. +The correct form (›fig.‹ etc.) will be inserted automatically by \LaTeX . +If you like to have the first letter capitalised you can use |\Cref| instead. + +Furthermore you can insert several |label| into a |\cref| by |\cref{label1,label2,label3}|. + +\IJSRAseparator +If you\IJSRAsection{numbers \& units} have a number or a number with an unit, +please use the macros which are provided my |\SI|. +Let me show you some examples. +\begin{labeling}{range phrase (1)} +\item[meter] |100 m| has to be written as |\SI{100}{\meter}|; +\item[percent] |75 %| has to be written as |\SI{75}{\percent}|; +\item[range phrase (1)] |10x10 m| has to be written as |\SIrange{10}{10}{\meter}|; +\item[range phrase (2)] |10--15 cm| has to be written as |\SIrange[range-phrase=--]{10}{15}{\centi\meter}|; +\item[number] |23.394| has to be written as |\num{23394}|; +\item[angle] |56°| has to be written as |\ang{56}|; +\item[round precision] If you want to make a round precision of your numbers you can set it yourself by |\SI[round-precision=2]{23.3390}{\meter}| which will make |23.34 m|. +\end{labeling} + + + +\IJSRAseparator +We have\IJSRAsection{Different abstracts} the abstract of the article in english in the beginning, +just as shown in the template in \cref{document,abstract}. +If there is another abstract in a different language we put that at the end of the article. +For that we need also to redefine the keywords and usually the name \emph{keywords} according to the language of the abstract. + +I give you an example how to edit a second abstract. +\begin{lstlisting}[label=abstract2,caption={Different abstract}] +\def\keywordname{Mots clés} +\def\keywords{keywords in French, \LaTeX , IJSRA, journal} +\foreignlanguage{french}{% +\begin{IJSRAabstract} +Abstract\IJSRAsection{Abstract (French)} in French: Copy and paste the abstract in the different language here! +\end{IJSRAabstract} +} +\end{lstlisting} +\def\keywordname{Mots clés} +\def\keywords{keywords in French, \LaTeX , IJSRA, journal} +\foreignlanguage{french}{% +\begin{IJSRAabstract} +Abstract\IJSRAsection{Abstract (French)} in French: Copy and paste the abstract in the different language here! +\end{IJSRAabstract} +} + +%Do not forget to add the language in the options of the documentclass +%\begin{lstlisting}[label=abstract2,caption={Add the language of the abstract into the preamble}] +%\documentclass[ +% french,%<--- add the language if not English +% ]{ijsra} +%\end{lstlisting} + + +\IJSRAseparator +Global options: These options can be used and set to the current number: +|month|, +|year|, +|volume|, +|number|. + +Furthermore you can set the document to |draft| or give the name of the title figure with |titlefigure|. +The title figure has to be within the folder |figures| and be in an aspect ratio of \SIrange{1000}{400}{pt}. + +\IJSRAseparator +Some general information: +% \begin{itemize} +% \item Be aware of different brackets, e.g. |[] {}|; +% These are part of \LaTeX -programming-language, every opening bracket needs a closing one. +% \item Replace e.g. |19 %| with |\SI{19}{\percent}| otherwise everything after |%| will be omitted by \LaTeX; +% \item Replace |&| with |\&|; +% \item Replace the citation of authors (e.g |Blesser \& Salter 2006|) with |\cite{Blesser2006}|; +% if you have a page-range write: |\cite[23--45]{Blesser2006}|; +% \item To compile with bibliography-references; +% use 1 $\times$ \hologo{XeLaTeX}, then 1 $\times$ compiler ›biber‹, then 1 $\times$ \hologo{XeLaTeX}. +% \item If you want to know how to cite properly +% please have a look at the documentation of \texttt{biblatex-ijsra}.\footnote{\cite[see][]{Bossert-ijsra};\\ \url{http://mirrors.ctan.org//macros/latex/contrib/biblatex-contrib/biblatex-ijsra/biblatex-ijsra.pdf}} +% \end{itemize} +\nocite{*} + +\IJSRAclosing + +%\clearpage +%You find the code using to write this documentation below. +%\lstinputlisting[language={[AlLaTeX]{TeX}}]{\jobname.tex} diff --git a/macros/latex/contrib/ijsra/ijsra_logo.png b/macros/latex/contrib/ijsra/ijsra_logo.png Binary files differnew file mode 100644 index 0000000000..6a01af992f --- /dev/null +++ b/macros/latex/contrib/ijsra/ijsra_logo.png |