listbib-doc.
Contents
1. P will create a PostScript file and then delete all others To only generate a mybib ps from mybib bib use P 0 An error is displayed if the tex file to be created already exists and is not one generated by listbib 3 9 To Do and Bugs Inheritance is currently only checked for the fields note annote ISBN ISSN library totalpages and URL Printing of these fields is suppressed for all entry types if inherited Should printing of other inherited fields be suppressed as well I am less inclined to suppress volume and I am not sure about year month etc Please let me know what you think As a future enhancement one could place a word from the starting and the finishing entry on each page into the page header like it is in a dictionary Some kind of section title above each bib file would be useful 4 Implementation 4 1 Main Document for Quick Use The intended usage is this newcommand listbibs bibliographies input listbib 1 xmaindoc 2 documentclass 10pt twoside article Set document margins if package vmargin is installed Load package url if available this package provides an excellent Nur1 command which can be used in bibliography entries 3 Packages 4 IfFileExists vmargin sty use if available 5 usepackage vmargin 6 setmarginsrb 25mm 12mm 22mm 8mm 10pt 8mm 10mm 7 IfFileExists url sty usepackage url load if installed 8 4 Layout 9 fboxsep 0 8pt normally 3pt2. 12 citex nocite bibliographystyle bibliography nocite bibliographystyle bibliography 4 6 Citation Key In our documents Ncite will print the cite key in typewriter with a framed box around In fact Ncite expands to citex which has an optional argument The flag if tempswa shows if this optional argument is there texttt will alter if tempswa So might fbox and ttfamily in the future fbox does not work inside if and Mb sanitize does not work inside a def so we save the flag in cxt 73 def citex 1 2 if tempswa def cxt y else let cxt relax fi 74 fbox ttfamily lb_sanitize 2 75 if y cxt ttfamily lb_sanitize 1 fi 4 7 Defaults for nocite and bibliographystyle First the original definitions of the to be redefined control sequences are saved We define two macros which will issue the default given above These macros are not private but protected a knowing user may redefine the default bibliography style in this way 76 let nocite nocite 77 let bibliographystyle bibliographystyle 78 let bibliography bibliography If nocite or bibliographystyle is issued the default tags are discarded the original meaning is restored and the control sequence is reissued again 79 def AddNocite nocite 80 def AddBibliographystyle bibliographystyle listbib 81 def nocite 82 let AddNocite relax 83 let nocite nocite 84 nocite 85 Y 86 N
3. quad textsf small 1 penalty highpenalty 51 4 5 Annotation A reference is divided into blocks starting with newblock Each block shall start a new line We use newline for this A special block is the one with an annotation in it Since we want to indent this block once more we must change the parshape But then we have to finish the paragraph first The annotation block starts with annote and may be easily recognized in this way 52 def newblock 53 futurelet next checkAnnote 54 55 def checkAnnote 56 ifx next annote else newline fi 57 The annotation is a paragraph on its own and indented by leftmargin Since it is not a paragraph in the logical sense we do not insert vertical glue i e parskip at the top The annotation is typeset in a smaller size We assume that it consists of full sentences which might be made up in a proper way Therefore we don t use a ragged margin here The change of parshape has to be reset after the group these changes are not local 58 def annote 59 endgraf 60 vskip parsep 61 begingroup 62 reset font footnotesize 63 rightskip z skip 64 advance linewidth leftmargin 65 advance totalleftmargin leftmargin 66 parshape ne totalleftmargin linewidth 67 The period in the definition is used to gobble the period placed by BIBTEX 68 def endannote 69 endgraf 70 endgroup 71 parshape ne totalleftmargin linewidth 72 Y
4. above format if you use a bibliography style other than listbib which does not supply this information with the assumed markup The parenthesis around the library info are produced by this style option not by BIBTEX 3 4 Example Suppose there is a file typography bib with references on typography typography bib 13 Jan 92 References on Typography Typesetting and Book Design 4 make sure it s at least defined preamble providecommand MF textsc meta font book typo tschichold selected author Jan Tschichold title Ausgew ahlte Aufs atze uber Fragen der Gestalt des Buches und der Typographie publisher Birkh auser address Basel year 1975 isbn 3 7643 1946 1 note A second unchanged edition appeared in 1987 library annote A collection of his classic papers The best book on typographic principles read so far A definitive emph must read for everyone interested in typography book design or typesetting article typo blostein music author Dorothea Blostein title Justification of Printed Music journal cacm volume 34 number 3 month mar year 1991 pages 88 99 annote Presents problems and solutions of the task to create a correct spacing while setting notes The proposed method also takes the temporal relationship of notes into account Handles two dimensional layout e g staffs and texts book ty
5. Sok oes se ila Yee OR P Ee ded 10 43 Lhe Bibliography 2 3 a necnon pa RS a e a 10 Aca DBrAry 3 6 E EAS av RED rh hx As a le D Ea 11 4 5 Annotatioli 2 oe PM SEM bea eee Boe EA a 8 12 4 6 Citation Wey 2 usu LAO aie Gn RS hae Ste eed Ae XS ee a 13 4 7 Defaults for nocite and bibliographystyle 13 4 8 Bibliographies and Title 0 0000 13 49 Page header si prine one RR ESAS DREAD eee s 14 4 10 Site Configuration File ees 14 ANT EirHSh aevi 3h EROS Rd BO ate toe i pU e OE E ded 15 1 License This package is copyright 2000 by Volker Kuhlmann c o University of Canterbury ELEC Dept Creyke Road Christchurch New Zealand E Mail v kuhlmann elec canterbury ac nz 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 To obtain a copy of the license write to the Free Software Foundation Inc 59 Temple Place Suite 330 Boston MA 02111 1307 USA or browse http www fsf org 2 History This package is derived from biblist version 1 4 1992 01 13 by Joachim Schrod J Schrod s association with the university of Darmstadt seems to no longer exist biblist is available from C TAN and is under the GNU general public license version 1 or later listbib is the successor and will only work with IATEX 2e I
6. The listbib Package Volker Kuhlmann 2000 08 28 Abstract This package typesets a listing of a possibly large BIBTEX input file With old implementations of texmf the string space could easily be exceeded when trying to typeset large bibliographic databases Contemporary imple mentations are usually big and have much higher limits However listbib works with arbitrarily large BIBTEX database files In addition to that listbib tries to show the full content of a BIBTEX file without alterations introduced by the bibliographic style used The entry fields ISBN ISSN annote library totalpages and URL are added to the standard ones Contents 1 License 2 2 History 2 3 User manual 34b Introducti n i 6 QR EG eee ha GER Ae bd 3 2 Additional BIBTEX Entry Fields llle 3 3 Formatting of the entries in the resulting listing 3 4 Example ue kou o Ae UR RH sare ud ee qe ud 3 5 Site Configuration File leen 3 6 Inheriting Field Entries ens 3 7 The listbib tex Main Document Frame 3 8 The listbib Shell Script llle 3 9 To Do and Bugs i serpa Goh kB Re Se Sete fae Soka ee EG dun OmMoOoNN KEK WWW This file has version number v2 2 last modified 2000 08 28 Email v kuhlmannGelec canterbury ac nz For a postal address refer to the license section 4 Implementation 9 4 1 Main Document for Quick Use 0 9 4 2 Preliminary 08 508 a ah ik
7. code 121 endinput 122 package Change History 1 1 v2 0 General Initial revision 1 General Renamed listbib from 1 2 biblist version 1 4 by Volker General changed email address Kuhlmann Complete revamp mentioned LaTeX 2 09 lt Oct 91 for AT RX 2e docstrip etc Re just announced 1 leased under GPL 1 3 v2 1 General mentioned that this option f General Fixed bug in citex Re is supported moved local guide f gt i moved silly listbibpreamble section to separate file 1 D 14 listbib cfg No longer adding 1 P bib to filenames in header General Last version by Addi iod af Joachim Schrod TU Darm Ing penoc a ter annoterin stadt Darmstadt Germany listbib bst aera eu Date 1992 01 13 16 35 568 sd not DE Deo nee niet Added examples repaired head Mrs ce TROIS desi PGS RIES line Called reset font where v2 2 appropriate October 91 ver General Enhancements to the list sion of LaTeX was delayed until bib shell script Example list December 91 Readers might be bib cfg Support for entry disturbed if there is the notion fields URL and totalpages of a nonexistant version 1 custom bib uses them Index Numbers written in italic refer to the page where the corresponding entry is de scribed numbers underlined refer to the code line of the definition numbers in roman refer to the code lines where the entry is used Symbols biblio
8. defNbibliographystylei 87 let AddBibliographystyle relax 88 let bibliographystyle bibliographystyle 89 bibliographystyle 90 Y 4 8 Bibliographies and Title The Nbibliography command will first issue the missing default tags will produce a heading afterwards will setup the headline and will create the bibliography itself 91 def bibliography 1 92 AddNocite 93 AddBibliographystyle 94 section refname 95 mark_for_headline 1 13 96 bibliography 1 97 refname The section heading text comes from refname which we give a new default 98 def refname BibTeX Database Listing BibTeX Provide BibTeX if it has not yet been defined This definition is taken from btxdoc tex compared with ILXTEX s definition of TeX this one has the E not touch the T and X Unfortunately the standard computer modern fonts do not supply a small caps bold so we expect a NFSS warning when BibTeX appears in the bold faced section heading That is unless we do some trickery 99 providecommand BibTex 100 textrm B kern 05em 101 tempdima f size pt fontsize 0 83333 0tempdima z selectfont 102 I kern 025em B 103 kern 08em T kern 1667em lower 7ex hbox E kern 125emxX 104 105 providecommand BibTeX one of the 2 106 textrm B kern 05em textsc i kern 025em b 107 kern 08em T kern 1667em lower 7ex hbox E kern 125emx 108 4 9 Page header The page header s
9. graphy bibliographystyle 76 96 15 nocite 76 83 bibitem 31 citex 73 CXE ssa hey 73 75 lbibitem 31 Nut PE oss 22 23 120 A annote 58 AtBeginDocument 8 B bibliography pend 3 18 78 91 bibliographystyle MORES 3 77 79 BibTeX 3 98 99 D description 25 E endannote 68 environments thebibliography LIRE DES 3 24 I Nii necis aks 75 L library 44 49 listbib cfg 7 14 listbibs amp 16 N newblock 52 16 nocite 3 76 79 R raggedbottom 3 refname 94 98 rmfamily 115 116 T thebibliography envi ronment 8 24 U Url etal Soe ee Poe 8 V vmargin 8
10. hows the database names given with the bibliography com mand and the current date We do not issue a warning if no file name is given this will be done by bibliography When a file name exists a comma and a space will be prepended at the very beginning of bib_list The comma is removed after the loop When there was no file name bib_list will expand to an empty list the relax serves as a catch argument for gobble A bib is no longer added to each bibliography filename to make the line shorter If there are too many names the header won t fit on the page This should be fixed somehow 109 def mark_for_headline 1 110 def bib_list 111 for bib_file 1 do edef bib_list bib_list bib_file 112 edef bib_list expandafter gobble bib_list relax 113 narkboth reset font ttfamily bib_list reset font ttfamily bib_list 114 115 def oddhead reset font rmfamily hfil leftmark quad today 116 def evenhead reset font rmfamily today quad ignorespaces 117 rightmark hfil 4 10 Site Configuration File listbib cfg Further document settings can be placed into a site configuration file which will 14 be loaded if found This is a good place to put some default margin settings for example 118 InputIfFileExists listbib cfg typeout 119 listbib site configuration file listbib cfg found 4 11 Finish We must restore our catcode and are finished 120 Ncatcode _ us
11. listbibs thebibliography And yes we want listbib 10 44 Package listbib 11 usepackage listbib Further document setting can be placed into a per job configuration file which will be loaded if found 2 Load per job configuration file if it exists 3 InputIfFileExists jobname cfg typeout 4 listbib per job configuration file jobname cfg found x 5 csname listbibpreamble endcsname call it if it is defined Main document part The bibliographies to typeset are taken from listbibs 6 44 Main 7 begin document 8 bibliography listbibs 9 Nend document 20 maindoc 4 2 Preliminary 21 package The main work is to supply the environment thebibliography in fact we implement it as a description environment The environment has an unused argument In addition we have to supply a correct definition for the Nbibitem command which takes the cite key as its argument Of course this will result in an item After the bibitem a library tag may follow with one parameter followed by a period Then comes the reference the optional annotation is a block of its own enclosed in annote and endannote After endannote comes a period which should be discarded This should be done in the BIBTEX style but nevertheless Before we start we declare some shorthands for category codes By declar ing the underscore _ as letter we can use it in our macros I agree with D KNUTH that Nidentifier seve
12. n File The listbib package will input a site configuration file listbib cfgifit exists This is a good place for changing margins or the document title etc The configuration file is Ninput at the end of the listbib package Here is an example hh listbib cfg VK 30 Jul 2000 Date format 99 Month 9999 newcommand monthname ifcase month or January or February or March or April or May or June or July or August or September or October or November or December fi def today number day space monthname space number year Latin 1 input 4 There is currently no way to do this from within a bib file usepackage latin1 inputenc 3 6 Inheriting Field Entries As BIBTEX currently works missing fields in all entries which crossreference an other entry are inherited from the crossreferenced entry To illustrate in this bib file incollection chapter crossref book author title book book editor booktitle note the chapter entry inherits the note field from the book entry The same is true for all other fields which can possibly be inherited BIBIEX does not make the information of whether a field was inherited available in the style file so the inheritence can not be detected directly listbib implements a workaround for this which can detect inherited fields A field is assumed to be inherited by a crossreferencing entry if its value is identical to that of the crossrefe
13. nt After the argument s of bibitem a line end occurs in any case The optional library tag will follow on the next line This means we first have to gobble the line end char M and have to check the next token afterwards If this next token is library we will do nothing since library will itself end the line Otherwise we do a line break Experiments have shown that the dotted line at the start of every entry helps with finding the different entries 31 def 1bibitem 1 bibitem 32 def bibitem 1 33 item texttt lb_sanitize 1 leavevmode 34 null dotfill 35 begingroup 36 obeylines 37 afterassignment prepare_check_library 38 let next gobble following M 39 40 def prepare_check_library 41 futurelet next check_library 42 Y 43 def check_library 44 ifx next library else break fi 45 endgroup 46 47 def 1lb_sanitize 1 escapechar 1 48 expandafter string csname 1 endcsname 4 4 Library We assume that the library info and the cite key will fit into one line If this is not true a two line solution would have to be set up We add Chighpenalty instead of M after the library part to avoid an un derfull hbox warning and an empty line if both author and editor are empty in 11 newblock annote endannote which case there is a newblock immediately following the library Alter nativelly we could implement more futurelet trickery 49 def library 1 7 50
14. o override that in any of the two con figuration files 3 8 The listbib Shell Script The listbib program can be used to quickly generate a listing of the bibliogra phies given on the command line The program is a Unix shell script sorry if you don t use Unix You may still be able to port it send me a copy if you do Here is its usage Usage listbib OPTIONS BIBFILE bib BIBFILE N bib Version VK 1 2 3 28 Aug 2000 Options h help Shows help o output FILE generates FILE dvi FILE ps default listedbibs 0 same as o but generate FILE dvi and BIBFILE N ps pl psl postscript generate PostScript as well as dvi d deltemp delete all generated files but dvi P psonly generate only PostScript delete all generated files but ps stop option processing only bib files remain A temporary tex file is created which makes use of listbib tex latex bibtex and possibly dvips are run on the tex file to create the listing of all bib files specified The bib extension can be left out Remember to specify any bib first which define any strings needed later By default the name of the tex file is listedbibs tex this can be changed with the o option Don t specify an extension here To generate PostScript as well use the p option This currently only supports dvips I can change that if there is demand The d option will delete all tem porary files when listbib is finished and only leave the dvi file
15. po sta zapf title Herrman Zapf and his Design Philosophy publisher Society of Typographic Arts address Chicago year 1987 isbn 0 941447 00 6 note library Lib MQ B77 annote A valuable book A chapter on his work around MF is included Was among the most beautiful books of the year Furthermore assume that the bibliography style listbib is available Then the IXTEX file documentclass article usepackage listbib begin document bibliography typography end document may be used to create a listing with all entries You have to run IATEX BIBTEX and IATEX Careful readers will note that there will be a BIBTEX warning about a missing author or editor in the Zapf entry You do not need to run ATRX twice after the BIBTEX run The result looks like this References typo tschichold selected 4 ee Sa ee e A a a Jan Tschichold Ausgew hlte Aufs tze ber Fragen der Gestalt des Buches und der Ty pographie Birkh user Basel 1975 ISBN 3 7643 1946 1 A second unchanged edition appeared in 1987 A collection of his classic papers The best book on typographic principles read so far A definitive must for everyone interested in typography book design or typesetting typoiblostein musd i204 uo CAD CIT we See Bae RW SNe RT Dorothea Blostein Justification of Printed Music Communications of the ACM 34 3 88 99 March 1991 Presents problems and solu
16. ral words long is more readable than IdentifierSeveralWordsLong and in every case better than p s As this is a IATEX style option the at sign is a letter anyhow so we can use the private Plain and ATEX macros and with the underscore we can make our own macros more readable But as we have to restore this category code at the end of this macro file we store its former value in the control sequence uscode This method is better than using a group because not all macros have to be defined global this way 22 chardef uscode catcode _ 23 catcode _ 11 4 3 The Bibliography Within an entry we use a ragged right margin To break within an entry is always difficult and is made easier in this way After all the open format we use gives a 10 lbibitem bibitem library ragged impression anyhow Within an entry we dissallow page breaks and we do not treat periods as full stops 24 def thebibliography 1 25 description 26 rightskip z plus 2em 27 interlinepenalty M 28 sfcode m 29 Y 30 let endthebibliography enddescription bibitem should look for the next token If a library info exists it must go in the same line otherwise a line break must be issued But bibitem itself is not of interest it looks only for the optional argument We have to redefine bibitem If a bibliography style like alpha is used bibitem will be supplied with an optional argument We ignore this optional argume
17. renced entry This assumption fails when the field values are in fact identical Please let me know of any cases where that is a problem and I will try and fix it or make a sepaarte style which does not try to detect inherited fields A quick fix might be to add something like a at the end of the field listbibs AtBeginDocument vmargin url Currently inheritance is detected for the fields note annote ISBN ISSN library totalpages and URL Inherited fields are not printed in the listing 3 7 The listbib tex Main Document Frame The shortest way to to typeset a bibliography is to put something like this into a file tex and to run it through ATEX BIBTEX and possibly more than once IXTEX again newcommand listbibs bibliographies AtBeginDocument preamblematerial input listbib For bibliographies list everything to be printed Any BIBIpX files containing string definitions must also be specified first The use of AtBeginDocument is completely optional If used preamblematerial will be inserted into the preamble of listbib tex listbib tex also loads the packages vmargin and url if it can find them vmargin sets up the page margins and url provides a Nur1 command for typesetting urls A configuration file file cfg will be loaded within the preamble of listbib tex if it exists This short document selects a document font size of 10pt and double sided printing Unfortunately it is not possible t
18. s why it probably won t work too well with twocolumn or multicol A page break within an entry is not allowed and the flexibility at the page bottom is needed Unlike with normal IXTEX documents use of bibliographystyle is not re quired although it is not prohibited The default is the listbib bst bibliography style It is also not necessary to use nocite as that is the default However nocite can be used to select certain entries only to be printed A bug you may encounter is that cite tags within BIBTEX entries will not be processed Instead the cite key itself will be printed Note that this is not a bug this is a feature You have to use nocite for all entries that shall be included in the listing If you do not give any nocite tag at all a listing with all entries is created As a bonus listbib defines the control sequence BibTeX if it is not already defined The definition is copied from btxdoc tex 3 2 Additional BibTgX Entry Fields In addition to the entry fields known by the standard BIBTEX styles listbib recog nises these fields ISBN ISSN annote library URL and totalpages The use of ISBN and ISSN should be obvious The annote field can be used for annotations or comments regarding this par ticular entry The standard BIBTEX styles do not make use of this feature however other styles might With listbib it is useful to store a short summary of the con tents of this entry As for note the first word sho
19. t uses the docstrip format for literate programming The bibliography style was regenerated from btxbst doc unsrt and then enhanced to be suitable for listbib The fully com mented bst file is in the distribution extension doc This documentation has little left of the original biblist documentation thebibliography bibliography raggedbottom nocite bibliographystyle BibTeX 3 User manual 3 1 Introduction This package facilitates printing of large BIBTEX files With such large files especially if the cite keys are long the needed string space is often exceeded Often a BigT X is available which pushes the limits further out but with this package any TEX will do it Printing complete BIBTEX files as they are is useful for record keeping The nocite command and thebibliography environment from LATEX are used to do the work The thebibliography environment is modified and eliminates huge aux files and a second I2TEX run although cross references used in the bibliography entries themselves may still require a second IATEX run A minimal IATEX document must be prepared which uses the article class loads the listbib package and specifies the bibliography to be printed with the bibliography command Other packages can be loaded as well for example to set margins or language specific definitions Other classes can perhaps be used but listbib works on the assumption that raggedbottom is in effect which i
20. tions of the task to create a correct spacing while setting notes The proposed method also takes the temporal relationship of notes into account Handles two dimensional layout e g staffs and texts typo sta zapf sss ile ie eta ba REQUE ae Lib MQ B77 Herrman Zapf and his Design Philosophy Society of Typographic Arts Chicago 1987 ISBN 0 941447 00 6 A valuable book A chapter on his work around META FONT is included Was among the most beautiful books of the year To use a bibliography style other than listbib specify it in the usual way with bibliographystyle For example unsrt gives References typo tschichold selected oc ce ea ee ee ee a a es Jan Tschichold Ausgew hlte Aufs tze ber Fragen der Gestalt des Buches und der Ty pographie Birkh user Basel 1975 A second unchanged edition appeared in 1987 typo blostein fusiC eien day m S m e RI RUE AS a Dorothea Blostein Justification of printed music Communications of the ACM 34 3 88 99 March 1991 typossta zapf uwewveleaua CREDE ee DEDE NES EE Herrman Zapf and his Design Philosophy Society of Typographic Arts Chicago 1987 Of course the ISBN ISSN numbers annotations and library information is missing since unsrt does not extract them from the database Careful readers listbib cfg will notice another difference The listbib bibliography style does not lower case titles as the standard styles do 3 5 Site Configuratio
21. uld be capitalised Punctuation at the end of the field is added by the style if appropriate The library field is not meant to be printed in final documents and is supplied to store e g the library location of a book Useful for database listings only The URL field can be used to store a URL belonging to this bibliography entry It is also becoming more popular to have bibliography entries which entirely consist of a URL URLs are typeset as ur1 URL it is recommended to use package url with documents referencing bibliography entries which contain a URL As an additional safeguard the listbib BIBTEX style defines ur1 to exand to URL if it is not already defined This field is supported by custom bib The totalpages field is meant to store the total number of pages of the work This field is supported by custom bib All 13 entry types take the library annote totalpages and URL fields They take the fields ISBN and ISSN as well with these exceptions article only takes ISSN and unpublished takes neither ISBN nor ISSN 3 3 Formatting of the entries in the resulting listing Gite Key uhggevadgnu ak eet ER AE ER quus AI eed ft LS Library info Author s Editor s Title Publication info Notes Pages 123 e URL http my url file Annotation Le an open format is used Although this needs more space I think the enhanced legibility pays back Note that you will not get the Library info and the Annotation in the
Download Pdf Manuals
Related Search
listbib doc.