summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/bibtex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2015-10-25 22:35:35 +0000
committerKarl Berry <karl@freefriends.org>2015-10-25 22:35:35 +0000
commitc4586dcabf84bccd9caaff8f5b8dcb7cffe324a2 (patch)
treeb13405f5685314a93c96e4d3019c35b72ca3bca1 /Master/texmf-dist/doc/bibtex
parent814ed990b7031e0cf517b32095b9a9f0a52ad0a8 (diff)
bestpapers (25oct15)
git-svn-id: svn://tug.org/texlive/trunk@38708 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/bibtex')
-rw-r--r--Master/texmf-dist/doc/bibtex/bestpapers/Makefile35
-rw-r--r--Master/texmf-dist/doc/bibtex/bestpapers/README16
-rw-r--r--Master/texmf-dist/doc/bibtex/bestpapers/bestpapers-guide.pdfbin0 -> 170043 bytes
-rw-r--r--Master/texmf-dist/doc/bibtex/bestpapers/bestpapers-guide.tex158
-rw-r--r--Master/texmf-dist/doc/bibtex/bestpapers/tex.bib108
-rw-r--r--Master/texmf-dist/doc/bibtex/bestpapers/typography.bib214
6 files changed, 531 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/bibtex/bestpapers/Makefile b/Master/texmf-dist/doc/bibtex/bestpapers/Makefile
new file mode 100644
index 00000000000..23f39b480de
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtex/bestpapers/Makefile
@@ -0,0 +1,35 @@
+PACKAGE = bestpapers
+
+TEX = bestpapers-guide.tex
+
+PDF = ${TEX:%.tex=%.pdf}
+
+all: ${PDF}
+
+%.pdf: %.tex bestpapers.bst tex.bib
+ pdflatex $*
+ - bibtex tex
+ - bibtex typography
+ pdflatex $*
+ pdflatex $*
+ while ( grep -q 'may have changed' $*.log) \
+ do pdflatex $<; done
+
+clean:
+ $(RM) *.log *.aux \
+ *.cfg *.glo *.idx *.toc \
+ *.ilg *.ind *.out *.lof \
+ *.lot *.bbl *.blg *.gls \
+ *.dvi *.ps *.thm *.tgz *.zip
+
+distclean: clean
+ $(RM) $(PDF)
+
+archive: all clean
+ cd ..; \
+ tar -czvf $(PACKAGE)/$(PACKAGE).tgz --exclude '*~' --exclude '*.tgz' --exclude '*.zip' --exclude CVS $(PACKAGE); \
+ cd $(PACKAGE)
+
+zip: all clean
+ cd ..; $(RM) $(PACKAGE).zip; \
+ zip -r $(PACKAGE).zip $(PACKAGE)/* -x '*~' -x '*.tgz' -x '*.zip' -x '*CVS*' \ No newline at end of file
diff --git a/Master/texmf-dist/doc/bibtex/bestpapers/README b/Master/texmf-dist/doc/bibtex/bestpapers/README
new file mode 100644
index 00000000000..683da6adcc0
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtex/bestpapers/README
@@ -0,0 +1,16 @@
+ Bestpapers bibliography style
+ Boris Veytsman
+ Version 1.0
+
+Many people preparing their resumes find the requirement ``please list
+five (or six, or ten) papers authored by you''. The same requirement
+is often stated for reports prepared by professional teams. The
+creation of such lists may be a cumbersome task. Even more difficult
+is to support the lists over the time, when one adds new papers. The
+style bestpapers.bst is intended to make this task simpler. It is
+based on the idea that it is easier to score than to sort: we can
+assign a score to a paper, and then let the computer to select the
+papers with highest scores.
+
+This work was commissioned by Consumer Financial Protection Bureau,
+United States Treasury. This package is in the public domain
diff --git a/Master/texmf-dist/doc/bibtex/bestpapers/bestpapers-guide.pdf b/Master/texmf-dist/doc/bibtex/bestpapers/bestpapers-guide.pdf
new file mode 100644
index 00000000000..a7d09b42283
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtex/bestpapers/bestpapers-guide.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/bibtex/bestpapers/bestpapers-guide.tex b/Master/texmf-dist/doc/bibtex/bestpapers/bestpapers-guide.tex
new file mode 100644
index 00000000000..d46e690a0fd
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtex/bestpapers/bestpapers-guide.tex
@@ -0,0 +1,158 @@
+\documentclass{article}
+\usepackage[numbers]{natbib}
+\usepackage{hyperref,alltt}
+\usepackage[resetlabels]{multibib}
+\newcommand{\BibTeX}{\textsc{Bib}\TeX}
+\newcites{tex}{Books and articles about \TeX}
+\newcites{typography}{Books and articles about typography}
+\begin{document}
+
+\title{User Guide for \texttt{bestpapers.bst} Bibliography Style}
+\author{Boris Veytsman\thanks{This work was commissioned by Consumer
+ Financial Protection Bureau, United States Treasury. This file
+ and the package are in the public domain}}
+\date{October 2014}
+\maketitle
+
+\section{Introduction}
+\label{sec:intro}
+
+
+
+Many people preparing their r\'esum\'es find the requirement ``please
+list five (or six, or ten) papers authored by you''. The same
+requirement is often stated for reports prepared by professional
+teams. The creation of such lists may be a cumbersome task. Even more
+difficult is to support the lists over the time, when one adds new
+papers. The style \texttt{bestpapers.bst} is intended to make this task
+simpler. It is based on the idea that it is easier to score than to
+sort: we can assign a score to a paper, and then let the computer to
+select the papers with highest scores.
+
+\section{Simple Usage}
+\label{sec:simple}
+
+The use of the package is simple. We assume that you keep all your
+publications in a \BibTeX\ file (or files). Then,
+\begin{enumerate}
+\item Add to each bibliographic entry in the file the field
+ \begin{alltt}
+ score = \itshape SCORE
+ \end{alltt}
+ where \texttt{\itshape SCORE} is an non-negative integer. The
+ higher the score is, the more you think about the paper. Since only
+ the relation between scores matter, you may limit yourself to scores
+ between, say, $0$ and $100$. An absent score is equivalent to
+ \texttt{score=0}.
+\item Add to the preamble of your r\'esum\'e
+\begin{verbatim}
+\usepackage[numbers]{natbib}
+\end{verbatim}
+ and to the document itself
+\begin{verbatim}
+\renewcommand{\refname}{My Best Works}
+\nocite{*}
+\bibliography{myworks}
+\bibliographystyle{bestpapers}
+\end{verbatim}
+\item You document will get the list of five~best works, sorted by
+ decreasing scores.
+\end{enumerate}
+
+
+\section{Customization}
+\label{sec:custom}
+
+
+Sometimes you need to change the number of best papers displayed.
+The package introduces a new entry type \verb|@SETUP| with the
+field \verb|max.best.papers|, for example,
+\begin{verbatim}
+@SETUP{setup,
+ max.best.papers = 6,
+}
+\end{verbatim}
+
+Normally the score of the papers is not printed. However, for debug
+purposes you can change this: just define the command
+\verb|\PrintScore|, for example
+\begin{verbatim}
+\newcommand{\PrintScore}[1]{Score: #1}
+\end{verbatim}
+
+\section{Bibexport}
+\label{sec:bibexport}
+
+Sometimes you need to extract your best works from \texttt{.bib} files
+rather than typeset the list of them. You can use for this the
+program \textsl{bibexport} (\url{http://www.ctan.org/pkg/bibexport}), a
+handy tool for the manipulation of \BibTeX\ databases. The package
+provides the style \texttt{bestpapers-export.bst} intended for this
+task.
+
+To extract the best works from the files \texttt{myworks.bib} and
+\texttt{ourworks.bib} into the file \texttt{result.bib},
+\begin{enumerate}
+\item Create the file \texttt{extract.aux} with the following content:
+\begin{verbatim}
+\citation{*}
+\bibdata{myworks,ourworks}
+\bibstyle{bestpapers-export}
+\end{verbatim}
+
+\item If necessary, add to any of these files \texttt{@SETUP} entry as
+ described in Section~\ref{sec:custom}.
+\item Run
+\begin{verbatim}
+bibexport -b bestpapers-export -o result.bib export.aux
+\end{verbatim}
+
+\end{enumerate}
+
+
+\section{Multiple Bibliographies}
+\label{sec:multiple}
+
+
+
+Sometimes you need to have collective report and provide several
+best papers for each person in the group. The package
+\texttt{multibib} allows you to do this:
+\begin{verbatim}
+\usepackage{multibib}
+\newcites{chico,harpo,groucho,zeppo}{Chico's Papers,%
+ Harpo's Papers,%
+ Groucho's Papers,%
+ Zeppo's Papers}
+...
+\nocitechico{*}
+\bibliographychico{chico.bib}
+\bibliographystylechico{bestpapers}
+
+\nociteharpo{*}
+\bibliographyharpo{harpo.bib}
+\bibliographystyleharpo{bestpapers}
+
+\nocitegroucho{*}
+\bibliographygroucho{groucho.bib}
+\bibliographystylegroucho{bestpapers}
+
+\nocitezeppo{*}
+\bibliographyzeppo{zeppo.bib}
+\bibliographystylezeppo{bestpapers}
+\end{verbatim}
+
+Note that you may want to use \texttt{resetlabels} option of the
+\texttt{multibib} package if you want all the lists to start from~1.
+
+An example of this usage is the source code of this file, which lists
+6~books about \TeX\ and 5~books about typography separately.
+
+\nocitetex{*}
+\nocitetypography{*}
+\bibliographytex{tex}
+\bibliographystyletex{bestpapers}
+\bibliographytypography{typography}
+\bibliographystyletypography{bestpapers}
+
+\end{document}
diff --git a/Master/texmf-dist/doc/bibtex/bestpapers/tex.bib b/Master/texmf-dist/doc/bibtex/bestpapers/tex.bib
new file mode 100644
index 00000000000..ab277df5ab7
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtex/bestpapers/tex.bib
@@ -0,0 +1,108 @@
+@SETUP{setup,
+ score = 0,
+ max.best.papers = 6,
+}
+
+
+@BOOK{Lamport94,
+ author = {Leslie Lamport},
+ year = 1994,
+ title = {{\LaTeX}: a Document Preparation System},
+ edition = {Second},
+ publisher = {Addison-Wesley Publishing Company},
+ address = {Reading, MA},
+ note = {Illustrations by Duane Bibby},
+ score = 10,
+}
+
+@Manual{MI,
+ author = {P. Cheng and M. A. Harrison},
+ title = {Index Preparation and Processing},
+ year = 1988,
+ month = {October},
+ note = {\url{http://mirrors.ctan.org/indexing/makeindex/paper}},
+ score = 5,
+}
+
+
+@Misc{TeXFAQ,
+ author = {{UK \TeX{} Users Group}},
+ title = {{UK} List of {\TeX} Frequently Asked Questions},
+ year = 2008,
+ howpublished = {\url{http://www.tex.ac.uk/cgi-bin/texfaq2html}},
+ score = 4,
+}
+
+
+@manual{lshort,
+ author = {Tobias Oetiker and Hubert Partl and Irene Hyna and
+ Elisabeth Schlegl},
+ month = {April},
+ note = {\url{http://mirrors.ctan.org/info/lshort}},
+ title = {The Not So Short Introduction to \LaTeXe{}, Or
+ \LaTeXe{} in 174 Minutes},
+ year = {2011},
+ score = 5,
+}
+
+@Book{Mittelbach04:LaTeXCompanion,
+ author = {Frank Mittelbach and Michel Goossens and Johannes Braams
+ and David Carlisle and Chris Rowley},
+ title = {The \LaTeX{} Companion},
+ publisher = {Addison-Wesley Professional},
+ year = 2004,
+ series = {Addison-Wesley Series on Tools and Techniques
+ for Computer Typesetting},
+ address = {Boston},
+ score = 8,
+}
+
+
+@Book{Goossens97:LateXGraphicsCompanion,
+ author = {Michel Goossens and Sebastian Rahtz and Frank Mittelbach},
+ title = { The \LaTeX{} Graphics Companion:
+ Illustrating Documents With \TeX{} and {PostScript}},
+ chapter = {},
+ publisher = {Addison-Wesley},
+ year = 1997,
+ series = {Addison-Wesley Series on Tools and Techniques
+ for Computer Typesetting},
+ address = {Reading, MA},
+ score = 7,
+}
+
+@Book{Goossens99:LaTeXWebCompanion,
+ author = {Michael Goossens and Sebastian Rahtz and
+ Eitan M. Gurari and Ross Moore and Robert S. Sutor},
+ title = {The \LaTeX{} Web Companion:
+ Integrating \TeX{}, {HTML}, and {XML}},
+ publisher = {Addison Wesley Longman},
+ year = 1999,
+ series = {Addison-Wesley Series on Tools and Techniques
+ for Computer Typesetting},
+ address = {Reading, MA},
+ score = 7,
+}
+
+@Book{Knuth94:TheTeXbook,
+ author = {Knuth, Donald Ervin},
+ title = {The \TeX book},
+ publisher = {Addison-Wesley Publishing Company},
+ year = 1994,
+ series = {Computers \& Typesetting A},
+ address = {Reading, MA},
+ note = {Illustrations by Duane Bibby},
+ score = 20
+}
+
+
+@Manual{instr-l,
+ title = {Instructions for Preparation of Papers and
+ Monographs, {AMS\LaTeX}},
+ organization = {American Mathematical Society},
+ month = {August},
+ year = 2004,
+ note = {\url{http://mirrors.ctan.org/macros/latex/required/amslatex/classes/instr-l.pdf}},
+ score = 4,
+}
+
diff --git a/Master/texmf-dist/doc/bibtex/bestpapers/typography.bib b/Master/texmf-dist/doc/bibtex/bestpapers/typography.bib
new file mode 100644
index 00000000000..a96304cfdf8
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtex/bestpapers/typography.bib
@@ -0,0 +1,214 @@
+@Book{Tufte03:PowerPoint,
+ author = {Edward R. Tufte},
+ title = {The Cognitive Style of {Power Point}},
+ publisher = {Graphics Press LLC},
+ year = 2003,
+ address = {Cheshire, CT},
+ score = 10
+}
+
+
+@Book{Gill:Typography,
+ author = {Eric Gill},
+ title = {An Essay on Typography. With a new
+ introduction by Cristopher Skelton},
+ publisher = {David R. Godine},
+ year = 2007,
+ address = {Boston},
+ score = 12
+}
+
+
+@Article{Brumberger03a,
+ author = {Brumberger, Eva R.},
+ title = {The Rhetoric of Typography: The Persona of Typeface and
+ Text},
+ journal = {Technical Communication},
+ year = 2003,
+ volume = 50,
+ number = 2,
+ pages = {206--223},
+ score = 12,
+ annote = {Practitioners typically agree that typefaces have
+personas, and they often suggest specific personas for specific
+typefaces, but these guidelines rely on craftlore rather than on
+empirical evidence. Research on typography has focused primarily on
+readability and legibility issues; there have been few studies
+investigating the personas of typefaces. There is a clear gap in the
+research. With the increased flexibility in design that comes with
+more sophisticated desktop publishing technology, with an ongoing
+shift from printed to electronic documents, and with a growing
+emphasis on visual communication, this gap is becoming increasingly
+important to the field of technical communication. The studies
+discussed here provide strong empirical support for the notion that
+readers ascribe personality attributes both to typefaces and to text
+passages. The data provide a foundation for investigation of the
+interactions between typeface and text persona.} }
+
+
+@Article{Brumberger03b,
+ author = {Brumberger, Eva R.},
+ title = {The Rhetoric of Typography: The Awareness and
+ Impact of Typeface Appropriateness},
+ journal = {Technical Communication},
+ year = 2003,
+ volume = 50,
+ number = 2,
+ pages = {224--231},
+ score = 8,
+ annote = {Technical communicators have an emerging body of research
+ in visual rhetoric on which to build our practice, but little of
+ that work has focused on the rhetorical role of typography. The
+ majority of studies focused on typography have examined instead its
+ role in readability and legibility. A handful of studies have
+ investigated typeface persona, exploring the notion that typefaces
+ carry with them a message distinct from that of the verbal text that
+ they represent, and an additional few have investigated the issue of
+ typeface suitability. The studies presented here extend this
+ discussion by investigating whether clashes in typeface and text
+ persona affect readers\u2019 perceptions of the text.} }
+
+
+
+@Article{Brumberger04,
+ author = {Brumberger, Eva},
+ title = {The Rhetoric of Typography: Effects on Reading
+ Time, Reading Comprehension, and Perceptions of
+ Ethos},
+ journal = {Technical Communication},
+ year = 2004,
+ volume = 51,
+ number = 1,
+ pages = {13--24},
+ score = 9,
+ annote = {Asserts that typography has not occupied a
+ significant role in discussions of visual rhetoric.
+ Extends those discussions by investigating whether
+ typeface persona shapes readers' interactions with a
+ document.}
+}
+
+@Book{Bartram04,
+ author = {Alan Bartram},
+ title = {Bauhaus, Modernism and the Illustrated Book},
+ publisher = {Yale University Press},
+ year = 2004,
+ address = {New Haven, CT},
+ score = 14,
+}
+
+@Book{Tschichold91:FormBook,
+ author = {Jan Tschichold},
+ editor = {Robert Bringhurst},
+ title = {The Form of the Book.
+ Essays on the Morality of Good Design},
+ publisher = {Hartley \& Marks},
+ year = 1991,
+ address = {Point Roberts, Washington},
+ score = 25
+}
+
+
+
+@book{bringhurst2004elements,
+ title={The Elements of Typographic Style},
+ author={Bringhurst, Robert},
+ isbn={9780881792065},
+ lccn={2004053913},
+ year={2004},
+ publisher={Hartley \& Marks, Publishers},
+ address = {Vancouver, BC, Canada},
+ score = 22,
+}
+
+
+@Book{Tschichold98:NewTypography,
+ author = {Jan Tschichold},
+ title = {The New Typography},
+ publisher = {University of California Press},
+ year = 1998,
+ address = {Berkeley and Los Angelos, CA},
+ score = 24,
+}
+
+@Article{Legge11,
+ author = {Gordon E. Legge and Charles A. Bigelow},
+ title = {Does Print Size Matter for Reading?
+ {A} Review of Findings
+ from Vision Science and Typography},
+ journal = {J. Vision},
+ year = 2011,
+ volume = {11(5)},
+ number = 8,
+ pages = {1--22},
+ score = 23,
+ annote = {The size and shape of printed symbols determine the
+legibility of text. In this paper, we focus on print size because of
+its crucial role in understanding reading performance and its
+significance in the history and contemporary practice of
+typography. We present evidence supporting the hypothesis that the
+distribution of print sizes in historical and contemporary
+publications falls within the psychophysically defined range of fluent
+print sizeVthe range over which text can be read at maximum speed. The
+fluent range extends over a factor of 10 in angular print size
+(x-height) from approximately 0.2- to 2-. Assuming a standard reading
+distance of 40 cm (16 inches), the corresponding physical x-heights
+are 1.4 mm (4 points) and 14 mm (40 points). We provide new data on
+the distributions of print sizes in published books and newspapers and
+in typefounders' specimens, and consider factors influencing these
+distributions. We discuss theoretical concepts from vision science
+concerning visual size coding that help inform our understanding of
+historical and modern typographical practices. While economic,
+social, technological, and artistic factors influence type design and
+selection, we conclude that properties of human visual processing play
+a dominant role in constraining the distribution of print sizes in
+common use. } }
+
+@Book{Spiekermann02,
+ author = {Erik Spiekermann and E. M. Ginger},
+ title = {Stop Stealing Sheep \& Find Out How Type Works},
+ publisher = {Adobe Press},
+ year = 2002,
+ address = {Berkeley, CA},
+ edition = {Second},
+ score = 16,
+ ISBN = {978-0201703399}
+}
+
+@InProceedings{Morris02,
+ author = {Morris, R. A. and Aquilante, K. and Yager, D. and
+ Bigelow, C.},
+ title = {Serifs Slow {RSVP} Reading At Very Small Sizes But Don't
+ Matter At Larger Sizes},
+ booktitle = {SID 2002, San Jose, CA: Digest of Technical Papers},
+ pages = {244--247},
+ year = 2002,
+ score = 19,
+ organization = {The Society for Information Display},
+ annote = {Morris, Aquilante, Yager and Bigelow (2002) did find an
+effect of serifs on reading speed, unlike Arditi and Cho. These
+investigators used specially designed versions of the Lucida typeface
+family (Bigelow and Holmes Inc., San Jose, CA), one with serifs and
+one without serifs. Although typical serif and sans-serif fonts differ
+in a variety of attributes, the specially designed Lucida fonts were
+almost identical, apart from the presence or absence of
+serifs. According to Morris et al: "the designers produced a seriffed
+and sans-serif pair whose underlying forms are identical in stem
+weights, character widths, character spacing and fitting, and
+modulation of thick to thin. The only difference is the presence or
+absence of serifs, and the slight increase of black area in the
+seriffed variant." The investigators used the rapid serial visual
+presentation (RSVP) method to measure reading speed for the two font
+variants. For a small print size of 12 min-arc (probably near the
+critical print size, Section 3.2), reading speed was about 20% faster
+for the sans-serif font, but there was no difference in reading speed
+at a larger print size of 48 min-arc} }
+
+@book{Jaspert:TypefacesEncyclopaedia,
+ title={The Encyclop\ae dia of Typefaces},
+ author={Jaspert, W. P. and Berry, W. T. and Johnson, A. F.},
+ year= 2009,
+ publisher={Cassell},
+ edition = {55th Anniversary},
+ address = {London}
+}