path: root/Master/texmf-dist/doc/latex/bibarts/ba-short.tex

   \documentclass[12pt,a4paper]{article}
   \usepackage{bibarts}
   \bacaptionsenglish
\setlength{\footnotesep}{2ex}   %% ... as in bibarts.sty 2.0; see readme.txt %%

  \title{The \LaTeX\hy Package \BibArts \\[.25ex] {\normalsize\slshape 
    A package to assist in making bibliographical features common in the arts}}
  \author{\textsc{Timo Baumann}}
  \date{\small Version 2.1, \copyright\,2016}

  \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}

{\small\tableofcontents}

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

\vspace{1.75ex}
\hbox{\parbox{7.7cm}{\footnotesize\noindent
\textbf{\BibArts~2.1 (9 files, 8 dated 2016\ko/03\ko/19):} \\[.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}  & Binary 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]
   \sethyphenation{english}\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}| into your \textit{file}.\texttt{tex}, and
 \verb|\bacaptionsenglish| to switch to English captions (to name pages p.,
 not S.). They are used here. \verb|\bacaptionsfrench| sets French captions;
 default is \verb|\bacaptionsgerman|.

 \vspace{.75ex}\noindent 
 Full references to literature are created with (a page number \verb|[Pg]| is optional):

 \vspace{-.4ex}
 \Doppelbox
 {
  \bs vli\{FirstName\}\{LastName\}
  \\ \ \ \{The \bs ktit\{kTitle\}, 
  \\ \ \ \ Publishing Reference\}[Pg].
 }
 {
  \vli{FirstName}{LastName}
   {The \ktit{\kTitle}, Publishing Reference}[Pg].
 }

 \noindent
 Now, \BibArts\ can also write your appendix! \texttt{bibarts.sty} writes 
 the arguments of your \verb|\vli|\hy commands into the
 \textit{file}.\texttt{aux}, and \texttt{bibsort} creates your 
 List of Literature: Type \verb|\printvli| (p.\,\pageref{appendix}), 
 \hspace{.1em}and start \LaTeX\ + \texttt{bibsort} \textit{file} + \LaTeX.

 \vspace{.75ex}\noindent
 After you have introduced literature fully, you may use a shortened reference:
 
 \vspace{-.6ex}
 \Doppelbox
 {
  \bs kli\{LastName\}\{kTitle\}[Pg].
 }
 {\vspace{1.75ex}
  \kli{LastName}{\kTitle}[Pg].
 }

 \vspace{-.3ex}\noindent
 Use \verb|\vqu| and \verb|\kqu| \hspace{.1em}in the same way
 \hspace{.1em}to cite published historical documents:

\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). 

 \vspace{.75ex}\noindent 
 And \verb|\printnumvkc| (p.\,\pageref{vkc}) will print an index 
 of shortened references (made by all \verb|\kli|'s, \verb|\kqu|'s, and  
 the \verb|\ktit|'s in the last arguments of \verb|\vli| or 
 \verb|\vqu|).
 
 \vspace{.75ex}\vfill\noindent
 There are also \BibArts\hy commands to cite periodicals 
 and archive documents:
 
 \vspace{-.35ex}
 \Doppelbox
 {
  \bs per\{Journal\}\string_Num\string_[Pg]
  \\[1ex]
  \bs arq\{Unpublished Document\}
  \\ \ \{Archive File Sig\}\string|Vol\string|(Folio)
 }
 {
  \per{Journal}_Num_[Pg]
  \\[.5ex]        
  \arq{Unpublished Document}
   {Archive File Sig}|Vol|(Folio)
 }

 \vspace{-.25ex}\noindent 
 \verb|\printper| your Periodicals, and \verb|\printarq| the List of Archive
 Files. Spaces are forbidden before the optional arguments \verb+[Pg]+,
 \verb+(Foilo)+, \verb+|Vol|+, or \verb+_Num_+.


\newpage
\noindent
\BibArts\ introduces \textsc{ibidem} only in footnotes and \texttt{minipage} 
footnotes. That will only work, when you hand over all bibliographical
information to \BibArts: 

{\footnotesize\begin{verbatim}
  ...\footnote{\vli{Niklas}{Luhmann}{\ktit{Soziale Systeme}. 
   Grundri{\ss} einer allgemeinen Theorie, Frankfurt/M. 1984}|1|.}

  ...\footnote{\kli{Luhmann}{Soziale Systeme}|1|[22],
           and \kli{Luhmann}{Soziale Systeme}|1|[23].}

  ...\footnote{\kli{Luhmann}{Soziale Systeme}|1|[23]. Next sentence.}

  ...\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).}  %The first argument could be empty
				
  ...\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, 
        Litt~A, Nr.\,108}|2|(226-231).}
     \footnote{\arq{Valentini to Schmidt, 13 March 1911} 
       {GStAPK, HA\,1, Rep~76~Vc, Sekt~1, Tit~23, 
        Litt~A, Nr.\,108}|1|(47).} 
\end{verbatim}}

  \noindent
  If you introduce a book with a \verb+|Vol|+, you will have to use
  \verb+|Vol|+ also, when you refer to the same book in the following
  footnote.\footnote{ \vli{Niklas}{Luhmann}{\ktit{Soziale Systeme}.
  Grundri{\ss} einer allgemeinen Theorie, Frankfurt/M. 1984}|1|.}
  \verb+[Pg]+ is equivalent.\footnote{\kli{Luhmann}{Soziale
  Systeme}|1|[22], and \kli{Luhmann}{Soziale Systeme}|1|[23].}
  Here, there have been different page numbers in the foregoing
  footnote.\footnote{\kli{Luhmann}{Soziale Systeme}|1|[23]. Next sentence.}

  \vspace{1ex}\noindent
  If you switch many times between two Vols of one archive file signature,
  you can move the Vol into the \verb+|Vol|+\hy argument for a better
  ibidem\hy setting.\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).}
  This has to be done with that archive file signature in your whole
  text.\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,
  Litt~A, Nr.\,108}|2|(226-231).}\,%
  \footnote{\arq{Valentini to Schmidt, 13 March 1911} 
  {GStAPK, HA\,1, Rep~76~Vc, Sekt~1, Tit~23, 
  Litt~A, Nr.\,108}|1|(47).}

\vspace{1ex}\noindent
A single \verb|\fillarq{GStAPK, HA\,1,| \verb|Rep~76~Vc,| \verb|Sekt~1,| 
\verb|Tit~23,| \verb|Litt~A,| \verb|Nr.\,108}| \verb|{2\,Vols.}| 
\fillarq{GStAPK, HA\,1, Rep~76~Vc, Sekt~1, Tit~23, Litt~A, Nr.\,108} {2\,Vols.}
prints the number of Vols at the end of the list\hy item \baref{arqlist}. 
And you may send an \verb|\arqsection{GStAPK}{|\textit{headline}\verb|}| 
later into the list; \texttt{bibsort} will place it alphabetically 
(on top of all GStAPK\hy entries).


\newpage
\renewcommand{\thepage}{\mempage}
\setcounter{page}{1}
\setcounter{footnote}{0}
\section{Switches}
 If you write an article (instead of a book), you can set \verb|\conferize| 
 to get cross references from \verb|\kli| to \verb|\vli| (and use the 
 bibliography only for control):

 \Doppelbox
 {\bs conferize\ ...\bs footnote\{
  \\[.15ex] \ \ Full ref.: \ \bs vli\{Niklas\} 
  \\[.05ex] \ \ \ \{Luhmann\} \b{\{}\bs ktit\{Soziale 
  \\[.15ex] \ \ \ \ \ \ \ \ Systeme\}. Grundri\{\bs ss\} 
  \\ \ \ \ \ einer allgemeinen Theorie, 
  \\ \ \ \ \ Frankfurt/M. 1984\b{\}}[22].\}
  \\[1.5ex] ... pp.\bs footnote\{ \bs notibidemize
  \\ \ \ \ \%no ibidem in this footnote\%
  \\ \ \ Short.ref.: \bs kli\{Luhmann\} 
  \\ \ \ \ \ \ \ \{Soziale Systeme\}[23 \bs f].\}
 }
 {\conferize ...\footnote{
        Full ref.: \vli{Niklas}{Luhmann} {\ktit{Soziale Systeme}. 
        Grundri{\ss} 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%
        Short.ref.: \kli{Luhmann} {Soziale Systeme}[23 \f].}
 }

 \noindent 
 If you are never using \textit{both k\fhy commands} \verb|\kli| and
 \verb|\kqu|, \verb|\notannouncektit| them in your \textit{v\fhy commands}
 ({\footnotesize cited as ...} will not be printed at \verb|\vli| and
 \verb|\vqu|).
 
 No historian? Set \verb|\notprinthints| $-$ you will never use \verb|\vqu|
 or \verb|\kqu|, and therefore, it is unnecessary to print \ehinttovliname\
 as a hint to the full reference.


\section{The extra \texttt{*}\{\textit{argument}\} of v- and k\fhy commands}
 
 To cite \textit{books from teams}, set co\hy authors in star\hy arguments; use
 x\fhy commands:

 \Doppelbox
 {
  Set names ...\bs footnote\{Two:\
  \\ \ \bs xvli\{FirstName\}\{LastName\} 
  \\ \ \ *\b{\{}\bs vauthor\{co-FirstName\}
  \\ \ \ \ \ \ \{co-LastName\}\b{\}}
  \\ \ \ \{The \bs ktit\{kTitle2\} Pub\}.\}
  \\[1.25ex]
        ... to ibidemize.\bs footnote\{
  \\ \ \bs xkli\{LastName\}
  \\ \ \ *\{\bs kauthor\{co-LastName\}\}
  \\ \ \ \{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} Pub}.}
  
   That's necessary to ibidemize.\footnote{\xkli{LastName}*{\kauthor{co-LastName}}{\kTitle2}[11-14].}
 }

 \noindent 
 You may use a \texttt{*}\fhy argument also in \verb|\vli| $-$ to mask text in the
 ibidemization:

 \Doppelbox
 {
  ...\bs footnote\{An edited book is
  \\ \ \bs vli\{FirstName\}\{LastName\} 
  \\ \ \ *\{\bs onlyvoll\{\bs editor\}\}
  \\ \ \ \{The \bs ktit\{kTitleEd\} Pub\}[2].\}
  \\[1.25ex]
  \bs footnote\{ \%Without *-argument:\
  \\ \ \bs kli\{LastName\}\{kTitleEd\}[3, 6].\}
 }
 {
  \texttt{\bs editor} has no sorting 
           weight.\footnote{An edited book is
   \vli{FirstName}{LastName} 
          *{\onlyvoll{\editor}}
          {The \ktit{\kTitle Ed} Pub}[2].}
  \footnote{ %Without *-argument:\
  \kli{LastName}{\kTitle Ed}[3, 6].}
 }


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

 \Doppelbox
 {
   ...\bs footnote\{See
   \\ \ \bs xvli\{Manfred F.\}\{Boemeke\}
   \\ \ \ *\b{\{}\bs midvauthor\{Roger\}
   \\ \ \ \ \ \ \ \ \ \ \ \{Chickering\} 
   \\ \ \ \ \ \bs vauthor\{Stig\}\{F\bs\string"orster\}\b{\}}
   \\ \ \ \b{\{}\bs ktit\{Anticipating Total War\}. 
   \\ \ \ \ The German and American 
   \\ \ \ \ Experiences 1871-{}-1914, 
   \\ \ \ \ Cambridge/U.K.\bs\ 1999\b{\}}.\}
   \\[1ex]
   ... all LastNames.\bs footnote\{
   \\ \ \bs xkli\{Boemeke\}
   \\ \ \ *\b{\{}\bs midkauthor\{Chickering\} 
   \\ \ \ \ \ \bs kauthor\{F\bs\string"orster\}\b{\}}
   \\ \ \ \{Anticipating Total War\}[9\bs f]!\}
 }
 {
   \texttt{bibsort} is sorting \texttt{\bs vauthor\{F\}\{L\}} 
         and \texttt{\bs midvauthor\{F\}\{L\}} as \texttt{L F}.\footnote{See
   \xvli{Manfred F.}{Boemeke}*{\midvauthor{Roger}{Chickering} 
   \vauthor{Stig}{F\"orster}}{\ktit{Anticipating Total War}. 
   The German and American Experiences 1871--1914, Cambridge/U.K.\ 1999}.}

   Repeat all LastNames.\footnote{\xkli{Boemeke}*{\midkauthor{Chickering} \kauthor{F\"orster}}
         {Anticipating Total War}[9\f]!}
 }


\section{IBIDEM and inner references}
 
 To cite articles in journals, use \verb|\per| inside the last argument of a
 v\fhy command:

\Doppelbox
{
...\bs footnote\{See \bs vqu \{John 
\\ \ \ Frederick Charles\} \{Fuller\} 
\\ \ \b{\{}\bs em Gold Medal (Military) 
\\ \ \ \bs ktit\{Prize Essay\} for 1919\bs em, 
\\ \ \ 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]
... here.\bs footnote\{ \bs vqu\{R.\} 
\\ \ \{Chevenix Trench\} 
\\ \ \{\bs em Gold Medal (Military) 
\\ \ \ \bs ktit\{Prize Essay\} for 1922\bs em, 
\\ \ \ in: \bs per\{Journal of the 
\\ \ \ \ \ \ \ \ Royal United Service 
\\ \ \ \ \ \ \ \ Institution\}\string_470 
\\ \ \ \ \ \ \ \ \ (1923)\string_[199-227]\}*[200].\}
}
{
Do not type spaces before \texttt{*[Pg]},
and do not set \texttt{\bs ktit} into 
the argument of \texttt{\bs textit};
use two \texttt{\bs em}'s instead.\footnote{See 
\vqu {John Frederick Charles} {Fuller} 
{\em Gold Medal (Military) \ktit{Prize Essay} for 1919\em, 
first published in: \per{Journal of the Royal United Service 
Institution}_458 (1920)_[239-274]}*[240].}

...\footnote{ \kqu {Fuller} {Prize Essay}[241].}

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

 \noindent 
 After the main arguments of \verb|\per|, or \verb|\vli|, etc., you are free
 to type \verb+_Num_+, or \verb+|Vol|+; both are only printing different
 separators (see in note~\ref{third}: {\footnotesize no.\,Num}).

 \noindent
 When an article is in an edited book, also use \verb|\vli|+\verb|\ktit| inside a last 
 v\fhy argument. \verb|\printvli| is \textit{printing} the inner reference 
 \textit{as shortened reference}; the full inner reference appears as separate item 
 (see \underline{Pub}). To cite further articles from the same book, 
 you therefore can use \verb|\kli| for the book then:

 \Doppelbox{
 ...\bs footnote\{\bs vli\{FN1\}\{LN1\}\b{\{}The 
 \\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \bs ktit\{First\}, 
 \\ \ in: \bs vli\{iFN\}\{iLN\}\{The \bs ktit\{iT\} 
 \\ \ \ \bs protect\bs underline\{Pub\}\}\b{\}}.\}
 \\[1ex] \bs footnote\{\bs kli\{LN1\}\{First\}.\}
 \\[1ex] \bs footnote\{\bs vli[m]\{FN1\}\{LN1\}\{The 
 \\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \bs ktit\{Second\}, 
 \\ \ in: \bs kli\{iLN\}
 \\ \ \ \ \{iT\}[PgBegin-PgEnd]\}*[Pg].\}
 }
 {
 \texttt{\bs vli[f]}...\ or \texttt{\bs kli[f]}...\ would refer to `the same female author'.%
 \footnote{\vli{FN1}{LN1}{The \ktit{First}, in: \vli{iFN}{iLN}{The \ktit{\protect\fbox{iT}} \protect\underline{Pub}}}.}
 \footnote{\kli{LN1}{First}.}
 \footnote{\vli[m]{FN1}{LN1}{The \ktit{Second}, in: \kli{iLN}{\protect\fbox{iT}}[PgBegin-PgEnd]}*[Pg].}
 }

\noindent 
If an inner ibidemization (as well as an inner shortened referencing in the bibliography)  
is not wanted, use \verb|\ntvauthor| instead of the inner v\fhy command:

\Doppelbox
{
 \bs footnote\{\bs vli\{Jost\}\{D\bs\string"ulffer\}
 \\ \ \{\bs ktit\{Einleitung\}, in: 
 \\ \ \ \bs ntvauthor\{Jost\}\{D\bs\string"ulffer\} 
 \\ \ \ Bereit zum Krieg\}[9].\}
 \\[1ex]
 \bs footnote\{\bs kli\{D\bs\string"ulffer\} 
 \\ \ \{Einleitung\}[9].\}
}
{
 \footnote{\vli{Jost}{D\"ulffer}
   {\ktit{Einleitung}, in: 
   \ntvauthor{Jost}{D\"ulffer} Bereit zum Krieg}[9].}
 \footnote{\kli{D\"ulffer} 
   {Einleitung}[9].}
}


\vfill\noindent 
If you use \verb|\printnumvli| instead of \verb|\printvli|, the page and
footnote numbers will be printed additionally (\textsc{iLN}: inner\,LastName
/ \fbox{iT}: inner\,k\kern -0.05em Title):

\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
The command sequence \verb|\printbibtitle| \verb|\printvli| \verb|\printvqu| 
\label{appendix} will print an easy appendix. If you type \hspace{.01em}
\texttt{bibsort -k} \hspace{.02em} to DOS, you will get \hspace{.005em}
$\sim$ \hspace{.005em} in both v\fhy lists, when the name (first name and last
name) of an author is repeated:

\printbibtitle \printvli \printvqu

\vfill\noindent 
\verb|\bibsortheads| will print capital letters between two items into the 
lists, when the initial letter changes, whereas \verb|\bibsortspaces| will
print only a bigger vertical space there instead. Both features are prepared
by \verb|bibsort|.


\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



\newpage
\section{Additional features}

For your \LaTeX\ file, \BibArts\ provides an environment to send further
literature into the v\fhy lists. If there is no `normal' text inside, 
such areas will be invisible:

\vspace{-1.25ex}
{\footnotesize\begin{verbatim}
 !\begin{unused} \sethyphenation{german}%  %% other hyphenation pattern
   \vqu{Karl}{Marx}{Das \ktit{Kapital}, in: \midvauthor{Karl}{Marx}
   \ntvauthor{Friedrich}{Engels} Werke, \ersch|3|[1]{Berlin}{1962--1964}}
  \end{unused}! Please note, that      %% vol.|3| and ed.[1] are optional
\end{verbatim}}

\vspace{-1ex}\noindent
 !\begin{unused} \sethyphenation{german}%  %% other hyphenation pattern
   \vqu{Karl}{Marx}{Das \ktit{Kapital}, in: \midvauthor{Karl}{Marx}
   \ntvauthor{Friedrich}{Engels} Werke, \ersch|3|[1]{Berlin}{1962--1964}}
  \end{unused}! Please note, that \textit{inner} \verb|\vli|\textit{'s from}
\verb|{unused}|\hy\textit{environments} will not appear as own full entries on the
vli\hy list; so, you have to repeat them separately.

\vspace{1.5ex}\noindent
\BibArts\ does not only help to cite. The environment \verb|{originalquote}|
helps to quote from literature or sources. You may call all hyphenation
patterns, which your \LaTeX\ possesses, in the \verb|[|\textit{optional
argument}\verb|]| of the environment:

\Doppelbox
{ \bs begin\{originalquote\}[german]
 \\ \ \ \string"Der Krieg entsteht  
 \\ \ \ nicht urpl\bs\string"otzlich; seine 
 \\ \ \ Verbreitung ist nicht das 
 \\ \ \ Werk eines Augenblicks, 
 \\ \ \ [...].\string"\bs footnote \b{\{}Quoted from
 \\ \ \ \ \bs kqu\{Clausewitz\} 
 \\ \ \ \ \ \ \ \ \{Vom Kriege\}[22].\b{\}}
 \\ \bs end\{originalquote\}
}
{\renewcommand{\originalquotetype}{\footnotesize}%
 \begin{originalquote}[german]
 "Der Krieg entsteht nicht urpl\"otzlich; seine Verbreitung 
 ist nicht das Werk eines Augenblicks, 
 [...]."\footnote {Quoted from
 \kqu{Clausewitz} {Vom Kriege}[22].}
 \end{originalquote}
}

\vspace{.5ex}\noindent 
In quotations, you may use \verb|\abra| to set additions in small angular
brackets. And \verb|\fabra| affixes the argument to the following text (it
forbids line breaks):

\vspace{1ex}\noindent
{\small
   \verb|       \abra{,}               => | Red\abra{,} blue and green were the \\[-.25ex]
   \verb|       \abra{.}\newsentence   => | colours\abra{.}\newsentence And \hspace{2.25em} \verb|% spacing| \\[-.25ex]
   \verb|    \abra{...}   \abra{\dots} => | there \abra{...} were \abra{\dots} others, \\[-.25ex]
   \verb|       \abra{---}             => | \abra{---} let's say \abra{---} \\[-.25ex]
   \verb|       \abra{-}   \abra{--}   => | green\abra{-}red\abra{--}painted. \\[-.25ex]
   \verb|    \fabra{`}    \fabra{'}    => | \hbox to 6em{\fabra{`}Ha\fabra{'},\hfill} \verb|% ASCIIs 96 and 39| \\[-.25ex]
   \verb|    \fabra{``}    \abra{''}   => | \fabra{``}Good!\abra{''} \\[-.25ex]
   \verb|    \fabra{"}     \abra{"}    => | \hbox to 6em{\fabra{"}Good!\abra{"}\hfill} \verb|% \dq now unnecessary| \\[-.25ex]
   \verb|      \fabra{e}g.             => | \hbox to 6em{\fabra{e}g.\hfill} \verb|% unknown = normal|}

\vspace{2ex}\vfill\noindent 
\BibArts\ defines
\hspace{.1em}\verb|S\fup{te}|\hspace{.3em}\verb|=>|\hspace{.3em}S\fup{te}
(if that command for \textit{French up} is undefined), and it provides
commands to set ordinals in English, French and German:

\vspace{1ex}\vfill\noindent
{\small
  \verb|    \eordinal{103} Assistant. => | \eordinal{103} Assistant. \\[-.2ex]
  \verb|    Le \fordinalm{1} homme.   => | Le \fordinalm{1} homme.   \\[-.25ex]
  \verb|    La \fordinalf{1} femme.   => | La \fordinalf{1} femme.   \\[-.2ex]
  \verb|    Der 1\te August.          => | Der 1\te August.} 


 \newpage\noindent
 To print abbreviations in your text, you may use 
 \verb|\abk{|\textit{xyz}\verb|}|. \textit{xyz} will only appear 
 on the List of Abbreviations, when it is defined in the text:

 \vspace{-.25ex}
 \Doppelbox
 {
      \bs abkdef\{HMS\}\{Her Majesty\string's Ship\}
   \\[.35ex] \ \ or
   \\[.35ex] \bs defabk\{Her Majesty\string's Ship\}\{HMS\}
   \\[.35ex] \ \ and then \bs texttt\{bibsort\}
   \\[.35ex] \ \ will accept \bs abk\{HMS\}.
   \vspace{-1ex}\strut
 }
 {
      \abkdef{HMS}{Her Majesty's Ship}
   \\  or
   \\ \defabk{Her Majesty's Ship}{HMS}
   \\  and then \texttt{bibsort}
   \\  will accept \abk{HMS}.
   \vspace{-1ex}\strut
 }

\noindent 
If a dotted abbreviation is at a dot\hy end of a sentence, you have to
repeat the dot (\verb|\abk{e.\,g.}. Next => |\abk{e.\,g.}. Next) for the
\textit{spacing} (do not use \verb|\@.|)! Use \verb|\printnumabk| (or
\verb|\printabk|) to print a List of Abbreviations:

\vspace{-.325ex}
\printnumabklist

\noindent 
\BibArts\ provides no index with sub\hy items, but registers (geographical,
subject, and person). The commands to fill the registers have one argument;
they are invisible in your text, e.\,g.: \verb|\addtogrr{London}|,
\verb|\addtosrr{Ship}|, and \verb|\addtoprr{Churchill}|\,.
\verb|\printnumgrr|, \verb|\printnumsrr|, and \verb|\printnumprr| the
registers in your appendix. This has nothing do do with \textsc{MakeIndex}.

\vspace{1ex}\noindent 
A last feature of \BibArts\ are fill\hy commands. \verb|\fillper|,
\verb|\fillgrr|, \verb|\fillsrr|, \verb|\fillprr|, and \verb|\fillarq| 
have two arguments. The first has to be identical with the argument of a
\verb|\per|\fhy, or a register\hy command, or the second argument of an
\verb|\arq| command (the archive file informations). You can use
fill\hy commands to add longer text, which you don't want to type every time:

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

\vspace{.5ex}\vfill\noindent 
To change the typeset of \BibArts' arguments, you can only use commands like
\verb|\sffamily| or \verb|\bfseries| in \verb|\renewcommand|, but never
\verb|\textsf| or \verb|\textbf|:

\vspace{1.5ex}\vfill\noindent
{\small\begin{tabular}{lll}
\textsf{Command}    & \textsf{Predefined}          & \textsf{Executed on} \\[.325ex]
\verb|\abkemph|     & \verb|{\sffamily}|           & abbreviations \\
\verb|\kxxemph|     & \verb|{}|                    & k\kern -0.05em Titles (alternative e.\,g.\ \verb|\em|) \\
\verb|\peremph|     & \verb|{\normalfont\scshape}| & periodicals (no \textit{italics}, no \verb|\em|\,!) \\
\verb|\abklistemph| & \verb|{\bfseries}|           & abbreviations on the abk\hy list \\
\verb|\xrrlistemph| & \verb|{}|                    & words on grr\fhy, prr\fhy, and srr\hy lists\\
\end{tabular}}

\end{document}