https://github.com/martisak/3gpp-citations

Generate .bib-file for 3GPP specifications
https://github.com/martisak/3gpp-citations

3gpp bibtex citations python references

Last synced: 25 days ago
JSON representation

Generate .bib-file for 3GPP specifications

• Host: GitHub
• URL: https://github.com/martisak/3gpp-citations
• Owner: martisak
• License: mit
• Created: 2017-06-11T17:01:30.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2023-11-01T17:51:01.000Z (about 1 year ago)
• Last Synced: 2024-10-31T13:52:38.142Z (about 1 month ago)
• Topics: 3gpp, bibtex, citations, python, references
• Language: Python
• Size: 91.8 KB
• Stars: 63
• Watchers: 3
• Forks: 12
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

• awesome-5g - 3GPP Bibtex entry generator - Generate .bib-file for 3GPP specifications. (Tools / Diameter)

README

        
# 3GPP Bibtex entry generator

[![Build Status](https://travis-ci.org/martisak/3gpp-citations.svg?branch=master)](https://travis-ci.org/martisak/3gpp-citations) ![](https://img.shields.io/github/issues-raw/martisak/3gpp-citations.svg?style=flat) ![](https://img.shields.io/github/license/martisak/3gpp-citations.svg?style=flat) [![Coverage Status](https://coveralls.io/repos/github/martisak/3gpp-citations/badge.svg?branch=master)](https://coveralls.io/github/martisak/3gpp-citations?branch=master) [![Gitter chat](https://badges.gitter.im/martisak/3gpp-citations.png)](https://gitter.im/3gpp-citations/community "Gitter chat") [![](https://img.shields.io/pypi/v/3gpp-citations.svg?style=flat)](https://pypi.org/project/3gpp-citations/) ![](https://img.shields.io/pypi/dd/3gpp-citations.svg?style=flat) ![](https://img.shields.io/pypi/pyversions/3gpp-citations.svg?style=flat) [![HitCount](http://hits.dwyl.io/martisak/3gpp-citations.svg)](http://hits.dwyl.io/martisak/3gpp-citations) ![](https://img.shields.io/codeclimate/maintainability/martisak/3gpp-citations.svg?style=flat)

This project aims to generate [BiBTeX](http://www.bibtex.org/) files that

can be used when citing [3GPP](3gpp.org) specifications. The input is a

document list exported from the [3GPP Portal](https://portal.3gpp.org/).

## Installation

`pip install 3gpp-citations`

To also install test dependencies run

`pip install 3gpp-citations[test]`

## Instructions

1. Go to the [3GPP Portal](https://portal.3gpp.org/#55936-specifications)

1. Generate the list of specifications you want.

1. Download to Excel and save file

1. Run `python 3gpp-citations.py -i exported.xlsx -o 3gpp.bib`

1. 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](CONTRIBUTING.md) and our [Code of Conduct](CODE_OF_CONDUCT.md).

## Other

A presentation about the CI-pipeline used in this project [can be found here](https://martisak.gitlab.io/wasp_sw_course_testing/).

## Acknowledgment

This project has been updated as part of the [WASP](http://wasp-sweden.org)

[Software and Cloud Technology](http://wasp-sweden.org/graduate-school/courses/software-and-cloud-technology-spring-2019/) course.

This work was partially supported by the Wallenberg AI, Autonomous Systems and

Software Program (WASP) funded by the Knut and Alice Wallenberg Foundation.