Metadata-Version: 2.4
Name: gb7714
Version: 0.1.1
Summary: GB/T 7714-2025 参考文献格式转换工具
Project-URL: Homepage, https://github.com/trueWangSyutung/pypi-gb7714
Project-URL: Repository, https://github.com/trueWangSyutung/pypi-gb7714
Project-URL: Issues, https://github.com/trueWangSyutung/pypi-gb7714/issues
Author: trueWangSyutung
License: MIT
License-File: LICENSE
Keywords: 7714,bibtex,citation,doi,gb/t,reference
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Education
Classifier: Topic :: Text Processing :: Markup :: LaTeX
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# GB/T 7714-2025 参考文献格式转换工具

[![PyPI version](https://badge.fury.io/py/gb7714.svg)](https://badge.fury.io/py/gb7714)
[![Python versions](https://img.shields.io/pypi/pyversions/gb7714.svg)](https://pypi.org/project/gb7714/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

一个符合中国国家标准 GB/T 7714-2025 的参考文献格式转换工具，支持 BibTeX 解析、DOI 查询、自动生成标准格式。

## 功能特性

- ✅ 完整支持 GB/T 7714-2025 标准
- ✅ 解析 BibTeX 格式文件
- ✅ 通过 DOI 自动获取文献信息（使用 CrossRef API）
- ✅ 支持多种文献类型：期刊、图书、会议、学位论文、报告、标准、专利、网页、数据集、预印本等
- ✅ 自动格式化作者姓名（支持中英文）
- ✅ 导出格式化后的参考文献列表

## 安装

```bash
pip install gb7714
```

## 快速开始

### 1. 解析 BibTeX 文件

```python
from gb7714 import GB7714Converter

converter = GB7714Converter()

# 从文件加载
references = converter.load_bibtex_file("references.bib")

# 格式化输出
for line in converter.format_all():
    print(line)
```

### 2. 解析 BibTeX 字符串

```python
from gb7714 import GB7714Converter

converter = GB7714Converter()

bibtex_text = """
@article{zhang2023ai,
    title = {人工智能在医疗诊断中的应用研究},
    author = {张三 and 李四 and 王五},
    journal = {中华医学杂志},
    year = {2023},
    volume = {103},
    number = {15},
    pages = {1234--1240},
    doi = {10.3760/cma.j.cn112137-20230101-00001}
}
"""

references = converter.load_bibtex_string(bibtex_text)
for line in converter.format_all():
    print(line)
```

### 3. 通过 DOI 查询

```python
from gb7714 import GB7714Converter

converter = GB7714Converter()

# 单个 DOI
ref = converter.add_doi("10.1038/nature12373")

# 多个 DOI
refs = converter.add_dois([
    "10.1038/nature12373",
    "10.1126/science.1234567"
])

for line in converter.format_all():
    print(line)
```

### 4. 导出文件

```python
from gb7714 import GB7714Converter

converter = GB7714Converter()
converter.load_bibtex_file("references.bib")
converter.export("output.txt")
```

## 命令行使用

```bash
# 解析 BibTeX 文件并输出
gb7714 references.bib

# 解析并导出到文件
gb7714 references.bib -o output.txt

# 通过 DOI 查询
gb7714 --doi 10.1007/978-3-032-27358-1_3
```

## 支持的文献类型

| BibTeX 类型 | GB/T 7714 类型 | 说明 |
|------------|---------------|------|
| article | J | 期刊文章 |
| book | M | 图书 |
| inproceedings | C | 会议论文 |
| phdthesis / mastersthesis | D | 学位论文 |
| techreport | R | 技术报告 |
| standard | S | 标准 |
| patent | P | 专利 |
| online | EB | 网页 |
| dataset | DS | 数据集 |
| preprint | PP | 预印本 |

## 依赖

- Python >= 3.8
- 无外部依赖（仅使用标准库）

## 开发

```bash
# 克隆仓库
git clone https://github.com/wxd2zrx/gb7714.git
cd gb7714

# 安装开发依赖
pip install -e .

# 运行测试
python -m pytest
```

## 许可证

MIT License - 详见 [LICENSE](LICENSE) 文件

## 贡献

欢迎提交 Issue 和 Pull Request！

## 相关标准

- GB/T 7714-2025 信息与文献 参考文献著录规则
