Skip to content

martisak/3gpp-citations

Repository files navigation

3GPP Bibtex entry generator

Build Status Coverage Status Gitter chat HitCount

This project aims to generate BiBTeX files that can be used when citing 3GPP specifications. The input is a document list exported from the 3GPP Portal.

Installation

pip install 3gpp-citations

To also install test dependencies run

pip install 3gpp-citations[test]

Instructions

  1. Go to the 3GPP Portal
  2. Generate the list of specifications you want.
  3. Download to Excel and save file
  4. Run python 3gpp-citations.py -i exported.xlsx -o 3gpp.bib
  5. Use in LaTeX.

Optionally use the provided 3gpp.bib directly.

Things to note

  • The output bibtex class is set to @techreport.
  • If you add the option --xelatex, break-symbols \- will be used in url-fields.
  • The version and date are read from 3gpp.org, but it is slow so it takes a while to parse the list. If you find an easy solution to this, let me know.

Example output

@techreport{3gpp.36.331,
 author = {3GPP},
 day = {20},
 institution = {{3rd Generation Partnership Project (3GPP)}},
 month = {04},
 note = {Version 14.2.2},
 number = {36.331},
 title = {{Evolved Universal Terrestrial Radio Access (E-UTRA); Radio Resource Control (RRC); Protocol specification}},
 type = {Technical Specification (TS)},
 url = {https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=2440},
 year = {2017}
}

Contribute

See our contribution guidelines and our Code of Conduct.

Other

A presentation about the CI-pipeline used in this project can be found here.

Acknowledgment

This project has been updated as part of the WASP Software and Cloud Technology course.

This work was partially supported by the Wallenberg AI, Autonomous Systems and Software Program (WASP) funded by the Knut and Alice Wallenberg Foundation.