From c4586dcabf84bccd9caaff8f5b8dcb7cffe324a2 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 25 Oct 2015 22:35:35 +0000 Subject: bestpapers (25oct15) git-svn-id: svn://tug.org/texlive/trunk@38708 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/bibtex/bestpapers/Makefile | 35 ++++ Master/texmf-dist/doc/bibtex/bestpapers/README | 16 ++ .../doc/bibtex/bestpapers/bestpapers-guide.pdf | Bin 0 -> 170043 bytes .../doc/bibtex/bestpapers/bestpapers-guide.tex | 158 +++++++++++++++ Master/texmf-dist/doc/bibtex/bestpapers/tex.bib | 108 +++++++++++ .../doc/bibtex/bestpapers/typography.bib | 214 +++++++++++++++++++++ 6 files changed, 531 insertions(+) create mode 100644 Master/texmf-dist/doc/bibtex/bestpapers/Makefile create mode 100644 Master/texmf-dist/doc/bibtex/bestpapers/README create mode 100644 Master/texmf-dist/doc/bibtex/bestpapers/bestpapers-guide.pdf create mode 100644 Master/texmf-dist/doc/bibtex/bestpapers/bestpapers-guide.tex create mode 100644 Master/texmf-dist/doc/bibtex/bestpapers/tex.bib create mode 100644 Master/texmf-dist/doc/bibtex/bestpapers/typography.bib (limited to 'Master/texmf-dist/doc/bibtex') 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 Binary files /dev/null and b/Master/texmf-dist/doc/bibtex/bestpapers/bestpapers-guide.pdf 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} +} -- cgit v1.2.3