summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/bibarts/ba-short.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/bibarts/ba-short.tex')
-rw-r--r--Master/texmf-dist/doc/latex/bibarts/ba-short.tex312
1 files changed, 162 insertions, 150 deletions
diff --git a/Master/texmf-dist/doc/latex/bibarts/ba-short.tex b/Master/texmf-dist/doc/latex/bibarts/ba-short.tex
index 0b64496bcbe..38fe449fdc4 100644
--- a/Master/texmf-dist/doc/latex/bibarts/ba-short.tex
+++ b/Master/texmf-dist/doc/latex/bibarts/ba-short.tex
@@ -1,17 +1,22 @@
+%% BibArts 2.3 assists you to write LaTeX texts in arts and humanities.
+%% Copyright (C) 2021 Timo Baumann bibarts[at]gmx.de (2021/12/06)
+%%% LaTeX + "bibsort -i ba-short -m -utf8 -k -e -h" + LaTeX %%%
+
+
\documentclass[12pt,a4paper]{article}
- \usepackage{bibarts} \usepackage[utf8]{inputenc} %\usepackage[english]{babel}
-
- %% bibsort -h -k
+ \usepackage{bibarts}
+ \usepackage[utf8]{inputenc}
+ %\usepackage[english]{babel}
\bacaptionsenglish
\setlength{\footnotesep}{2ex} %% ... as in bibarts.sty 2.0; see README.txt %%
\hyphenation{Last-Name}
- \title{The \LaTeX\hy Package \BibArts \\[.25ex] {\normalsize\slshape
- A package to assist in making bibliographical features common in the arts}}
+ \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{\textsc{Timo Baumann}}
- \date{\small Version 2.2, \copyright\,2019}
+ \date{\small Version 2.3 (2021). \hspace{1em}\copyright\ 2.x (2021, 2019, 2016, 2015).}
\setcounter{secnumdepth}{0}
%\renewcommand{\kxxemph}{\em}
@@ -44,6 +49,7 @@
\pagestyle{myheadings}
+
\begin{document}
\maketitle \thispagestyle{empty}
@@ -54,7 +60,7 @@
\vspace{1.75ex}
\hbox{\parbox{7.7cm}{\footnotesize\noindent
-\textbf{\BibArts~2.2 (9 files, 8 dated 2019\ko/03\ko/03):} \\[.875ex]
+\textbf{\BibArts~2.3 (9 files, 8 dated 2021\ko/12\ko/06):} \\[.875ex]
\begin{tabular}{ll}%
\texttt{README.txt} & Version history since 1.3 \\[-1.75pt]
\texttt{bibarts.sty} & The \LaTeX\ style file \\[-1.75pt]
@@ -96,29 +102,28 @@
default is \verb|\bacaptionsgerman|.
\vspace{.75ex}\noindent
- Full references to literature are created with (a page number \verb|[Pg]| is optional):
+ You need to write the full reference once (the page number \verb|[Pg]| is optional):
\vspace{-.4ex}
\Doppelbox
{
\bs vli\{FirstName\}\{LastName\}
\\ \ \ \{The \bs ktit\{kTitle\},
- \\ \ \ \ Publishing Reference\}[Pg].
+ \\ \ \ \ place and year of
+ \\ \ \ \ publication\}[Pg].
}
{
\vli{FirstName}{LastName}
- {The \ktit{\kTitle}, Publishing Reference}[Pg].
+ {The \ktit{\kTitle}, place and year of publication}[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.
+ This full reference will also be found in the Bibliography (see \verb|\printvli| on p.\,\pageref{appendix}). The \BibArts' program
+ \texttt{bibsort} creates your List of Literature.
+ You have to enter at the prompt: (1) \LaTeX\ \textit{file}, (2) \texttt{bibsort} \texttt{-utf8} \textit{file}, (3) \LaTeX\ \textit{file}.
\vspace{.75ex}\noindent
- After you have introduced literature fully, you may use a shortened reference:
+ After the first full citation (\kern -0.02em\textsf{v}oll), you may use shortened references (\textsf{k}urz\kern -0.02em):
\vspace{-.6ex}
\Doppelbox
@@ -131,7 +136,7 @@
\vspace{-.3ex}\noindent
Use \verb|\vqu| and \verb|\kqu| \hspace{.1em}in the same way
- \hspace{.1em}to cite published historical documents:
+ \hspace{.1em}to cite published documents (\kern -0.04em\textsf{Qu}ellen\kern -0.02em):
\vspace{-.25ex}
\Doppelbox
@@ -151,7 +156,7 @@
\vspace{-.25ex}\noindent
Then, \verb|\printvqu| will print a List of Published Documents
- (full references).
+ (full references\kern -0.02em).
\vspace{.75ex}\noindent
And \verb|\printnumvkc| (p.\,\pageref{vkc}) will print an index
@@ -185,7 +190,7 @@
\newpage
\noindent
-In footnotes and \texttt{minipage} footnotes, \BibArts\ is introducing
+In footnotes, and \texttt{minipage} footnotes, \BibArts\ is introducing
\textsc{ibidem} automatically. That means, that \verb|\kli|, \verb|\kqu|,
\verb|\per|, and \verb|\arq| can change to \textsc{ibidem}:
@@ -222,17 +227,17 @@ In footnotes and \texttt{minipage} footnotes, \BibArts\ is introducing
\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 if you once have setted a \verb+|Vol|+,
+ you are free to add a \verb+|Vol|+, or not. But if you set a \verb+|Vol|+ once,
you will have to repeat that, when you refer to the same book in the following
footnote (or say \verb|\clearbamem|).
- \verb+[Pg]+ is equivalent.\footnote{\kli{Luhmann}{Soziale
- Systeme}|1|[22], and \kli{Luhmann}{Soziale Systeme}|1|[23].}
- Here are different page numbers in the foregoing
- footnote.\footnote{\kli{Luhmann}{Soziale Systeme}|1|[23]. Next sentence.}\,%
+ \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
+ 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}
@@ -246,8 +251,8 @@ In footnotes and \texttt{minipage} footnotes, \BibArts\ is introducing
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| is adding to the entry in the
- arq\hy list, that ``Nr.\,108'' has 2 volumes \baref{arqlist}.
+ The \verb|\fillarq| above adds to the entry in the
+ \texttt{arq}\hy list that ``Nr.\,108'' has 2 volumes \baref{arqlist}.
\newpage
@@ -281,20 +286,19 @@ In footnotes and \texttt{minipage} footnotes, \BibArts\ is introducing
}
\noindent
- If \textit{k\fhy commands} \verb|\kli| and \verb|\kqu| are never
- used, \verb|\notannouncektit| shortened references at \textit{v\fhy commands}
+ If \texttt{k}\textit{\fhy commands} \verb|\kli| and \verb|\kqu| are never
+ used, \verb|\notannouncektit| shortened references at \texttt{v}\textit{\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,
- because there is only one \textit{v-list}.
+ because there is only one \texttt{v}\textit{\fhy list}.
-\section{The extra \texttt{*}\{\ko\textit{argument}\} of v- and k\fhy commands}
+\section{The extra \texttt{*}\{\ko\textit{argument}\} of \texttt{v}- and \texttt{k}\fhy commands}
- To cite \textit{books from teams}, set co\hy authors in star\hy arguments; use
- x\fhy commands:
+\textit{Works by multiple authors} use \texttt{x}\fhy commands with co\hy authors in \texttt{*}\hy arguments:
\Doppelbox
{
@@ -320,8 +324,7 @@ In footnotes and \texttt{minipage} footnotes, \BibArts\ is introducing
}
\noindent
- You may use a \texttt{*}\fhy argument also in \verb|\vli| $-$ to mask text in the
- ibidemization:
+ You may also use \texttt{*}\fhy arguments to mask text (\verb|\editor|) in the ibidemization:
\Doppelbox
{
@@ -346,50 +349,50 @@ In footnotes and \texttt{minipage} footnotes, \BibArts\ is introducing
\newpage
\noindent
- For books with three or more authors, you have to set all `middle' authors
+ For works 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|):
\vspace{-.125ex}
\Doppelbox
{
- ...\bs footnote\{See
+ ...\bs footnote \b{\b{\{}}See
\\ \ \bs xvli\{Manfred F.\}\{Boemeke\}
\\ \ \ *\b{\{}\bs midvauthor\{Roger\}
\\ \ \ \ \ \ \ \ \ \ \ \{Chickering\}
\\ \ \ \ \ \bs vauthor\{Stig\}\{Förster\}\%
- \\ \ \ \ \ \bs onlyvoll\{ \bs editors\}\b{\}}
- \\[.2ex] \ \ \b{\{}\bs ktit\{Anticipating Total War\}.
+ \\ \ \ \ \ \bs onlyvoll\{ \bs editors\}\b{\}}
+ \\[.2ex] \ \ \{\bs ktit\{Anticipating Total War\}.
\\ \ \ \ The German and American
\\ \ \ \ Experiences 1871-{}-1914,
- \\ \ \ \ Cambridge/U.K. 1999\b{\}}.\}
- \\[1ex]
- ... all LastNames.\bs footnote\{
+ \\ \ \ \ Cambridge/U.\bs,K. 1999\}.\b{\b{\}}}
+ \\[.275ex]
+ ... all LastNames.\bs footnote \{
\\ \ \bs xkli\{Boemeke\}
\\ \ \ *\b{\{}\bs midkauthor\{Chickering\}
\\ \ \ \ \ \bs kauthor\{Förster\}\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
+ \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/U.K. 1999}.}
+ The German and American Experiences 1871--1914, Cambridge/U.\,K. 1999}.}
- You have to repeat all LastNames, but not the argument of
- \texttt{\bs onlyvoll}.\footnote{\xkli{Boemeke}*{\midkauthor{Chickering} \kauthor{Förster}}
- {Anticipating Total War}[9\f]!}
+ 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{IBIDEM and inner references to literature}
+\section{Refer to different articles from the same source}
-\vspace{-.125ex}
- To cite articles in journals, use \verb|\per| inside the last argument of a
- v\fhy command:
+\vspace{-.75ex}
+Use \verb|\per| inside the last argument of a \texttt{v}\fhy command to cite articles in journals:
\Doppelbox
{
@@ -438,50 +441,53 @@ 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}).
+ separators (see in note~\ref{third}: {\footnotesize no.\,470}).
\noindent
- To cite articles in books, you can use \verb|\vli|\,+\,\verb|\ktit| for the book
- \textit{inside the last v\fhy argument}. \verb|\printvli| is \textit{printing} such inner
- references \textit{as shortened references}; the \textit{full inner reference}
+ To cite an article from a book, you may use \verb|\vli| for the book
+ \textit{inside the last} \texttt{v}\textit{\fhy argument}.
+ \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 inner \verb|\kli| for the book:
+ the same book, you may use an inner \verb|\kli| for the book:
+ \vspace{-.25ex}
\Doppelbox{
- ...\bs footnote\{\bs vli\{FN1\}\{LN1\} \b{\b{\{}}The
- \\[-.2ex] \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \bs ktit\{First\},
- \\[.25ex] \ in: \bs vli\{iFN\}\{iLN\}\{The \bs ktit\{iT\}
- \\[.25ex] \ \ \ \bs protect\bs underline\{Publ\}\}\b{\b{\}}}.\}
- \\[1ex] \bs footnote\{\bs kli\{LN1\}\{First\}.\}
- \\[1ex] \bs footnote\{\bs vli[m]\{FN1\}\{LN1\} \b{\{}The
- \\[.2ex] \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \bs ktit\{Second\},
- \\[-.05ex] \ in: \bs kli\{iLN\}
- \\[.15ex] \ \ \ \{iT\}[PgBegin\bs hy PgEnd]\b{\}}*[Pg].\}
+ \bs footnote\{\bs vli\{\} \{Pitt\} \b{\b{\{}}The
+ \\[-.2ex] \ \ \ \ \ \ \ \ \ \ \ \ \ \ \bs ktit\{First\}, in:
+ \\[.25ex] \bs vli\{J.\}\{Yi\}\{The \bs ktit\{iT\}
+ \\[.25ex] \ \ \ \ \ \ \ \ \ \ \bs underline\{Publ\}\}\b{\b{\}}}.\}
+ \\[.75ex] \bs footnote\{\bs kli \{Pitt\}\{First\}.\}
+ \\[1ex] \bs footnote\{\bs vli[m]\{\}\{Pitt\}\b{\{}The
+ \\[.2ex] \ \ \ \ \ \ \ \ \ \ \ \bs ktit\{Second\}, in:
+ \\[-.05ex] \ \ \ \ \ \ \ \ \bs kli\{Yi\}\{iT\}[7-9]\b{\}}*[8].\}
}
{
\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{Publ}}}.}
- \footnote{\kli{LN1}{First}.}
- \footnote{\vli[m]{FN1}{LN1} {The \ktit{Second}, in: \kli{iLN}{\protect\fbox{iT}}[PgBegin\hy PgEnd]}*[Pg].}
+ \footnote{\vli {}{Pitt}{The \ktit{First}, in: \vli{J.}{Yi} {The \ktit{\protect\fbox{iT}} \underline{Publ}}}.}
+ \footnote{\kli {Pitt}{First}.}
+ \footnote{\vli[m]{}{Pitt} {The \ktit{Second}, in: \kli{Yi}{\protect\fbox{iT}}[7-9]}*[8].\vspace{1ex}\strut}
}
\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:
+If the shortened inner referencing in the bibliography and the inner ibidemization in footnotes
+is not wanted, use \verb|\ntvauthor| instead of the inner \verb|\vli|:
+\vspace{-.275ex}
\Doppelbox
{
+ \vspace{.225ex}
\bs footnote\{\bs vli\{Jost\}\{Dülffer\}
- \\ \ \{\bs em \bs ktit\{Einleitung\}\bs em, in:
- \\ \ \ \bs ntvauthor\{Jost\}\{Dülffer\}
- \\ \ \ Bereit zum Krieg\}[9].\}
- \\[1ex]
+ \\[.35ex] \ \b{\{}\bs em \bs ktit\{Einleitung\}\bs em, in:
+ \\[.35ex] \ \ \bs ntvauthor\{Jost\}\{Dülffer\}
+ \\[.35ex] \ \ Bereit zum Krieg\b{\}}[9].\}
+ \\[2.25ex]
\bs footnote\{\bs kli\{Dülffer\}
- \\ \ \{Einleitung\}[9].\}
+ \\ \ \ \ \ \ \ \ \{Einleitung\}[9].\}
}
{
- This is also an example to show how to {\em emphasize}
- inside the full title.\footnote{\vli{Jost}{Dülffer}
+ \texttt{\bs emph\{\bs ktit\{}\fabra{...}\texttt{\}\}} masks {\scriptsize cited as \fabra{...}},\vspace{-.1ex}
+ so use \texttt{\bs em} \abra{...}\,\texttt{\bs em} to emphasize!\footnote{\vli{Jost}{Dülffer}
{\em \ktit{Einleitung}\em, in:
\ntvauthor{Jost}{Dülffer} Bereit zum Krieg}[9].}
\footnote{\kli{Dülffer}
@@ -490,9 +496,9 @@ is not wanted, use \verb|\ntvauthor| instead of the inner v\fhy command:
\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):
+If you use \verb|\printnumvli| instead of \verb|\printvli|, an
+\textit{index referring to page and footnote numbers} will be printed.
+Here, \fbox{iT} is a centrally defined inner\,k\kern -0.05em Title:
\vfill
{\baonecolitemdefs\printnumvlilist}
@@ -509,22 +515,22 @@ footnote numbers will be printed additionally (\textsc{iLN}: inner\,LastName
\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:
+In the case of multiple works by one author,
+you may enter \hspace{.25em} \texttt{bibsort -k }...\ \hspace{.005em} at the prompt.
+Then, in both \texttt{v}\fhy lists, \BibArts\ inserts \hspace{.05em} $\sim$ \hspace{.005em}
+instead of the repeated \textit{first name and last name}.
+And \texttt{-e} prints the last names of co\hy authors first. Anyway,
+\label{appendix} \hspace{.25em}\verb|\printbibtitle| \verb|\printvli| \verb|\printvqu|
+\hspace{.3em}insert your bibliography:
\printbibtitle \printvli \printvqu
\vfill\noindent
-To change the size, in which a list is printed,
-you may type e.\,g.\ \verb|{\small| \verb|\printvli}|. \BibArts\
-provides further commands to be executed on bigger lists:
-\verb|\bibsortheads| will print capital letters between two items inside the
-lists, if the initial letter changes, whereas \verb|\bibsortspaces| will
-print only a bigger vertical space there instead. Both features are
-prepared by \verb|bibsort|.
+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}| places a capital letter
+as separator at the beginning of each group of entries starting with the same letter,
+whereas \verb|{\bibsortspaces| \verb|\printvli}| only inserts additional vertical space there instead.
\newpage
@@ -552,35 +558,34 @@ your list without \texttt{headings} or title:\vspace{.5ex}
\vspace{-.5ex}\printnumarq
\vspace{2ex}\noindent
-If you type \verb|\arqsection{GStAPK}{Geheimes Staatsarchiv}|,
-you will get ``\textsf{GStAPK} $-$ \textbf{Geheimes Staatsarchiv}''
-on top of all GStAPK\hy entries.
+\verb|\arqsection{GStAPK}{Geheimes Staatsarchiv}| may introduce
+a headline ``\textsf{GStAPK} $-$ \textbf{Geheimes Staatsarchiv}''
+above all GStAPK\fhy entries in the list.
\newpage
\section{Additional features}
-\BibArts\ provides an environment to send unused bibliographical information into
-the lists. This information appears on the vqu\fhy list, but is invisible here:
+The following work is not mentioned in the text, but appears on the \texttt{vqu}\hy list:
-\vspace{-1.25ex}
+\vspace{-1.1ex}
{\footnotesize\begin{verbatim}
- !\begin{unused} \sethyphenation{ngerman}% %% other hyphenation optional
+ !\begin{unused} \sethyphenation{ngerman}% %% hyphenation travels along
\vqu{Karl}{Marx}{Das \ktit{Kapital}, in: \midvauthor{Karl}{Marx}
\ntvauthor{Friedrich}{Engels} Werke, \ersch|3|[1]{Berlin}{1962--1964}}
- \end{unused}! Note, that in %% vol.|3| and ed.[1] are optional
+ \end{unused}! Note, that %% vol.|3| and ed.[1] are optional
\end{verbatim}}
\vspace{-1.25ex}\noindent
!\begin{unused} \sethyphenation{ngerman}% %% other hyphenation optional
\vqu{Karl}{Marx}{Das \ktit{Kapital}, in: \midvauthor{Karl}{Marx}
\ntvauthor{Friedrich}{Engels} Werke, \ersch|3|[1]{Berlin}{1962--1964}}
- \end{unused}! Note, that in %% vol.|3| and ed.[1] are optional
-\verb|{unused}|\hy environments, \textit{inner v-commands} will not send
-an own item (full reference) to the v\hy list; so, you have to repeat
-them separately.
+ \end{unused}! Note, that %% vol.|3| and ed.[1] are optional
+\textit{inner} \texttt{v}\textit{\fhy commands} in \verb|{unused}|\hy environments
+do not send an own item to the \texttt{v}\fhy lists. So, such inner entries
+have to be repeated separately.
-\vspace{1ex}\noindent
+\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
settings, which your \LaTeX\ possesses, in the \verb|[|\textit{optional
@@ -588,28 +593,31 @@ argument}\verb|]| of the environment:
\vspace{-.5ex}
\Doppelbox
-{\vspace{.3ex}
+{\vspace{.5ex}
\bs begin\{originalquote\}[german]\%old
\\[.4ex] \ \ \string`\string`Dies ist die erste
\\ \ \ Wechselwirkung und das
- \\ \ \ erste Äu\bs hyss erste, \bs fabra
- \\ \ \ \{...\}.\string'\string'\bs footnote \b{\{}This \string`inner
- \\ \ \ \ \ Eszett\string' splits new:
- \\ \ \b{\b{\{}}\bs sethyphenation\{ngerman\}
+ \\ \ \ erste Äu\bs hyss erste,
+ \\ \ \ \bs fabra\{...\}.\string'\string'\bs footnote \ \b{\{}The
+ \\ \ Eszett splits different here:
+ \\ \ \b{\b{\{}}\bs sethyphenation\{ngerman\} \%new
\\[-.4ex] \ \ Au\bs hyss er\b{\b{\}}}. \bs kqu\{Clausewitz\}
\\[-.4ex] \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \{Vom Kriege\}[19].\b{\}}
\\[.3ex] \bs end\{originalquote\}
- \vspace{.2ex}
+ \vspace{.3ex}
}
{\renewcommand{\originalquotetype}{\footnotesize}%
\begin{originalquote}[german]%old
``Dies ist die erste
Wechselwirkung und das
- erste Äu\hyss erste, \fabra
- {...}.''\footnote {This `inner
- Eszett' splits new:
- {\sethyphenation{ngerman}
- Au\hyss er}. \kqu{Clausewitz}
+ erste Äu\hyss erste,
+ \fabra{...}.''\footnote {The
+ Eszett splits different here:
+ {\sethyphenation{ngerman} %new
+ %% 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{ (old AND new)!}%
@@ -619,27 +627,29 @@ argument}\verb|]| of the environment:
}
\vspace{-.125ex}\noindent
-In quotations, you may use \verb|\abra| to print certain
-additives in small angular brackets; \verb|\fabra| affixes
-the argument to the following text (no line breaks):
+In quotations, you may use \verb|\abra| to insert additions.
+Use \verb|\fabra| to prevent a line break between the closing bracket and the following text.
+\BibArts\ puts height\hy adjusted square brackets around the following additions:
\vspace{.75ex}\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|% or \abra{\dq}| \\[-.25ex]
- \verb| \fabra{e}g. => | \hbox to 6em{\fabra{e}g.\hfill} \verb|% unknown = normal|}
+ \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 doublequote). %%
+ \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{`}Marks\fabra{'}.\hfill} \verb|% U+0060 and U+0027| \\[-.25ex]
+ \verb| \fabra{``} \abra{''} => | \fabra{``}Good!\abra{''} \\[-.25ex]
+ \verb| \fabra{"} \abra{"} => | \hbox to 6em{\fabra{"}Good!\abra{"}\hfill} \verb|% or \abra{\dq}| \\[-.25ex]
+ \verb| \abra{sic!}.'' => | \hbox to 6em{\fabra{sic!}.''\hfill} \verb|% unknown=>normalsize|}
\vspace{1.5ex}\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:
+(if that command for \textit{French up} is undefined) and does also
+help to set ordinals in English, French and German:
\vspace{.875ex}\vfill\noindent
{\small
@@ -650,9 +660,9 @@ commands to set ordinals in English, French and German:
\newpage\noindent
- For printing formatted abbreviations in your text, you may use
- \verb|\abk{|\textit{xyz}\verb|}|. \textit{xyz} will only appear
- on the List of Abbreviations, if it is resolved (defined):
+ To print a formatted \textit{abbreviation} in your text, you may use
+ \verb|\abk{|\textit{xyz}\verb|}|. It will only appear
+ on the List of Abbreviations, if you say what it stands for:
\vspace{-.25ex}
\Doppelbox
@@ -674,9 +684,9 @@ commands to set ordinals in English, French and German:
}
\noindent
-For a correct spacing at the end of a sentence, you can repeat
-a full stop: \verb|\abk{U.\,K.}. Next |... \verb|=>| \abk{U.\,K.}. Next
-... (also: \verb|\abk{e.\,g.}. Next |...).
+For a correct spacing at the end of a sentence, you have to set
+a separate full stop: \verb|\abk{U.\,K.}. Next |... \verb|=>| \abk{U.\,K.}. Next
+... (or \verb|\abk{e.\,g.}. Next|).
You may use \verb|\printnumabk| (or \verb|\printabk|) to print a
List of Abbreviations:
@@ -684,21 +694,22 @@ List of Abbreviations:
\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}|,
+\BibArts\ provides up to three \textit{registers} (geographical, subject, and person).
+The commands to feed them have one argument. It is
+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}.
+Use \verb|\printnumgrr|, \verb|\printnumsrr|, and \verb|\printnumprr|
+to print the lists. They are prepared by \texttt{bibsort}. This
+has nothing to do with \textsc{MakeIndex}.
\vspace{1ex}\noindent
A last feature of \BibArts\ are fill\hy 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\hy entry or \verb|\per|\hy command, or \textit{the second}
-argument of an \verb|\arq|\hy command (the archive file information). Use
-fill\hy commands for adding text componds, which you don't want to type
-in every single entry:
+of a register\hy entry, or \verb|\per|\hy command, or \textit{the second}
+argument of an \verb|\arq|\hy command (the archive file information).
+Fill\hy commands may be used at a central position to add information to
+an entry on the list:
\vspace{-.25ex}
\Doppelbox
@@ -736,8 +747,7 @@ in every single entry:
}
\vspace{.5ex}\vfill\noindent
-Please use commands like \verb|\bfseries| to change
-the fonts, but not \verb|\textbf|:
+Please use commands like \verb|\bfseries| to \verb|\renewcommand| fonts, not \verb|\textbf|:
\vspace{1.5ex}\vfill\noindent
@@ -746,10 +756,12 @@ the fonts, but not \verb|\textbf|:
\verb|\xrrlistemph| & \verb|{}| & entries on grr\fhy, srr\fhy, and prr\hy lists\\
\verb|\abkemph| & \verb|{\sffamily}| & abbreviations in your text \\
\verb|\abklistemph| & \verb|{\bfseries}| & abbreviations on the abk\hy list \\
-\verb|\kxxemph| & \verb|{}| & last argument of k\hy commands \\
-\verb|\peremph| & \verb|{\normalfont\scshape}| & periodicals (\,\verb|=> {\upshape}|\,) \\
+\verb|\kxxemph| & \verb|{}| & last argument of \texttt{k}\fhy commands \\
+\verb|\peremph| & \verb|{\normalfont\scshape}| & periodicals \verb| %{\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}