https://github.com/chrisjsewell/bib2glossary
A package to convert between a latex bib file and a tex file containing glossaries entries
https://github.com/chrisjsewell/bib2glossary
biblatex bibtex glossaries latex
Last synced: 3 months ago
JSON representation
A package to convert between a latex bib file and a tex file containing glossaries entries
- Host: GitHub
- URL: https://github.com/chrisjsewell/bib2glossary
- Owner: chrisjsewell
- License: gpl-3.0
- Created: 2019-01-18T15:25:33.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2019-01-19T15:21:53.000Z (over 6 years ago)
- Last Synced: 2025-03-25T05:35:03.569Z (7 months ago)
- Topics: biblatex, bibtex, glossaries, latex
- Language: Python
- Homepage:
- Size: 51.8 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# bib2glossary
[](https://travis-ci.org/chrisjsewell/bib2glossary)
This package is intended to allow for the storage and management of
[latex glossary terms](https://en.wikibooks.org/wiki/LaTeX/Glossary)
in standard reference management packages (such as Zotero),
by converting between `.bib` files
and `.tex` files containing `\newglossaryentry` or `\newacronym` definitions.
To date the only other way to achieve this is *via* [bib2gls](https://tex.stackexchange.com/questions/342544/is-there-a-program-for-managing-glossary-tags). However, it implementation is somewhat complex, and the item types it uses are not supported by Zotero.
In `bib2glossary`, the user may override the default relationships between
reference item fields and glossary term parameters,
by supplying a JSON file, e.g.:
```json
{
"abbreviation": "abbrevfield"
}
```
The defaults are taken from the `Dictionary Entry` type in [Zotero](https://www.zotero.org/support/kb/item_types_and_fields).
For `\newacronym`:
| Parameter | Field |
| ------------ | ---------- |
| misc | @type |
| longname | journal* |
| abbreviation | shorttitle |
| description | abstract |
| plural | series |
| longplural | isbn |
| firstplural | address** |
For `\newglossaryentry`:
| Parameter | Field |
| ----------- | --------- |
| misc | @type |
| name | journal* |
| description | abstract |
| plural | series |
| symbol | volume |
| text | edition |
| sort | publisher |
\* This shows as 'Dictionary Title' in Zotero
\*\* This shows as 'Place' in Zotero
[Note: The `title` field is not used, since it is usely used to generate the key.]
## Installation
>> pip install bib2glossary
## Usage
Conversion of `\newacronym`:
>> bib2acronym --help
>> bib2acronym path/to/file.bib --entry-type misc --param2field path/to/file.json
or
>> acronym2bib --help
>> acronym2bib path/to/file.tex --entry-type misc --param2field path/to/file.json
Conversion of `\newglossaryentry`:
>> bib2glossary --help
>> bib2glossary path/to/file.bib --entry-type misc --param2field path/to/file.json
or
>> glossary2bib --help
>> glossary2bib path/to/file.tex --entry-type misc --param2field path/to/file.json
## Implementation
- Parsing of `tex` files is handled by [TexSoup](https://github.com/alvinwan/TexSoup)
- Parsing of `bib` files is handled by [BibtexParser](https://bibtexparser.readthedocs.io)