summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/biblatex-contrib/biblatex-ijsra/biblatex-ijsra.tex
blob: abe6cb56908eb2dceb9a1011ae94bad8eccb321e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
% ijsra --%
%           
% Copyright (c) 2016 Lukas C. Bossert
%  
% 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
% and version 1.3 or later is part of all distributions of LaTeX
% version 2005/12/01 or later.
%
%!TEX program = xelatex
\documentclass[a4paper,
10pt,
english
]{ltxdoc}
\input{ijsra-preamble.tex}
\begin{document}
\title{\texttt{ijsra} -- \\\texttt{bib\LaTeX}-style of the journal \emph{International Journal of Student Research in Archaeology}\footnote{The development of the code is done at \url{https://github.com/LukasCBossert/biblatex-ijsra}.}}
\author{Lukas C. Bossert\thanks{\href{mailto:lukas@digitales-altertum.de}{lukas@digitales-altertum.de}}}
\date{Version: 0.1 (2016-07-04)}
 \maketitle
\begin{abstract}
Bibliographical style called \emph{ijsra} which is done for the journal \href{http://www.ijsra.org}{\emph{International Journal of Student Research in Archaeology}} (IJSRA).
 \end{abstract}

\section{Usage}
 \DescribeMacro{ijsra}  The name of the bib\LaTeX-style is  |ijsra| has to be activated in the preamble. 

\begin{lstlisting}
\usepackage[style=ijsra,%
					*@\meta{further options}@*]{biblatex}
\bibliography*@\marg{|bib|-file.|bib|}@*
\end{lstlisting}


At the end of your document you can write the command |\printbibliography| to print 
the bibliography. 
Further information are found below   (\cref{bibliographie}).

\section{Overview}\label{overview}

\DescribeMacro{\cite}%
As always citing is done with \cs{cite}:
\begin{lstlisting}
\cite*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}%@*
\end{lstlisting}

\meta{prenote} sets a short preliminary note (e.\,g. \enquote{e.\,g.}) and \meta{postnote} is usually used for page numbers.
If only one optional argument is used then it is \oarg{postnote}.
\begin{lstlisting}
\cite*@\oarg{postnote}\marg{bibtex-key}%@*
\end{lstlisting}
The \meta{bibtex-key} corresponds to the key from the bibliography file.

\DescribeMacro{\cites}
If one wants to cite several authors or works a very convenient way is the following using the \cs{cites}-command:
\begin{lstlisting}
\cites(pre-prenote)(post-postnote)*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*%
 																	*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*%
 																	*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}\ldots@*
\end{lstlisting}
 
\DescribeMacro{\parencite}
Sometimes a citation has to be put in parentheses. 
Therefore we implemented the command \cs{parencite}:
\begin{lstlisting}
\parencite*@\oarg{postnote}\marg{bibtex-key}%@*
\end{lstlisting} 
This cite command takes care of the correct corresponding parentheses and brackets.
Especially in |@Inreference| citations the parentheses are changing to (square) brackets.


\DescribeMacro{\parencites}
Of course there is also the possibility to cite several authors/works in parentheses.
This is done with \cs{parencites}:
\begin{lstlisting}
\parencites(pre-prenote)(post-postnote)*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*%
 																			*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*%
 																			*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}\ldots@*
\end{lstlisting}
 
\DescribeMacro{\textcite}
Beside the listed \cs{cite} commands above there is a third way of citing:
\cs{textcite} is useful if the author should be mentioned in the text and
the remaining components such as year and page will immediately follow in parentheses. 
\begin{lstlisting}
\textcite*@\oarg{postnote}\marg{bibtex-key}%@*
\end{lstlisting} 

\DescribeMacro{\textcites}
And again there is also a \cs{textcites} in case of several authors: 
  \begin{lstlisting}
\textcites(pre-prenote)(post-postnote)*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*%
 																			*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*%
 																			*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}\ldots@*
\end{lstlisting}

\DescribeMacro{\citeauthor}\DescribeMacro{\citetitle}\label{citeauthor}%
Furthermore and additionally to the ›normal‹ \cs{cite}-commands one can also cite only the author or the work title in the text and in the footnotes.
\begin{lstlisting}
\citeauthor*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}%@*
\end{lstlisting} 
  and for the works 
\begin{lstlisting}
\citetitle*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}%@*
\end{lstlisting} 


 \section{Bibliography}\label{bibliographie}
 \DescribeMacro{\printbibliography}
But first we define the heading of the whole  bibliography:
\begin{lstlisting}
\printbibheading[%
							heading=bibliography,%
							%heading=bibnumbered,% if you want it numbered
							title={Bibliography}] %heading for bibliography
\end{lstlisting}
You can give any title you would like to give (|title = |\marg{any title}).

Finally the bibliography:
\begin{lstlisting}
\printbibliography[%
							heading=subbibliography,
							%heading=subbibnumbered,% if you want it numbered
							title={Secondary literature}]
\end{lstlisting}

%\nocite{*}
%\begin{bsp}
%\renewcommand\bibfont{\normalfont\footnotesize}
%\printbibheading[%
%							heading=bibliography,%
%							title={Bibliography}] %heading for bibliography
%\printbibliography[%
%							notkeyword=ancient,%
%							notkeyword=corpus,%
%							heading=subbibliography,
%							title={Secondary literature}]
%\end{bsp}
%
%\begin{lstlisting}
%
%@Book{Amedick1991,
%  author    = {Amedick, Rita},
%  title     = {Die Sarkophage mit Darstellungen aus dem Menschenleben},
%  subtitle  = {Vita Privata},
%  publisher = {Berlin},
%  year      = {1991},
%  maintitle = {Die antiken Sarkophagreliefs},
%  volume    = {1.4},
%}
%
%
%\end{lstlisting}
\end{document}