README.bibtex

   1 BibTeX_ is a bibliographic database format and processing tool often
   2 used with LaTeX.
   3
   4 .. _BibTeX: http://www.bibtex.org/
   5
   6 sawsim.bib
   7 ==========
   8
   9 I maintain the bibliography format with pybtex_.  The actual command
  10 used to re-format the files is
  11
  12     $ python -c 'from pybtex.database.input.bibtex import Parser; from pybtex.database.output.clean_bibtex import Writer; p = Parser(); d = p.parse_file("src/sawsim.bib"); w = Writer(); w.write_file(d, "src/sawsim.bib", p.get_raw_macros())' 2> pybtex.log
  13
  14 Be sure to look over `pybtex.log` and `git diff src/sawsim.bib` for
  15 anything suspicious before committing the new file.  You may have to
  16 do some find-and-replacing to handle changed keys and consolidate or
  17 rename automatically generated macros.
  18
  19 .. _pybtex: http://pybtex.sourceforge.net/
  20
  21 %   which I can kindof achieve with
  22 %    $ bibtool -f '%-1n(author)%2d(year)' wtk.bib -o wtk1.bib
  23 %   Except any paper with more than one author has a '.ea' appended to the name
  24 %   and bibtool removes all comments :(.
  25
  26
  27 Basic usage
  28 ===========
  29
  30 At some point in your LaTeX document
  31
  32     \bibliographystyle{prsty} % Phys. Rev. style
  33
  34 other syles include `abbrv`, `alpha`, `plain`, `unsrt`, ...
  35 In your LaTeX document where you want the bibliography:
  36
  37     \bibliography{wtk} % wtk.bib is the name of the database
  38
  39 compile (using `latex` for example) with
  40
  41     $ latex example
  42     $ bibtex example
  43     $ latex example
  44     $ latex example
  45
  46 Natbib
  47 ======
  48
  49 The Natbib package adds support for other citation styles & link
  50 formats.
  51
  52 Makebst
  53 =======
  54
  55 Customize bibliography with Makebst (`latex makebst`), makes `.bst`
  56 (bib-style) format files according to your specifications.
  57
  58 References
  59 ==========
  60
  61 There are a number of good resources to get you going:
  62
  63 * very basic tutorial:
  64   http://cmtw.harvard.edu/Documentation/TeX/Bibtex/Example.html
  65 * process overview:
  66   http://www.andy-roberts.net/misc/latex/latextutorial3.html
  67 * entry types reference
  68   http://newton.ex.ac.uk/tex/pack/bibtex/btxdoc/node6.html
  69 * fields reference
  70   http://newton.ex.ac.uk/tex/pack/bibtex/btxdoc/node7.html
  71 * entry and fields reference, but with little discussion
  72   http://en.wikipedia.org/wiki/BibTeX
  73 * examples of assorted styles
  74   http://www.cs.stir.ac.uk/~kjt/software/latex/showbst.html
  75 * assorted tools
  76   http://liinwww.ira.uka.de/bibliography/Bib.Format.html
  77 * Nelson Beebe's list of bibliographies
  78   http://www.math.utah.edu/~beebe/bibliographies.html
  79 * Nelson Beebe's GNU bibliography
  80   http://www.math.utah.edu/pub/tex/bib/gnu.html