diff options
author | Karl Berry <karl@freefriends.org> | 2015-11-30 22:59:21 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2015-11-30 22:59:21 +0000 |
commit | af61853c84d7141bbb1a12c61553d47cdec19cdf (patch) | |
tree | 3eab1a1757a2ed1ab2158ed2e62c55083c20f4d7 /Master/texmf-dist/doc/latex/bibarts/ba-short.tex | |
parent | 33d76ddabcc1e359bf54570a6b42a6d826f73a45 (diff) |
bibarts (30nov15)
git-svn-id: svn://tug.org/texlive/trunk@38979 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/bibarts/ba-short.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/bibarts/ba-short.tex | 641 |
1 files changed, 641 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/bibarts/ba-short.tex b/Master/texmf-dist/doc/latex/bibarts/ba-short.tex new file mode 100644 index 00000000000..16bf3f28d9d --- /dev/null +++ b/Master/texmf-dist/doc/latex/bibarts/ba-short.tex @@ -0,0 +1,641 @@ + \documentclass[12pt,a4paper]{article} + \usepackage{bibarts} + \bacaptionsenglish + + \title{The \LaTeX-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.0, \copyright\,2015} + + \setcounter{secnumdepth}{0} + + + \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}}} + + +\begin{document} + +\maketitle + +{\small\tableofcontents} + +\vfill\noindent\rule{\textwidth}{.1pt} + +\vspace{1.75ex} +\hbox{\parbox{7.7cm}{\footnotesize\noindent +\textbf{The package consists of eight files 11-29-15:} \\[.75ex] + \begin{tabular}{ll}% + \texttt{bibarts.sty} & The \LaTeX\ style file \\[-1.5pt] + \texttt{ba-short.pdf} & This documentation here \\[-1.5pt] + \texttt{ba-short.tex} & Source of \texttt{ba-short.pdf}\\[-1.5pt] + \texttt{bibarts.pdf} & Full documentation (German) \\[-1.5pt] + \texttt{bibarts.tex} & Source of \texttt{bibarts.pdf} \\[-1.5pt] + \texttt{bibsort.exe} & The sort program \\[-1.5pt] + \texttt{bibsort.c} & Source of \texttt{bibsort.exe} \\[-1.5pt] + \texttt{copying} & The licence of the package \\ + \end{tabular}} +\\ +\hspace*{2.4mm} +\parbox{5.5cm}{\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. +}} + +\vspace{.75ex}\noindent \BibArts~2.0 provides only an \hfill EMULATION +\hfill for 1.3 texts: Keep copies of 1.x? + + +\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 + For citing literature full, you can use then (the 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|-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 having introduced literature in a full v-cite, you may cite it short: + + \vspace{-.6ex}\Doppelbox + { + \bs kli\{LastName\}\{kTitle\}[Pg]. + } + {\vspace{1.75ex} + \kli{LastName}{\kTitle}[Pg]. + } + + \vspace{-.3ex}\noindent + Then, you also can \verb|\printnumvkc| (p.\,\pageref{vkc}) an index of all + short-cited literature (\verb|\kli|, or marked with \verb|\ktit| inside the + last argument of a \verb|\vli|-command). + + \vspace{.75ex}\noindent + Use \verb|\vqu| and \verb|\kqu| \hspace{.1em}in the same way + \hspace{.1em}to cite published historical documents: + +\vspace{-.25ex} +\Doppelbox +{ + ...\bs footnote \b{\b{\{}}See + \\ \hspace{.5em} \bs vqu \{Carl von\} + \{Clausewitz\} + \\ \hspace{2.5em} \b{\{}\bs ktit\{Vom Kriege\}. + \\ \hspace{3em} Hinterlassenes Werk, + \\ \hspace{3em} 3\bs fup\{rd\} ed.\bs\ + \\ \hspace{3em} Frankfurt/M 1991\b{\}}[3].\b{\b{\}}} + \\ ...\bs footnote\{\bs kqu\{Clausewitz\} + \\ \hspace{2.5em} \{Vom Kriege\}[3].\} +} +{ + ...\footnote{See \vqu {Carl von}{Clausewitz} {\ktit{Vom Kriege}. + Hinterlassenes Werk, 3\fup{rd} ed.\ Frankfurt/M 1991}[3].} + \\ ...\footnote{\kqu{Clausewitz} {Vom Kriege}[3].} + \vspace{-.5ex} +} + + \vspace{-.25ex}\noindent + Then, \verb|\printvqu| a list of full \ehinttovquname-entries. $-$ Two + other \BibArts-commands are + + \vspace{-.35ex}\vfill + \Doppelbox + { + \bs per\{Journal\}\string|Vol\string|[Pg] + \\[1ex] + \bs arq\{Unpublished Document\} + \\ \ \{Archive File Sig\}\string_Num\string_(Folio) + } + { + \per{Journal}|Vol|[Pg] + \\[.5ex] + \arq{Unpublished Document} + {Archive File Sig}_Num_(Folio) + } + + \vspace{-.25ex}\vfill\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 +\section{Switches} + If you write an article (instead of a book), you might use the List of + Literature only for control. Set \verb|\conferize| to get cross references + from \verb|\kli| to \verb|\vli|: + + \Doppelbox + {\bs conferize\ ...\bs footnote\{ + \\[.15ex] \ \ Full-cite: \ \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-cite: \bs kli\{Luhmann\} + \\ \ \ \ \ \ \ \{Soziale Systeme\}[23\bs f].\} + } + {\conferize ...\footnote{ + Full-cite: \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-cite: \kli{Luhmann} {Soziale Systeme}[23\f].} + } + + \noindent + If you are never using \textit{both k-commands} \verb|\kli| and + \verb|\kqu|, \verb|\notannouncektit| them in your \textit{v-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 the hint to the + \ehinttovliname-list at short cites. + + +\section{The extra \texttt{*}\{\textit{argument}\} of v- and k-commands} + + To cite \textit{books from teams}, set co-authors in star-arguments; use + x-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{*}-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}(\texttt{s}) 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] + \bs footnote\{ + \\ \ \bs xkli\{Boemeke\} + \\ \ \ *\b{\{}\bs midkauthor\{Chickering\} + \\ \ \ \ \ \bs kauthor\{F\bs\string"orster\}\b{\}} + \\ \ \ \{Anticipating Total War\}[9\bs 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}.} + + \footnote{\xkli{Boemeke}*{\midkauthor{Chickering} \kauthor{F\"orster}}{Anticipating Total War}[9\f]!} + } + + +\section{IBIDEM and inner citations} + + To cite articles in journals, use \verb|\per| inside the last argument of a + v-command: + +\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] +... here.\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].\} +} +{\vspace{-1.02cm} +Do not type spaces before \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].} + +...\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 + 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}). + + If an article is in an edited book, also use a v- or k-command inside a + last v-argument. \verb|\printvli| will print the inner title as short title + on the List of Literature; the full inner title appears as separate list + item (see \underline{Pub} below). To cite further articles from the same + book, you may short-cite also inside: + + \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 (on the List of Literature) an inner +short-citing is not wanted, use \verb|\ntvauthor| instead of the inner +v-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-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 a \texttt{twocolumn}\hy index of all the short +cites you have used, 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 + +\renewcommand{\earqtitlename}{\texttt{\bs printnumarq} \ \memarqtitlename} +\vspace{-.5ex}\printnumarq + +\vfill\noindent +Type \hspace{.01em} \verb|bibsort -??| \hspace{.01em} to DOS to learn about +the sorting order of page numbers. + + +\newpage +\section{Extra features} + +For your \LaTeX\ file, \BibArts\ provides an environment to send unused +literature into the v-lists. If there is no further 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 %% |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}|-\textit{environments} will not appear as own full entries on the +vli-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{\dq} \abra{\dq} => | \hbox to 6em{\fabra{\dq}Good!\abra{\dq}\hfill} \verb|% \dq represents "| \\[-.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, use \verb|\abk{|\textit{xyz}\verb|}|. \textit{xyz} + only will appear on the List of Abbreviations (\verb|\printabk| or + \verb|\printnumabk|), 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-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. That has nothing do do with \textsc{MakeIndex}. + +\vspace{1ex}\noindent +A last feature of \BibArts\ are fill-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|-, or a register-command, or the second argument of an +\verb|\arq| command (the archive file informations). You can use +fill-commands to add longer text, which you do not 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 may 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|{}| & short-cited titles (k\kern -0.05em Titles) \\ +\verb|\peremph| & \verb|{\normalfont\scshape}| & periodicals (no \textit{italics}!) \\ +\verb|\abklistemph| & \verb|{\bfseries}| & abbreviations on the abk-list \\ +\verb|\xrrlistemph| & \verb|{}| & words on grr-, prr-, and srr-lists\\ +\end{tabular}} + + %% BibArts is only able to handle slanted fonts, + %% when you are using only emph-commands. Do not + %% type \textit or \textsl inside the arguments! + +\end{document} |