%%  BibArts 2.6 assists you to write LaTeX texts in arts and humanities.
%%  Copyright (C) 2023  Timo Baumann  bibarts[at]gmx.de  (2023/06/18)
%%%  LaTeX  +  "bibsort -i ba-short -m -utf8 -k -e -h"  +  LaTeX  %%%


   \documentclass[12pt,a4paper]{article}

   \usepackage[utf8]{inputenc} 
   \usepackage[OT1]{fontenc}  %%\usepackage[T1]{fontenc}
	
   %\usepackage[english]{babel}
   %\sethyphenation{USenglish}

\usepackage{bibarts}	
\bacaptionsenglish
\setlength{\footnotesep}{2ex}  %% as in bibarts.sty 2.0; see README.txt %%

  \hyphenation{Last-Name}

  \title{The \LaTeX\hy Package \BibArts \\[1.25ex] {\normalsize\slshape 
  A package to assist in making bibliographical features \\[-1.25ex] common
  in the arts and humanities}}
  
  \author{\scshape Timo Baumann}
  
  \date{\small Version 2.6 (2023). \hspace{2.25em} \copyright\ 2.x
  (2015$-$2023).}

  \setcounter{secnumdepth}{0}
  %\renewcommand{\kxxemph}{\em}

     \newcommand{\pkTitle}{k\kern -0.05em Title}
     \newcommand{\kTitle}{\sort{kTitle}\protect\pkTitle}
                        
     \newcommand{\pbs}{\string\ \unskip}
     \newcommand{\bs}{\protect\pbs}

     \let\lbashortmem=\{
     \let\rbashortmem=\}
     \renewcommand{\{}{{\normalfont\lbashortmem}}
     \renewcommand{\}}{{\normalfont\rbashortmem}}

\long\def\Doppelbox#1#2{\nopagebreak\vspace{2.25ex}%
   {\fbox{\parbox{.45\textwidth}{\frenchspacing\raggedright
      \footnotesize\ttfamily
      \ignorespaces #1}\hfill
     \parbox{.45\textwidth}{\vspace{1ex}%
      \begin{minipage}{.45\textwidth}\sloppy\small
      \renewcommand{\thempfootnote}{\arabic{mpfootnote}}%
      \setcounter{mpfootnote}{\arabic{footnote}}%
      {\ignorespaces #2}%
       \setcounter{footnote}{\arabic{mpfootnote}}%
      \end{minipage}
    \vspace{1ex}}}\vspace{2.4ex}}}

\let\mempage=\thepage 
\renewcommand{\pbapageframe}[1]{\underline{#1}}
\renewcommand{\thepage}{\textit{\bapageframe{\roman{page}}}}
\pagestyle{myheadings}



\begin{document}

\maketitle \thispagestyle{empty}

{\footnotesize\tableofcontents}

\vfill\noindent\rule{\textwidth}{.1pt}

\vspace{1.75ex}
\hbox{\parbox{7.7cm}{\footnotesize\noindent
\textbf{\BibArts~2.6 (9 files, 8 dated 2023/06/18):} \\[.875ex]
 \begin{tabular}{ll}%
 \texttt{README.txt}   & Version history since 1.3       \\[-1.75pt]
 \texttt{bibarts.sty}  & The \LaTeX\ style file          \\[-1.75pt]
 \texttt{ba-short.pdf} & This documentation here         \\[-1.75pt]
 \texttt{ba-short.tex} & Source of \texttt{ba-short.pdf} \\[-1.75pt]
 \texttt{bibarts.pdf}  & Full documentation (German)     \\[-1.75pt]
 \texttt{bibarts.tex}  & Source of \texttt{bibarts.pdf}  \\[-1.75pt]
 \texttt{bibsort.exe}  & bibarts-bin to create the lists \\[-1.75pt]
 \texttt{bibsort.c}    & Source of \texttt{bibsort.exe}  \\[-1.75pt]
 \texttt{COPYING}      & License (dated 1993/11/28)      \\
 \end{tabular}} 
\\
\hspace*{2.4mm}
\parbox{5.6cm}{\vspace{-.4ex}%
  {\footnotesize\normalfont
   \hfil\texttt{bibarts}\kern.075em(\kern-.05em at\kern-.075em)\kern.075em\texttt{gmx.de}} \\[1.4ex]
   \tiny\sffamily
    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
}}


\newpage
\section{Introduction}
 Type \verb|\usepackage{bibarts}| in your \textit{file}.\texttt{tex}, and let
 \verb|\bacaptionsenglish| or \verb|\bacaptionsgerman| or
 \verb|\bacaptionsfrench| follow. In this file here, the mode is 
 \verb|\bacaptionsenglish| \hspace{.05em}(to get a `p.\ko' in front of
 page numbers, etc.).

 \vspace{1ex}\noindent 
 The idea is to begin with the full reference (page numbers \verb|[Pg]| are optional)

 \vspace{-.4ex}
 \Doppelbox
 {
  \bs vli\{FirstName\}\{LastName\}
  \\ \ \ \{The \bs ktit\{kTitle\}, 
  \\ \ \ \ place and year of 
  \\ \ \ \ publication\}[Pg].
 }
 {
  \vli{FirstName}{LastName}
   {The \ktit{\kTitle}, place and year of publication}[Pg].
 }

 \vspace{-.25ex}\noindent 
 ...\ because \BibArts\ uses such full citations to create the 
 List of Literature automatically (see
 \verb|\printvli| on p.\,\pageref{appendix}). UTF-8 is usual today,
 and you can enter at the prompt: 
 \hspace{.5em}(1)\texttt{~}\LaTeX\texttt{~}\textit{file}, 
 \hspace{.5em}(2)\texttt{~}\texttt{bibsort~-utf8}\hspace{.65em}\textit{file}, 
 \hspace{.5em}(3)\texttt{~}\LaTeX\texttt{~}\textit{file}.

 \vspace{1ex}\noindent 
 After the first full citation (\kern -0.02em\texttt{v}oll), you can use
 shortened references (\texttt{k}urz\kern -0.02em):
 
 \vspace{-.6ex}
 \Doppelbox
 {
  \bs kli\{LastName\}\{kTitle\}[Pg].
 }
 {\vspace{1.75ex}
  \kli{LastName}{\kTitle}[Pg].
 }

 \vspace{-.3ex}\noindent 
 Use \verb|\vqu| \hspace{.1em}and \verb|\kqu| \hspace{.1em}in the same way
 to cite published documents (\kern-0.04em\textsf{Qu}ellen\kern-0.025em):

 \vspace{-.25ex}
 \Doppelbox
 {
  \bs vqu \{Carl von\} \{Clausewitz\} \{\bs ktit\{Vom Kriege\}.
  \\ \ Hinterlassenes Werk, 3\bs fup\{rd\} 
  \\ \ ed.\bs\ Frankfurt/M. 1991\}[3].
  \\[2.6ex] 
  \bs kqu\{Clausewitz\}\{Vom Kriege\}[3].
 }
 {
  \vqu {Carl von} {Clausewitz} {\ktit{Vom Kriege}.
  Hinterlassenes Werk, 3\fup{rd} ed.\ Frankfurt/M. 1991}[3].
  \\[1.25ex] 
  \kqu{Clausewitz}{Vom Kriege}[3].
 }

 \vspace{-.25ex}\noindent 
 Then, \verb|\printvqu| will print a List of Published Documents (full
 references\kern-0.02em).

 \vspace{1.25ex}\noindent 
 And \verb|\printnumvkc| (p.\,\pageref{vkc}) will print an index of all your
 shortened references (created from \verb|\kli|, \verb|\kqu|, and the last names
 plus \verb|\ktit| \hspace{.05em}in \verb|\vli| or \verb|\vqu|).
 
 \vspace{.75ex}\vfill\noindent 
 \BibArts\ also provides commands for citing periodicals and unpublished records:
 
 \vspace{-.35ex}
 \Doppelbox
 {
  \bs per\{Journal Name\}\string_Num\string_[Pg]
  \\[1ex]
  \bs arq\{Unpublished Document\}
  \\ \ \{Archive Signature\}\string|Vol\string|(Folio)
 }
 {
  \per{Journal Name}_Num_[Pg]
  \\[.5ex]        
  \arq{Unpublished Document}
   {Archive Signature}|Vol|(Folio)
 }

 \vspace{-.25ex}\noindent 
 Spaces in front of the optional arguments \verb+_Num_+ or \verb+|Vol|+, 
 \verb+[Pg]+ or \verb+(Folio)+ are forbidden. \verb|\printper| 
 prints a List of Journals, \verb|\printarq| of Signatures.


\newpage

 \noindent 
 In footnotes, you do not have to put \textsc{ibidem} yourself. \BibArts\ 
 detects repeatedly cited sources and changes \verb|\kli|, \verb|\kqu|,
 \verb|\per| and \verb|\arq| \hspace{.1em}automatically:


\setcounter{footnote}{0}
{\footnotesize\begin{verbatim}
 <1>  ...\footnote{ \vli{Niklas} {Luhmann} {\ktit{Soziale Systeme}.
             Grundriß einer allgemeinen Theorie, Frankfurt/M. 1984}.}

 <2>  ...\footnote{\kli{Luhmann}{Soziale Systeme}|1|[22], and 
                   \kli{Luhmann}{Soziale Systeme}|1|[23].}
 <3>  ...\footnote{\kli{Luhmann}{Soziale Systeme}|1|[23]. Next sentence.}
 <4>     \footnote{\kli{Luhmann}{Soziale Systeme}|2|[56].}

 <5>  ...\footnote{\arq{Haber to Kultusminister, 17 December 1914}
           {GStAPK, HA\,1, Rep~76~Vc, Sekt~1, Tit~23, 
             Litt~A, Nr.\,108}|2|(223\f).}

 <6>     \footnote{\arq{Setsuro Tamaru to Clara Haber, 24 December 1914} 
           {GStAPK, HA\,1, Rep~76~Vc, Sekt~1, Tit~23,
             Litt~A, Nr.\,108}|2|(226-231).}

 <7>     \footnote{\arq{Setsuro Tamaru to Clara Haber, 24 December 1914} 
           {GStAPK, HA\,1, Rep~76~Vc, Sekt~1, Tit~23,  % use copy & paste
             Litt~A, Nr.\,108}|2|(226-231).}           % to repeat exactly

 <8>     \footnote{\arq{Valentini to Schmidt, 13 March 1911} 
           {GStAPK, HA\,1, Rep~76~Vc, Sekt~1, Tit~23, 
             Litt~A, Nr.\,108}|1|(47).}

   \fillarq{GStAPK, HA\,1, Rep~76~Vc, Sekt~1, Tit~23, 
             Litt~A, Nr.\,108} {2\,Vols.}
\end{verbatim}}

 \noindent
 When you introduce a book,\footnote{ \vli{Niklas} {Luhmann} {\ktit{Soziale
 Systeme}. Grundriß einer allgemeinen Theorie, Frankfurt/M. 1984}.} you are
 free to add a \verb+|Vol|+, or not. But when you use \verb+|Vol|+ once, you
 will have to repeat that, if you refer to the same book in the following
 footnote again (or say \verb|\clearbamem|). \verb+[Pg]+ is equivalent. You
 may also cite one work several times in the same
 footnote.\footnote{\kli{Luhmann}{Soziale Systeme}|1|[22], and
 \kli{Luhmann}{Soziale Systeme}|1|[23].}\,% 
 \footnote{\kli{Luhmann}{Soziale Systeme}|1|[23]. Next sentence.}\,%
 \footnote{\kli{Luhmann}{Soziale Systeme}|2|[56].}

  \vspace{1ex}\noindent
  And here are examples about how to cite archive 
  sources.%
  \footnote{\arq{Haber to Kultusminister, 17 December 1914}
    {GStAPK, HA\,1, Rep~76~Vc, Sekt~1, Tit~23, 
     Litt~A, Nr.\,108}|2|(223\f).}\,%
  \footnote{\arq{Setsuro Tamaru to Clara Haber, 24 December 1914}
   {GStAPK, HA\,1, Rep~76~Vc, Sekt~1, Tit~23,
    Litt~A, Nr.\,108}|2|(226-231).}\,%
  \footnote{\arq{Setsuro Tamaru to Clara Haber, 24 December 1914}
   {GStAPK, HA\,1, Rep~76~Vc, Sekt~1, Tit~23,  % use copy & paste
    Litt~A, Nr.\,108}|2|(226-231).}\,%         % to repeat exactly
  \footnote{\arq{Valentini to Schmidt, 13 March 1911} 
   {GStAPK, HA\,1, Rep~76~Vc, Sekt~1, Tit~23, 
    Litt~A, Nr.\,108}|1|(47).} 
  \fillarq{GStAPK, HA\,1, Rep~76~Vc, Sekt~1, Tit~23, 
    Litt~A, Nr.\,108} {2\,Vols.}
  The \verb|\fillarq| above adds to the item on the \texttt{arq} list
  that ``Nr.\,108'' has 2 volumes \baref{arqlist}.
  

\newpage
\renewcommand{\thepage}{\mempage}
\setcounter{page}{1}
\setcounter{footnote}{0}
\section{Switches}
 For writing an essay without a List of Literature, type \verb|\conferize|
 at the top of your \LaTeX\ text; then \verb|\kli| prints a cross\hy
 reference to the full reference:

 \Doppelbox
 {
  \bs conferize\ ...\bs footnote\{
  \\[.15ex] \ \ Full ref.: \ \bs vli\{Niklas\} 
  \\[.05ex] \ \ \ \{Luhmann\} \b{\{}\bs ktit\{Soziale 
  \\[.15ex] \ \ \ \ \ \ \ \ Systeme\}. Grundriß 
  \\ \ \ \ \ einer allgemeinen Theorie, 
  \\ \ \ \ \ Frankfurt/M. 1984\b{\}}[22].\}
  \\[1.5ex] ... pp.\bs footnote\{ \bs notibidemize
  \\ \ \ \ \%no ibidem in this footnote\%
  \\ \ Shortened ref.: \bs kli\{Luhmann\} 
  \\ \ \ \ \ \ \ \{Soziale Systeme\}[23\bs f].\}
 }
 {
  \conferize ...\footnote{
    Full ref.: \vli{Niklas}{Luhmann} {\ktit{Soziale Systeme}. 
    Grundriß einer allgemeinen Theorie, Frankfurt/M. 1984}[22].} 
  \texttt{[u, v]} or \texttt{[w-x]} or \texttt{[y\bs f]} or 
  \texttt{[z\bs baplural]} are creating pp.\footnote{\notibidemize 
      %no ibidem in this footnote%
    Shortened ref.: \kli{Luhmann} {Soziale Systeme}[23\f].}
 }

 \noindent 
 If the \texttt{k}\textit{\fhy commands} \verb|\kli| and \verb|\kqu| are
 never used: \verb|\notannouncektit| will stop \verb|\vli| and \verb|\vqu|
 to print `{\footnotesize (cited as \fabra{...})}'.
 
 No historian? Set \verb|\notprinthints| $-$ you will never use \verb|\vqu|
 or \verb|\kqu|, and therefore, it is unnecessary to print \ehinttovliname,
 because there is only one \texttt{v}\textit{\fhy list}.


\section{The extra \texttt{*}\{\ko\textit{argument}\} of \texttt{v}- and
\texttt{k}\fhy commands}
 
 For works by multiple authors, use \texttt{x}\textit{\fhy commands} and
 the optional \texttt{*}\hy argument:

 \Doppelbox
 {
  Set names ...\bs footnote\{Two:\
  \\ \ \bs xvli\{FirstName\}\{LastName\} 
  \\ \ \ *\b{\{}\bs vauthor\{co-FirstName\}
  \\ \ \ \ \ \ \{co-LastName\}\b{\}}
  \\[.25ex] \ \ \{The \bs ktit\{kTitle2\} etc.\}.\}
  \\[1.25ex]
     \ \ \ \ \ \ \ ...\bs footnote\{
  \\ \ \bs xkli\{LastName\}
  \\ \ \ *\{\bs kauthor\{co-LastName\}\}
  \\[.25ex] \ \ \{kTitle2\}[11-14].\}
 }
 {
  Set names in \texttt{\bs vauthor}~$-$\,\texttt{\bs kauthor}.\footnote{Two:
   \xvli{FirstName}{LastName} 
          *{\vauthor{co-FirstName}
                     {co-LastName}}
          {The \ktit{\kTitle2} etc.}.}
  
   That's necessary to get an \textsc{ibidem}.\footnote{
   \xkli{LastName}*{\kauthor{co-LastName}}{\kTitle2}[11-14].}
 }

 \noindent 
 You may also use \texttt{*}\fhy arguments to mask text (\verb|\editor|) in
 the `ibidemization':

 \Doppelbox
 {
  ...\bs footnote\{An edited book is
  \\ \ \bs vli \{FirstName\} \{LastName\} 
  \\ \ *\{\bs onlyvoll\{\bs editor\}\}
  \\[.25ex] \ \{The \bs ktit\{kTitleEd\} etc.\}[2].\}
  \\[1.25ex]
  \bs footnote\{ \ \%\% Without *\{arg\}:\
  \\[.25ex] \ \bs kli\{LastName\}\{kTitleEd\}[3, 6].\}
 }
 { 
  \texttt{\bs onlyvoll} completely fills
  \texttt{*\{}\ko\textit{arg}\texttt{\}}.\footnote{An 
  edited book is
    \vli {FirstName} {LastName} 
    *{\onlyvoll{\editor}}
    {The \ktit{\kTitle Ed} etc.}[2].}\,%
  \footnote{  %% Without *{arg}:
   \kli{LastName}{\kTitle Ed}[3, 6].}
 }


 \newpage
 \noindent 
 For works with three or more authors, you must put all the `middle' authors
 in \verb|\midvauthor| (or \verb|\midkauthor|), and the `last' in
 \verb|\vauthor| (or \verb|\kauthor|):

 \vspace{-.125ex}
 \Doppelbox
 {
   ...\bs footnote \{See
   \\ \ \bs xvli\{Manfred F.\}\{Boemeke\}
   \\ \ \ *\b{\{}\bs midvauthor\{Roger\}
   \\ \ \ \ \ \ \ \ \ \ \ \{Chickering\} 
   \\ \ \ \ \ \bs vauthor\{Stig\}\{Förster\}\%
   \\ \ \ \ \ \bs onlyvoll\{ \bs editors\}\b{\}}
   \\[.2ex] \ \b{\b{\{}}\bs ktit\{Anticipating Total War\}. 
   \\ \ \ \ The German and American 
   \\ \ \ \ Experiences 1871-{}-1914, 
   \\ \ Cambridge\bs baslash U.\string~K. 1999\b{\b{\}}}.\}
   \\[.275ex]
   Repeat ... but ...\bs footnote \{
   \\ \ \bs xkli\{Boemeke\}
   \\ \ \ *\b{\{}\bs midkauthor\{Chickering\} 
   \\ \ \ \ \ \bs kauthor\{Förster\}\b{\}}
   \\ \ \ \{Anticipating Total War\}[9\bs f]!\}
 }
 {
   \texttt{bibsort} sorts \texttt{\bs vauthor\{F\}\{L\}} 
   and \texttt{\bs midvauthor\{F\}\{L\}} always as \texttt{L F}.\footnote {See
   \xvli{Manfred F.}{Boemeke}*{\midvauthor{Roger}{Chickering} 
   \vauthor{Stig}{Förster}%
         \onlyvoll{ \editors}}{\ktit{Anticipating Total War}. 
   The German and American Experiences 1871--1914, Cambridge\baslash U.~K. 1999}.}

   Repeat all \texttt{LastName}s in \texttt{\bs xkli}, but not the argument
   of \texttt{\bs onlyvoll}.\footnote
   {\xkli{Boemeke}*{\midkauthor{Chickering} \kauthor{Förster}}
   {Anticipating Total War}[9\f]!}
 }


\vspace{-1ex}
\section{Refer to different articles from the same source}
 
 \vspace{-.75ex}
 Insert \verb|\per| in the last argument of a \texttt{v}\textit{\fhy command} for
 citing journal articles:

 \Doppelbox
 {
  ...\bs footnote\{See \bs vqu \{John 
  \\ \ \ Frederick Charles\} \{Fuller\} 
  \\ \ \b{\{}Gold Medal (Military) 
  \\ \ \ \bs ktit\{Prize Essay\} for 1919, 
  \\ \ \ first published in: 
  \\ \ \ \bs per\{Journal of the Royal 
  \\ \ \ \ \ \ \ \ United Service 
  \\ \ \ \ \ \ \ \ Institution\}\string_458 
  \\ \ \ \ \ \ \ \ \ (1920)\string_[239-274]\b{\}}*[240].\}
  \\[1.5ex]
  ...\bs footnote\{ \bs kqu \{Fuller\} 
  \\ \ \ \ \ \ \ \ \ \ \ \{Prize Essay\}[241].\}
  \\[1.5ex]
  ... inner ...\bs footnote\{ \bs vqu\{R.\} 
  \\ \ \{Chevenix Trench\} 
  \\ \ \{Gold Medal (Military) 
  \\ \ \ \bs ktit\{Prize Essay\} for 1922, 
  \\ \ \ in: \bs per\{Journal of the 
  \\ \ \ \ \ \ \ \ Royal United Service 
  \\ \ \ \ \ \ \ \ Institution\}\string_470 
  \\ \ \ \ \ \ \ \ \ (1923)\string_[199-227]\}*[200].\}
 }
 {
  You can use \texttt{*[Pg]} to cite a
  certain page inside \texttt{[PgBegin-PgEnd]}.
  Do not type spaces in front of \texttt{*[Pg]}.\footnote{See 
  \vqu {John Frederick Charles} {Fuller} 
  {Gold Medal (Military) \ktit{Prize Essay} for 1919, 
  first published in: \per{Journal of the Royal United Service 
  Institution}_458 (1920)_[239-274]}*[240].}

  \BibArts\ creates an outer \textsc{ibidem} here.\footnote{ \kqu {Fuller}
  {Prize Essay}[241].}

  \BibArts\ creates an inner \textsc{ibidem} 
  here.\footnote{ \vqu{R.} 
  {Chevenix Trench} 
  {Gold Medal (Military) \ktit{Prize Essay} for 1922, 
  in: \per{Journal of the Royal United Service 
  Institution}_470 (1923)_[199-227]}*[200].\label{third}}
 }

 \noindent 
 The last argument of \verb|\vli|, \verb|\kli|, \verb|\per|, etc., may each be
 followed by \verb+_Num_+ or \verb+|Vol|+; both are only printing different
 separators (see in note~\ref{third}: {\footnotesize no.\,470}).

 \noindent
 When citing an article from a book, you can use \verb|\vli|
 \textit{inside the last} \texttt{v}\textit{\fhy argument} for the book. 
 \verb|\printvli| is \textit{printing} such `inner references'
 \textit{as shortened references}; the \textit{full inner reference} 
 appears as separate item (see \underline{Publ.}). For further articles from 
 the same book, you may use an \textit{inner} \verb|\kli| for the book:

 \vspace{-.25ex}
 \Doppelbox
 {
  \bs footnote\{ \ \ \bs vli\{\} \{Pitt\} \b{\b{\{}}The 
  \\[-.2ex] \ \ \ \ \ \ \ \ \ \ \ \ \ \ \bs ktit\{First\}, in:
  \\[.25ex] \bs vli\{J.\}\{Yi\}\{The \bs ktit\{iR\}
  \\[.25ex] \ \ \ \ \ \ \bs underline\{Publ.\}\}[4-6]\b{\b{\}}}.\}
  \\[.75ex] \bs footnote\{\bs kli \{Pitt\}\{First\}[4].\}
  \\[1ex] \bs footnote\{\bs vli[m]\{\}\{Pitt\}\b{\{}The 
  \\[.2ex] \ \ \ \ \ \ \ \ \ \ \ \bs ktit\{Second\}, in: 
  \\[-.05ex] \ \ \ \ \ \ \ \ \bs kli\{Yi\}\{iR\}[7-9]\b{\}}*[8].\}
 }
 {
  \texttt{  \bs vli[f]}...\ or \texttt{\bs kli[f]}...\ would refer to `the same female author'.%
  \footnote{\vli {}{Pitt}{The \ktit{First}, in: \vli{J.}{Yi} {The \ktit{\protect\fbox{iR}} \underline{Publ.}}[4-6]}.}\,%
  \footnote{\kli {Pitt}{First}[4].}\,%
  \footnote{\vli[m]{}{Pitt} {The \ktit{Second}, in: \kli{Yi}{\protect\fbox{iR}}[7-9]}*[8].\vspace{1ex}\strut}
 }

 \noindent 
 If neither a shortened inner reference in the bibliography nor an `inner
 ibidemization' in footnotes is wanted, use \verb|\ntvauthor| instead of
 the inner \verb|\vli|:

 \vspace{-.275ex}
 \Doppelbox
 {
  \vspace{.225ex}
  \bs footnote\{\bs vli\{Jost\}\{Dülffer\}
  \\[.35ex] \ \b{\{}\bs textit\{\bs ktit\{Einleitung\}\}, 
  \\[.35ex] \ \ in: \bs ntvauthor\{Jost\}\{Dülffer\} 
  \\[.35ex] \ \ Bereit zum Krieg\b{\}}[9].\} \ \ \ \%ok
  \\[2.25ex]
  \bs footnote\{\bs kli\{Dülffer\} 
  \\ \ \ \ \ \ \ \ \{Einleitung\}[9].\}
 }
 {
  Please do not use \texttt{\bs textit\{}\textit{italics}\texttt{\}} 
  at the end of a \BibArts' \texttt{\b{\{}}\textit{argument}$\bullet$\texttt{\b{\}}}.\footnote{\vli{Jost}{Dülffer}
    {\textit{\ktit{Einleitung}}, 
     in: \ntvauthor{Jost}{Dülffer} Bereit zum Krieg}[9].}\,%
  \footnote{\kli{Dülffer} 
    {Einleitung}[9].}\vspace{-.25em}
 }


\vfill\noindent 
If you use \verb|\printnumvli| instead of \verb|\printvli|, an
\textit{index referring to page and footnote numbers} will be printed;
\fbox{iR} \hspace{.05em}is a centrally defined `inner reference':

\vfill
{\baonecolitemdefs\printnumvlilist}


\let\memvlititlename=\evlititlename
\renewcommand{\evlititlename}{\texttt{\bs printvli} \ \memvlititlename}

\let\memvqutitlename=\evqutitlename
\renewcommand{\evqutitlename}{\texttt{\bs printvqu} \ \memvqutitlename}

\let\membibtitlename=\ebibtitlename
\renewcommand{\ebibtitlename}{\texttt{\bs printbibtitle} \ \membibtitlename}


\newpage\noindent
In the case of multiple works by one author, 
you may enter \hspace{.25em}\hbox{\texttt{bibsort -k }\abra{...}}\ at the prompt.
Then, in both \texttt{v}\textit{\fhy lists}, \BibArts\ inserts \hspace{.05em} $\sim$ \hspace{.005em} 
instead of the repeated \textit{last name}, \textit{first name}. 
And \hbox{\texttt{-e}} \hspace{.075em}prints the last names also of co\hy authors first. Anyway, 
\label{appendix} \verb|\printbibtitle| \verb|\printvli| \verb|\printvqu| 
\hspace{.1em}prints your bibliography:

\printbibtitle \printvli \printvqu \label{vqulist}

\vfill\noindent 
Use e.\,g.\ \verb|{\small| \verb|\printvli}| to change the font size of a whole list. 
Besides, \BibArts\ provides commands to format the lists: The sequence 
\verb|{\bibsortheads| \verb|\printvli}| inserts capital letters, each one as a
headline of the respective group of items beginning with the same letter, whereas 
\verb|{\bibsortspaces| \verb|\printvli}| only inserts extra vertical space between
such groups of items.


\newpage
\noindent
\subsection*{\texttt{\bs printnumvkc} \ \evkctitlename}
\addcontentsline{toc}{subsection}{\texttt{\bs printnumvkc} \ \evkctitlename}
\verb|\printnumvkc| prints an index of all your shortened references in 
\texttt{twocolumn}, whereas \verb|\printnumvkclist| \label{vkc} just prints
your list (without \texttt{headings} or title):\vspace{.5ex}

{\batwocolitemdefs\printnumvkclist}

\let\mempertitlename=\epertitlename
\renewcommand{\epertitlename}{\texttt{\bs printper} \ \mempertitlename}
\vspace{-.5ex}\printper

\renewcommand{\epertitlename}{\texttt{\bs printnumper} \ \mempertitlename}
\vspace{-.5ex}\printnumper

\let\memarqtitlename=\earqtitlename
\renewcommand{\earqtitlename}{\texttt{\bs printarq} \ \memarqtitlename}
\vspace{-.5ex}\printarq \balabel{arqlist}

\renewcommand{\earqtitlename}{\texttt{\bs printnumarq} \ \memarqtitlename}
\vspace{-.5ex}\printnumarq

\vspace{2ex}\noindent
\verb|\arqsection{GStAPK}{Geheimes Staatsarchiv}| may introduce 
a headline ``\textsf{GStAPK} $-$ \textbf{Geheimes Staatsarchiv}'' 
above all GStAPK items on the list.


\section{Using an Author\hy Year Reference System}

There, the last argument of a shortened reference is the year of publication 
(instead of a few words from the full title). \BibArts' full references can
be adapted to such a system: Use e.\,g.\
\hspace{.1em}\verb|*{\onlyvoll{\ktit{1999}}}|
\hspace{.1em}as the additional \texttt{*}\fhy argument of \texttt{v}\textit{\fhy commands}, or 
\hspace{.1em}\verb|*{\starktit{1999}}| \hspace{.1em}synonymously.

The following example uses \hspace{.075em}\verb|\notannouncektit|\kern.05em, because it seems to
be unnecessary to print {\footnotesize (cited as \fabra{...})}\ now; and \verb|\ntsep| 
is redefined in a way that, in \texttt{k}\textit{\fhy commands}, the name of the (last) author
is not followed by a colon:%
{\notannouncektit
 \renewcommand{\ntsep}{\ifbashortcite{ }{: }}\notktitaddtok
 \footnote { \printonlyvli{Roger} {Chickering} *{\starktit{1999}}
  {Total War. The Use and Abuse of a Concept, in:
   \xprintonlyvli{Manfred F.}{Boemeke} *{\midvauthor{Roger}{Chickering}
    \vauthor{Stig}{Förster}\onlyvoll{ \editors\ \ktit{1999}}}
    {Anticipating Total War. The German and American
     Experiences 1871--1914, Cambridge U.~K.}[13-28]}*[14\f].}%
 \,\footnote{\printonlykli{Chickering}{1999}[14\f].\label{RC}}%
 \,\footnote { \printonlyvli{Gerald D.}{Feldman}*{\starktit{1999}}
  {Hugo Stinnes and the Prospect of War Before 1914, in:
   \xprintonlykli{Boemeke} *{\midkauthor{Chickering} \kauthor{Förster}}
   {1999}[77-95]}*[77]; and \printonlykli{Chickering}{1999}[16].}%
}

\vspace{1ex}
\begin{small}
\noindent
\verb|   \notannouncektit| \\[.25ex]
\verb|   |\verb|\renewcommand{\ntsep}{\ifbashortcite{ }{: }}  % see bibarts.pdf|

\vspace{-.25ex}
\begin{verbatim}
   \footnote { \vli{Roger} {Chickering} *{\starktit{1999}}
    {Total War. The Use and Abuse of a Concept, in:
     \xvli{Manfred F.}{Boemeke} *{\midvauthor{Roger}{Chickering}
      \vauthor{Stig}{Förster}\onlyvoll{ \editors\ \ktit{1999}}}
      {Anticipating Total War. The German and American
       Experiences 1871--1914, Cambridge U.~K.}[13-28]}*[14\f].}
\end{verbatim}

\vspace{-.25ex}\noindent
\verb|   \footnote{\kli{Chickering}{1999}[14\f].}    %% see footnote |\texttt{\ref{RC}}

\vspace{-.5ex}
\begin{verbatim}
   \footnote { \vli{Gerald D.}{Feldman}*{\starktit{1999}}
    {Hugo Stinnes and the Prospect of War Before 1914, in:
     \xkli{Boemeke} *{\midkauthor{Chickering} \kauthor{Förster}}
     {1999}[77-95]}*[77]; and \kli{Chickering}{1999}[16].}
\end{verbatim}
\end{small}

\noindent
Note, that there are spaces in front of \verb|\vauthor{Stig}{Förster}| as well as \verb|\kauthor{Förster}|.
Now, \verb|\printvli| prints your bibliography like this:

\vspace{-1.75ex}\subsection*{Literatur}\vspace{-.25ex}
\begin{description}\parsep 0ex \itemsep -.5ex
\item
{\scshape Boemeke}, Manfred F.\baslash {\scshape Chickering}, Roger\baslash {\scshape Förster}, Stig \editors\
1999: Anticipating Total War. The German and American Experiences
1871--1914, Cambridge U.~K.
\item
{\scshape Chickering}, Roger 1999: Total War. The Use and Abuse of a Concept, in:
{\scshape Boemeke}\baslash {\scshape Chickering}\baslash {\scshape Förster} 1999 [L], S.\,13-28.
\item
{\scshape Feldman}, Gerald D. 1999: Hugo Stinnes and the Prospect of War Before
1914, in: {\scshape Boemeke}\baslash {\scshape Chickering}\baslash {\scshape Förster} 1999 [L], S.\,77-95.
\end{description}



\newpage
\section{Additional features}

This title was not used in text or footnotes, but appears on the \verb|vqu| list (p.\,\pageref{vqulist}):

\vspace{-.325ex}
{\footnotesize\begin{verbatim}
  \begin{unused} \sethyphenation{ngerman}      % This is invisible HERE:
   \vqu{Karl}{Marx}{Das \ktit{Kapital}, in: \midvauthor{Karl}{Marx}
   \ntvauthor{Friedrich}{Engels} Werke, \ersch|3|[1]{Berlin}{1962--1964}}
  \end{unused}                          % vol.|3| and ed.[1] are optional
\end{verbatim}}

  \begin{unused} \sethyphenation{ngerman}      % This is invisible HERE:
   \vqu{Karl}{Marx}{Das \ktit{Kapital}, in: \midvauthor{Karl}{Marx}
   \ntvauthor{Friedrich}{Engels} Werke, \ersch|3|[1]{Berlin}{1962--1964}}
  \end{unused}                          % vol.|3| and ed.[1] are optional

\vspace{-.4ex}\noindent
Note, that \textit{inner} \texttt{v}\textit{\fhy commands} in \verb|{unused}| 
environments do not send an own full item to the \texttt{v}\textit{\fhy list};
an \textit{inner} \verb|\vli| or \verb|\vqu| has to be repeated separately.

\vspace{1ex}\noindent
For longer quotations, you can use \BibArts' \verb|{originalquote}|
environment. To set the same hyphenation rules that apply to the language 
of the original, this environment provides an 
\verb|[|\textit{optional argument}\verb|]| for language selection:

 \vspace{-.625ex}
 \Doppelbox
 {
  \vspace{.75ex}
  \bs begin\{originalquote\}[german]
  \\[.4ex] \ \ \string`\string`Dies ist die erste 
  \\ \ \ Wechselwirkung und das  
  \\ \ \ erste Äu\bs hyss erste, 
  \\ \ \ \bs fabra\{...\}.\string'\string'\bs footnote \ \b{\{}The 
  \\ \ Eszett splits different here:
  \\ \ \b{\b{\{}}\bs sethyphenation\{ngerman\}
  \\[-.4ex] \ \ Au\bs hyss er\b{\b{\}}}. \bs kqu\{Clausewitz\} 
  \\[-.4ex] \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \{Vom Kriege\}[19].\b{\}}
  \\[.3ex] \bs end\{originalquote\}
  \vspace{.5ex}
 }
 {
  \renewcommand{\originalquotetype}{\footnotesize}%
  \begin{originalquote}[german]
  ``Dies ist die erste
  Wechselwirkung und das
  erste Äu\hyss erste, 
  \fabra{...}.''\footnote  {The 
   Eszett splits different here:
   {\sethyphenation{ngerman}
    %% I use  Au\hyss er  here.  The hyphenation  Äu-
    %% ßerst  has to recognize the Ä; I do not want to 
    %% use \usepackage[T1]{fontenc} in this file here.
    Au\hyss er}. \kqu{Clausewitz}
                  {Vom Kriege}[19].
   \\[.5ex] \hspace*{3mm} \texttt{\% In \bs scshape, \bs hyss prints }{\scshape \hyss}\texttt{,}
   \\ \hspace*{3mm} \texttt{\% and splits }{\scshape s-s}\,\texttt{ (also ngerman)}%
   \vspace{-1.5ex}%
  }
  \end{originalquote}
 }

\vspace{-.625ex}\noindent 
In quotations, you may use \verb|\abra| \hspace{.1em}for \textit{editorial
additions in square brackets}. Use \verb|\fabra| to prevent a line break
between the printed brackets and following text. Some arguments are enclosed
by superscript or subscript brackets, e.\,g.:

\vspace{.75ex}\noindent
{\small
  \ifnum\catcode`\"=12\else\catcode`\"=12\message{ Set catcode of \string" to 12. }\fi
   %% ... to avoid error messages if you load a german package (active double quotes). %%
   \verb|    \fabra{"}Red\abra{,} blue => | \fabra{"}Red\abra{,} blue \\[-.25ex]
  %% U+201A (=> \quotesinglbase) not available in OT1. %%
   \verb|     \abra{.}\newsentence But => | \hbox to 6.2em{colours\abra{.}\newsentence But\hfill} \verb|% [spacing like |\verb*|\@. |\verb|]| \\[-.25ex]
   \verb|\abra{...}\abra{\dots}        => | \hbox to 6.2em{\abra{...} others \abra{\dots}\hfill} \verb|%    U+2026 = \dots| \\[-.25ex]
   \verb|\abra{---}\abra{-}\abra{--}   => | \abra{---}green\abra{-}red\abra{--}painted. \\[-.25ex]
   \verb|    \fabra{`}    \abra{'}     => | \hbox to 6.2em{\fabra{`}Quote\fabra{'} and\hfill} \verb|%    U+0060 / U+0027| \\[-.25ex]
   \verb|    \fabra{‘}   \fabra{’}.    => | \hbox to 6.2em{\fabra{‘}Quote\fabra{’}.\hfill} \verb|%    U+2018 / U+2019| \\[-.25ex]
   \verb|    \fabra{|\hbox to .525em{\sf\kern-.075em“\hfill}\verb|}    \abra{|\hbox to .525em{\sf\kern.075em”\kern-.075em\hfill}\verb|}     => | \hbox to 6.2em{\fabra{“}Quote!\abra{”}\hfill} \verb|%    U+201C / U+201D| \\[-.25ex]
   %% <= or 2*U+2018 ‘‘ and 2*U+2019 ’’ %%
   \verb|    \fabra{``}   \abra{''}    => | \hbox to 6.2em{\fabra{``}Quote!\abra{''}\hfill} \verb|% [+guillemets in T1]| \\[-.25ex]
   \verb|    \fabra{sic!}.             => | \hbox to 6.2em{\fabra{sic!}.\hfill} \verb|% unknown=>normalsize|}

\vspace{1ex}\noindent
\verb|\hy| \hspace{.05em}is a \textit{hyphen} which allows to divide the following word and does a kerning:

\vspace{.5ex}\noindent
{\small
  \verb|    ex-Yugoslavia             => | \hbox to 6.2em{ex-Yugoslavia\hfill}    \verb|%  Or \hy\`{A} etc.,| \\[-.2ex]
  \verb|    ex\hy Yugoslavia          => | \hbox to 6.2em{ex\hy Yugoslavia\hfill} \verb|%  or \hy À = U+00C0|}

\vspace{.875ex}\noindent 
Not only for use in French is e.\,g.\ \verb|P\fup{r}| (P\fup{r}). More country\hy specific are:

\vspace{.75ex}\vfill\noindent
{\small
  \verb|    \eordinal{103} Assistant. => | \eordinal{103} Assistant. \\[-.2ex]
  \verb|    Der 1\te August.          => | Der 1\te August.} 

 \newpage\noindent
 An additional feature are \textit{abbreviations}. Before using e.\,g.\ 
 \verb|\abk{HMS}|, define:
 
 \vspace{-.25ex}
 \Doppelbox
 {
      \bs abkdef\{HMS\}\{His Majesty\string's Ship\}
   \\[.35ex] \ \ or ...:
   \\[.35ex] \bs defabk\{His Majesty\string's Ship\}\{HMS\}
   \\[.35ex] \ \ and then \bs texttt\{bibsort\}
   \\[.35ex] \ \ will accept \bs abk\{HMS\} ...
   \vspace{-.5ex}\strut
 }
 {
      \abkdef{HMS}{His Majesty's Ship}
   \\  or [their repeated use is allowed]:
   \\ \defabk{His Majesty's Ship}{HMS}
   \\  and then \texttt{bibsort}
   \\  will accept \abk{HMS} for the index.
   \vspace{-.5ex}\strut
 }

\vspace{-.25ex}\noindent 
For a correct spacing at the end of a sentence, a \textit{full stop of the sentence}
(\ko\verb*|. |) must be `repeated' here: 
\hspace{.25em}\verb|say, \abk{e.\,g.}|\verb*|. |\verb|Next  => | say, \abk{e.\,g.}. Next 

Each defined abbreviation will appear on the List of Abbreviations. Use
\verb|\printabk| just to print a list or \verb|\printnumabk| to print a 
`\BibArts\ index' (a list with page numbers---\textit{and} footnote numbers if the 
entries are from footnotes\ko):

\vspace{-.325ex}
\printnumabklist

\noindent 
\BibArts\ provides up to three \textit{registers} (geographical, subject and person). 
The commands for feeding them have one argument, which is
invisible in your text, e.\,g.\ \verb|\addtogrr{London}|,
\verb|\addtosrr{Ship}|, \verb|\addtoprr{Churchill}|. Use \verb|\printnumgrr|, 
\verb|\printnumsrr| and \verb|\printnumprr| to print the indexes.

\vspace{1.5ex}\noindent 
A last feature of \BibArts\ are \textit{fill commands}. \verb|\fillgrr|, 
\verb|\fillsrr|, \verb|\fillprr|, \verb|\fillper| and \verb|\fillarq| 
have two arguments. The first has to be identical with \textit{the} argument 
of a register entry or \verb|\per| command, or \textit{the second} 
argument of an \verb|\arq| command (an Archive Signature). 
The other \textit{fill} argument serves to add an information---written only 
once---to the related index item:

 \vspace{-.25ex}
 \Doppelbox
 {
  \vspace{1.2ex}
  \ \bs fillprr\{Churchill\}\{1874--1965\} \\[1.5ex] 
  Churchill \bs addtoprr\{Churchill\}
  \\ was prime minister.\bs footnote
  \\ \ \b{\{}He \bs addtoprr\{Churchill\} was
  \\ \ \ \ \ \ \ \ \ born Blenheim Palace.\b{\}} \\[1.325ex] 
  \bs renewcommand\{\bs xrrlistemph\}\{\bs em\} \\ 
  \bs printnumprr
  \vspace{1ex}
 }
 {
  \vspace{-1.1ex}%
  \fbox{\begin{minipage}{.95\textwidth}
     \setcounter{mpfootnote}{\arabic{footnote}}%
  \vspace{.125ex}
   \fillprr{Churchill}{1874--1965}
  Churchill \addtoprr{Churchill}
  was prime minister.\footnote
    {He \addtoprr{Churchill} was
     born Blenheim Palace.}
     \setcounter{footnote}{\arabic{mpfootnote}}%
  \end{minipage}}
  \\[1.6ex]
  \fbox{\begin{minipage}{.95\textwidth}
  \vspace{.875ex}
  \subsubsection*{\eprrtitlename}        
    \vspace{-.75ex}%
  \renewcommand{\xrrlistemph}{\em}%
  {\footnotesize \printnumprrlist}%
  \vspace{-1.375ex}%
  \end{minipage}}%
  \vspace{-1.3ex}%
 }

\vspace{.5ex}\vfill\noindent 
Please use commands like \verb|\bfseries| to \verb|\renewcommand| fonts, not \verb|\textbf|:


\vspace{1.5ex}\vfill\noindent
{\small\begin{tabular}{lll}
\textsf{Command}    & \textsf{Predefined}          & \textsf{Executed on} \\[.325ex]
\verb|\xrrlistemph| & \verb|{}|                    & keywords on grr, srr and prr lists \\
\verb|\abkemph|     & \verb|{\sffamily}|           & abbreviations in your text \\
\verb|\abklistemph| & \verb|{\bfseries}|           & abbreviations on the abk list \\
\verb|\kxxemph|     & \verb|{}|                    & last argument of \texttt{k}\textit{\fhy commands} \\
\verb|\peremph|     & \verb|{\normalfont\scshape}| & periodicals \verb| % alt.: {\upshape}| \\
\end{tabular}}


\edef\bamantestargs{ -h -utf8 -k -e }
\ifx\bamantestargs\bibsortargs\else\newpage\noindent bibsort was started with options\\ \bibsortargs\\ instead of\\ \bamantestargs\fi

\end{document}








