semvec/pypi-packages huggingface dataset:
ref2tex 0.0.2
A package that converts inline citation (i.e. (Sahraoui et al. 2023), or [1]) to latex cite command: \cite(bibkeyname)
License: MIT License
Requires Python: >=3.7
Keywords: references,biblography,latex,citation,bib

# ref2tex: Covert Inline Citations to Latex Cite Command
## Introduction
Converting inline citations in a Word document to Latex is not an easy task. Even if you have all the references in bibtex, you still need to replace each citation, which requires searching for each reference in the list of bibliography then finding that reference's bibtex entry and getting its key, then finally replacing the citation i.e. [1] to \cite{bibkey}.

This repository contains the code of ref2tex package that automatically  converts inline citations (e.g. [1] or (Sahraoui et al. 2023)) to latex cite command (e.g. \cite{refkey2023}).

Input:
1. File that contains original text with inline citations (.txt or .tex, __NOT__ in .doc or .docx)
2. Text file that contains list of references (bibliography)
3. Bibtex file that contains all bib entries of the references listed in bibliography file

Output:
The original text where inline citations are replaced with \cite commands

## Supported styles
The following styles are supported:

- APA (which uses (AuthorName Year) format)
- IEEE (which uses ([number]) format)

If your source documents is in difference style, converting it to APA or IEEE styles should be straightforward using reference management software such as Mendeley or Endnote.

## Usage
You can directly run the script corresponding to the source citation style, for example, if the source document is using APA style:
```
python ieee2tex.py -i sourceFile -r refsFile -b bibtexFile [-o OutputFile]

-i input file that contains orginal text with inline citations (e.g. [1] for IEEE or (Sahraoui et al. 2023) for APA)
-r txt file that contains a list of references (bibliography)
-b bib file that contains all bib entries of the references listed in bibliography file
-o [optional] the output tex file that will contain the converted inline citations (e.g. \cite{keyX2023}). If not specified, the output file is named output_cited.tex
```
Example:
```
python ieee2tex.py -i myFile.tex -r myRefs.txt -b mybib.bib
```

## Instalation
```
pip install ref2tex
```
```
import ref2tex.ieee2tex as ieee2tex
ieee2tex.ieee2tex('inputRefs.txt','inputFile.tex','bibFile.bib','my_out_file.tex')

```

## Ongoing improvements
- bibtex entry generation, in case it is missing in the provided bibtex library.
- Deep learning based reference identification (author,year,journal/conference ...etc.) rather than parsing
- provide a web-based service for online citation converting

## Licence
Licensed under the MIT license.