diff options
author | Karl Berry <karl@freefriends.org> | 2009-10-11 23:17:13 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2009-10-11 23:17:13 +0000 |
commit | 09b9f326659d969748705afa8711a913db0d06a7 (patch) | |
tree | 4a217a979d86370b4486139e25f67298a4992fd2 /Master/texmf-dist/doc/bibtex/tamethebeast/ttb_en.sec3.tex | |
parent | 80e52f52c3f2467f9ea527db9c2a534bfc3cb6cf (diff) |
tamethebeast 1.4 (11oct09)
git-svn-id: svn://tug.org/texlive/trunk@15782 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/bibtex/tamethebeast/ttb_en.sec3.tex')
-rw-r--r-- | Master/texmf-dist/doc/bibtex/tamethebeast/ttb_en.sec3.tex | 60 |
1 files changed, 29 insertions, 31 deletions
diff --git a/Master/texmf-dist/doc/bibtex/tamethebeast/ttb_en.sec3.tex b/Master/texmf-dist/doc/bibtex/tamethebeast/ttb_en.sec3.tex index d1459a7616a..7c295710b18 100644 --- a/Master/texmf-dist/doc/bibtex/tamethebeast/ttb_en.sec3.tex +++ b/Master/texmf-dist/doc/bibtex/tamethebeast/ttb_en.sec3.tex @@ -71,8 +71,8 @@ outermost braces can be replaced by parentheses: the ``argument'' of a ``command'' starting with an \texttt\at{} is considered as a comment. This gives an easy way to comment a given entry: just remove the initial \texttt\at. - As usual when a language allows comments: Don't hesitate to use - them, so that you have a clean, ordered, and easy-to-maintain + As usual when a language allows comments, don't hesitate to use + them so that you have a clean, ordered, and easy-to-maintain database. Conversely, anything starting with an \texttt\at{} is considered as being a new entry\footnote{There is a special entry type named \ent{comment}. The main use of such an @@ -88,7 +88,7 @@ initial~\texttt{\at}.}. \texttt{Example} and \texttt{example}. In the same way, if you cite both \texttt{example} and - \texttt{Example}, \bt will complain. Indeed, it would have to + \texttt{Example}, \bt will complain. Indeed, it~would have to include the same entry twice, which probably is not what you want; @@ -139,22 +139,18 @@ used for the \LaTeX Companion: } \end{verbatimtab} It gives complementary information about the book\footnote{Filling - both \nichp{title} and \nichp{booktitle} for a book may be of real - interest, as we will see in the section dedicated to cross - references (see section~\ref{crossref} for some more details).}, -for - instance the fact that it is available in your local library. -You really - should not hesitate to use auxiliary, personal fields, giving them - explicit names in order to be sure that no bibliography style -will - use them incidentally\footnote{You'll ask ``Is it really - useful?''. First of all, it is not that long to add those - informations each time you add a new entry, and it is much longer -to - add a field to several entries. Moreover, we'll see later how to - design bibliography styles, and you'll be able to write styles - that take those new fields into account.}. +both \nichp{title} and \nichp{booktitle} for a book may be of real +interest, as we will see in the section dedicated to cross references +(see section~\ref{crossref} for some more details).}, for instance the +fact that it is available in your local library. You really should +not hesitate to use auxiliary, personal fields, giving them explicit +names in order to be sure that no bibliography style will use them +incidentally\footnote{You'll ask ``Is it really useful?''. First of +all, it doesn't take long to add those informations each time you add a +new entry; it~takes much longer to add a field to several +entries. Moreover, we'll see later how to design bibliography styles, +and you'll be able to write styles that take those new fields into +account.}. \mysection{The \protect\nient{string} and \protect\nient{preamble} @@ -180,7 +176,7 @@ to define a shortcut for this publisher. Thus we write: \end{verbatimtab} This does not only spare some time, but most importantly, it ensures that -you won't misspell it, and helps you maintain an homogeneous database. +you won't misspell it, and helps you maintain a homogeneous database. I find this really interesting for author names, so that you're sure to always write them correctly (or always incorrectly, but it would be easy to detect and correct a global mistake anyway). @@ -459,7 +455,7 @@ It is a common error to separate names with commas instead of ``\texttt{and}''.} \hline \verb+De La Fontaine, Jean+ & \verb+Jean+ & \verb++ & \verb+De La Fontaine+ \\ \hline -\verb+De la Fontaine, Jean+ & \verb+Jean+ & \verb+De la+ & \verb+fontaine+ \\ +\verb+De la Fontaine, Jean+ & \verb+Jean+ & \verb+De la+ & \verb+Fontaine+ \\ \hline \verb+de La Fontaine, Jean+ & \verb+Jean+ & \verb+de+ & \verb+La Fontaine+ \\ \hline @@ -485,11 +481,13 @@ I think it's a good place for coming back to abbreviations: You probably agree that names are something not that easy to enter, and are error-prone. I personally advise defining an abbreviation for each author. You'll then concatenate them with \verb+``and''+ using -\verb+#+\index{bibtex}{\#@\texttt{\#}(concatenation)}\index{bibtex}{concatenation@concatenation (\texttt{\#})}. +\verb+#+\index{bibtex}{\#@\texttt{\#}(concatenation)}\index{bibtex}{concatenation@concatenation (\texttt{\#})} (actually, even \verb+``and''+ will be defined as an abbreviation). For instance, I always include a \ext{bib} file containing the following lines: \begin{verbatimtab} +@string{and = "and"} +... @string{goossens = "Goossens, Michel"} @string{mittelbach = "Mittelbach, Franck"} @string{samarin = "Samarin, Alexander"} @@ -499,12 +497,12 @@ another one containing: @string{AW = "Addison-Wesley"} \end{verbatimtab} and my main bibliographic file contains\footnote{This is not quite - true, since \texttt{September} still depends on the language, and I - prefer using \texttt{9} and letting the style file translate that + true, since \texttt{December} still depends on the language, and I + prefer using \texttt{12} and letting the style file translate that into the corresponding month in the correct language.}: \begin{verbatimtab} @book{companion, - author = goossens #" and "# mittelbach #" and "# samarin, + author = goossens # and # mittelbach # and # samarin, title = "The {{\LaTeX}} {C}ompanion", booktitle = "The {{\LaTeX}} {C}ompanion", year = 1993, @@ -670,12 +668,12 @@ it.}. But the first character here is You'd probably prefer \texttt{[DLC]} or \texttt{[Cru]}. The second solution would then be \begin{verbatimtab} - author = {\uppercase{d}}e {\uppercase{l}}a Cruz, Maria. + author = "{\uppercase{d}}e {\uppercase{l}}a Cruz, Maria" \end{verbatimtab} The label would be \verb+{\uppercase{d}}{\uppercase{l}}C+, which is correct. Another (easier) proposal would be \begin{verbatimtab} - author = {D}e {L}a Cruz, Maria. + author = "{D}e {L}a Cruz, Maria" \end{verbatimtab} This also solves the problem, because \bt only considers characters at level~0 when determining which part a word belongs to, but takes all letters into account @@ -688,22 +686,22 @@ This is precisely the reverse problem, but the solution will be different. Assume you cite a paper by the famous Spanish scientist \emph{Juan de la Cierva y Codorn\'\i u}. The basic ideas are \begin{verbatimtab} - author = de la Cierva {\lowercase{Y}} Codorn{\'\i}u, Juan + author = "de la Cierva {\lowercase{Y}} Codorn{\'\i}u, Juan" \end{verbatimtab} or \begin{verbatimtab} - author = de la Cierva {y} Codorn{\'\i}u, Juan + author = "de la Cierva {y} Codorn{\'\i}u, Juan" \end{verbatimtab} However, these solutions yields labels such as \verb+CYC+ or \verb+CyC+, where we would prefer \verb+CC+. Several solutions are possible: \begin{verbatimtab} - author = de la Cierva{ }y Cordon{\'\i}u, Juan + author = "de la Cierva{ }y Cordon{\'\i}u, Juan" \end{verbatimtab} or \begin{verbatimtab} - author = de la {Cierva y} Cordon{\'\i}u, Juan + author = "de la {Cierva y} Cordon{\'\i}u, Juan" \end{verbatimtab} Both solutions work: In the first case, \bt won't see the space, and considers that the \verb+y+ belongs to the previous word. In the second case, |