https://github.com/mattmight/bib2sx

A tool for manipulating bibtex files as s-expressions
https://github.com/mattmight/bib2sx

Last synced: 5 days ago
JSON representation

A tool for manipulating bibtex files as s-expressions

• Host: GitHub
• URL: https://github.com/mattmight/bib2sx
• Owner: mattmight
• License: other
• Created: 2015-06-16T06:52:14.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2018-10-27T22:23:55.000Z (about 6 years ago)
• Last Synced: 2024-11-18T06:47:51.481Z (2 months ago)
• Language: Racket
• Size: 49.8 KB
• Stars: 33
• Watchers: 2
• Forks: 5
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

• awesome-racket-and-scheme - bib2sx - expressions (Racket / Tools/lib)

README

        
# bib2sx

`bib2sx` is a command-line tool (written in Racket) for parsing 

BibTeX files (by default) into S-Expressions.

It captures the (potentially recursive) structure of quoting in BibTeX,

which is is important for capitalization.

It also supports outputing to JSON, XML and (back to canonicalized) BibTeX.

 

A [blog post explaining

bib2sx](http://matt.might.net/articles/parsing-bibtex/) covers the tool in

much more detail.

It will parse name fields (`author`, `editor`) into `first`, `von`, `last`

and `jr` with `--parse-names`.

## Dependencies

You will need an installation of the [Racket programming language](http://racket-lang.org/download/). 

## Building

To build `bib2sx`, run `make`. 

## Installation

To install to `~/bin/`, run `make install`.

## Usage

```

$ bib2sx [ --inline ] [ --flatten ] [ --parse-names ] [ --texenize ]

         [ --in sx|bib ] [ --out sx|bib|json|xml ]

         [ --json | --bib | --xml ]

         [  ]

```

where:

 + `--inline` will expand variables into definitions from @string

 + `--flatten` will convert values into properly-quoted BibTeX strings

 + `--parse-names` will parse names according to BibTeX's rules

 + `--texenize` will tokenize values into lexemes meaningful to TeX

 + `--in ` will set the input format: `sx` or `bib` allowed; 

   `bib` is default

 + `--out ` will set the output format; `sx`, `bib`, `json`, or `xml`

    allowed; `sx` is default

 + `--json` will output JSON; same as `--out json`

 + `--bib` will output canonicalized BibTeX; same as `--out bib`

 + `--xml` will output XML; same as `--out xml`

## TeXenizing

If you want to render the output in a format other than LaTeX (such as

HTML), you will need to interpret the TeX.

To make this easier, the `--texenize` flag will parse a value into lexemes

meaningful to LaTeX.

For instance, `\foo{bar}` will become `"\foo" '("b" "a" "r")`.

## License

bib2sx: A bibtex parser and transformer

Copyright (©) 2015 Matthew Might

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 3 of the License, or

(at your option) any later version.

This program is distributed in the hope that it will be useful,

but WITHOUT ANY WARRANTY; without even the implied warranty of

MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

GNU General Public License for more details.

You should have received a copy of the GNU General Public License

along with this program.  If not, see .