学术引文参考文献生成器 - 支持APA/MLA/Chicago/IEEE/Harvard格式

citation-bibliography-generator by dkyazzentwatwa/chatgpt-skills

143 周安装量

43 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/dkyazzentwatwa/chatgpt-skills --skill citation-bibliography-generator

内容创作 Python Web框架科研工具

🇨🇳中文介绍

引文与参考文献生成器

生成多种学术和专业格式的正确引文与参考文献。支持手动输入、结构化数据导入以及通过 DOI/ISBN 自动查找元数据。

快速开始

from scripts.citation_generator import CitationGenerator

# 使用所需格式创建生成器
gen = CitationGenerator(style='apa')

# 引用一本书
citation = gen.cite_book(
    authors=["Smith, John", "Doe, Jane"],
    title="Research Methods in Social Science",
    year=2020,
    publisher="Academic Press",
    city="New York"
)
print(citation)
# 输出: Smith, J., & Doe, J. (2020). Research methods in social science. Academic Press.

# 构建参考文献列表
gen.add_to_bibliography(citation)
bibliography = gen.generate_bibliography()
print(bibliography)

支持的引文格式

APA (美国心理学会格式) - 第 7 版
MLA (现代语言协会格式) - 第 9 版
Chicago (芝加哥格式手册) - 第 17 版
IEEE (电气与电子工程师学会格式)
Harvard (哈佛引用格式)

功能特性

1. 手动创建引文

按来源类型格式化引文：

书籍 - 专著、编辑卷、版本
期刊文章 - 带有 DOI 的同行评议文章
网站 - 带有访问日期的在线来源

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

2. 自动元数据查找

DOI 查找 - 从 CrossRef API 获取文章元数据
ISBN 查找 - 检索书籍信息（如果可用）
自动检测来源类型并相应格式化

3. 参考文献管理

添加多个引文
按作者、年份或标题自动排序
重复项检测和移除
导出为纯文本或 BibTeX

生成括号式或叙述式文内引用：

括号式: (Smith, 2020, p. 45)
叙述式: Smith (2020) argues that...
处理多位作者及 et al.

从包含结构化数据的 CSV 文件导入引文，并生成完整的参考文献列表。

gen = CitationGenerator(style='apa')

style (str): 引文格式 - 'apa', 'mla', 'chicago', 'ieee', 或 'harvard'

citation = gen.cite_book(
    authors=["Last, First", "Last, First"],
    title="Book Title",
    year=2020,
    publisher="Publisher Name",
    city="City",           # 可选
    edition="3rd ed.",     # 可选
    isbn="978-0-123456-78-9"  # 可选
)

返回 : 格式化后的引文字符串

citation = gen.cite_article(
    authors=["Last, First"],
    title="Article Title",
    journal="Journal Name",
    year=2020,
    volume=10,          # 可选
    issue=2,            # 可选
    pages="45-67",      # 可选
    doi="10.1234/example"  # 可选
)

返回 : 格式化后的引文字符串

citation = gen.cite_website(
    authors=["Last, First"],  # 可以为空列表
    title="Page Title",
    url="https://example.com",
    access_date="2024-01-15",
    publish_date="2023-12-01"  # 可选
)

返回 : 格式化后的引文字符串

citation = gen.cite_from_doi(doi="10.1234/example")

从 CrossRef API 查找文章元数据并生成格式化引文。

返回 : 格式化后的引文字符串

add_to_bibliography()

gen.add_to_bibliography(citation)

将引文添加到参考文献列表。

generate_bibliography()

bibliography = gen.generate_bibliography(
    sort_by='author',      # 'author', 'year', 或 'title'
    deduplicate=True       # 移除重复条目
)

返回 : 带有悬挂缩进的格式化参考文献字符串

gen.export_bibtex(output_path='references.bib')

以 BibTeX 格式导出参考文献，供 LaTeX 文档使用。

citation = gen.in_text_citation(
    authors=["Smith, J."],
    year=2020,
    page="45",          # 可选
    narrative=False     # True 表示叙述式风格
)

括号式: (Smith, 2020, p. 45)
叙述式: Smith (2020)

citations = gen.import_from_csv(csv_path='citations.csv')

从 CSV 文件导入多个引文。

type,authors,title,year,journal,publisher,doi,isbn,url,access_date
article,"Smith, J.|Doe, A.",Research Methods,2020,Journal of Science,,10.1234/example,,,
book,"Johnson, M.",Data Analysis,2019,,Academic Press,,978-0-123456-78-9,,
website,,"Web Page Title",2024,,,,,https://example.com,2024-01-15

注意 : 使用 | 管道字符分隔多位作者

返回 : 格式化引文字符串列表

python scripts/citation_generator.py book \
    --authors "Smith, J." "Doe, A." \
    --title "Research Methods" \
    --year 2020 \
    --publisher "Academic Press" \
    --city "New York" \
    --style apa

python scripts/citation_generator.py article \
    --authors "Smith, J." \
    --title "Study Title" \
    --journal "Journal Name" \
    --year 2020 \
    --volume 10 \
    --issue 2 \
    --pages "45-67" \
    --doi "10.1234/example" \
    --style mla

python scripts/citation_generator.py website \
    --title "Page Title" \
    --url "https://example.com" \
    --access-date "2024-01-15" \
    --style chicago

python scripts/citation_generator.py doi \
    --doi "10.1234/example" \
    --style apa

python scripts/citation_generator.py batch \
    --input citations.csv \
    --style harvard \
    --output bibliography.txt \
    --sort author

python scripts/citation_generator.py batch \
    --input citations.csv \
    --format bibtex \
    --output references.bib

参数	描述	默认值
`--style`, `-s`	引文格式 (apa/mla/chicago/ieee/harvard)	apa
`--authors`, `-a`	作者姓名 (允许多个)	-
`--title`, `-t`	作品标题	-
`--year`, `-y`	出版年份	-
`--input`, `-i`	输入 CSV 文件 (批量模式)	-
`--output`, `-o`	输出文件路径	stdout
`--format`, `-f`	输出格式 (text/bibtex)	text
`--sort`	参考文献排序方式 (author/year/title)	author

示例 1: APA 书籍引文

gen = CitationGenerator(style='apa')
citation = gen.cite_book(
    authors=["Doe, Jane", "Smith, John"],
    title="The Art of Research",
    year=2021,
    publisher="University Press",
    edition="2nd ed."
)
print(citation)
# Doe, J., & Smith, J. (2021). The art of research (2nd ed.). University Press.

示例 2: MLA 文章引文

gen = CitationGenerator(style='mla')
citation = gen.cite_article(
    authors=["Johnson, Mary"],
    title="Digital Humanities in the 21st Century",
    journal="Modern Research Quarterly",
    year=2022,
    volume=15,
    issue=3,
    pages="112-145",
    doi="10.5678/mrq.2022.15.3"
)
print(citation)
# Johnson, Mary. "Digital Humanities in the 21st Century." Modern Research Quarterly, vol. 15, no. 3, 2022, pp. 112-145. DOI: 10.5678/mrq.2022.15.3.

示例 3: Chicago 网站引文

gen = CitationGenerator(style='chicago')
citation = gen.cite_website(
    authors=["Brown, Robert"],
    title="Understanding Machine Learning",
    url="https://ml-guide.example.com",
    access_date="2024-01-20",
    publish_date="2023-11-15"
)
print(citation)
# Brown, Robert. "Understanding Machine Learning." Last modified November 15, 2023. Accessed January 20, 2024. https://ml-guide.example.com.

示例 4: 构建参考文献列表

gen = CitationGenerator(style='apa')

# 添加多个引文
gen.add_to_bibliography(gen.cite_book(
    authors=["Smith, A."],
    title="First Book",
    year=2020,
    publisher="Press A"
))

gen.add_to_bibliography(gen.cite_article(
    authors=["Jones, B."],
    title="Research Article",
    journal="Journal X",
    year=2021
))

# 生成格式化参考文献列表
bibliography = gen.generate_bibliography(sort_by='author')
print(bibliography)

示例 5: DOI 查找

gen = CitationGenerator(style='ieee')
citation = gen.cite_from_doi(doi="10.1109/ACCESS.2019.2947014")
print(citation)
# 自动获取元数据并以 IEEE 格式格式化

示例 6: 从 CSV 批量处理

gen = CitationGenerator(style='harvard')
citations = gen.import_from_csv('my_references.csv')

# 全部添加到参考文献列表
for citation in citations:
    gen.add_to_bibliography(citation)

# 生成并导出
gen.export_bibtex('references.bib')

pandas>=2.0.0
requests>=2.31.0

pip install -r scripts/requirements.txt

API 可用性 : DOI/ISBN 查找需要互联网连接并依赖第三方 API (CrossRef)
API 速率限制 : CrossRef API 有速率限制；批量查找需要实现延迟
格式变体 : 某些引文格式有学科特定的变体，未完全涵盖
特殊字符 : 重音符号和特殊字符的 Unicode 支持可能因输出格式而异
版本号 : 不同格式对版本的格式化方式不同（序数词 vs 文本）
作者姓名格式 : 输入应为 "Last, First" 格式；解析其他格式可能不一致
多位作者 : Et al. 规则因格式而异 (APA: 3+, MLA: 3+, Chicago: 4+)
在线优先文章 : 印刷前在线发表的文章可能只有部分元数据
非英语来源 : 某些引文格式对非英语来源有特定规则，可能未完全实现

APA (美国心理学会格式)

作者-日期系统
最后一位作者前使用 & 符号
书籍标题使用标题大小写，文章标题使用句子大小写
DOI 作为 URL: https://doi.org/10.xxxx

MLA (现代语言协会格式)

作者-页码系统
最后一位作者前使用 "And"
所有标题使用标题大小写
容器概念（期刊是文章的容器）

Chicago (芝加哥格式手册)

注释和参考文献系统
最后一位作者前使用 "And"
标题使用标题大小写
网站需要访问日期

IEEE (电气与电子工程师学会格式)

编号引用 [1], [2] 等
姓氏前使用名字首字母
文章标题使用引号
期刊名称缩写

作者-日期系统
最后一位作者前使用 "And"
书籍/期刊标题使用斜体
URL 前使用 "Available at:"

🇺🇸English

Citation & Bibliography Generator

Generate properly formatted citations and bibliographies in multiple academic and professional styles. Supports manual entry, structured data import, and automatic metadata lookup via DOI/ISBN.

Quick Start

from scripts.citation_generator import CitationGenerator

# Create generator with desired style
gen = CitationGenerator(style='apa')

# Cite a book
citation = gen.cite_book(
    authors=["Smith, John", "Doe, Jane"],
    title="Research Methods in Social Science",
    year=2020,
    publisher="Academic Press",
    city="New York"
)
print(citation)
# Output: Smith, J., & Doe, J. (2020). Research methods in social science. Academic Press.

# Build bibliography
gen.add_to_bibliography(citation)
bibliography = gen.generate_bibliography()
print(bibliography)

Supported Citation Styles

APA (American Psychological Association) - 7th Edition
MLA (Modern Language Association) - 9th Edition
Chicago (Chicago Manual of Style) - 17th Edition
IEEE (Institute of Electrical and Electronics Engineers)
Harvard (Harvard referencing style)

Features

1. Manual Citation Creation

Format citations by source type:

Books - Monographs, edited volumes, editions
Journal Articles - Peer-reviewed articles with DOI
Websites - Online sources with access dates
Conference Papers - Proceedings and presentations

2. Automatic Metadata Lookup

DOI Lookup - Fetch article metadata from CrossRef API
ISBN Lookup - Retrieve book information (when available)
Auto-detect source type and format accordingly

3. Bibliography Management

Add multiple citations
Auto-sort by author, year, or title
Duplicate detection and removal
Export to plain text or BibTeX

4. In-Text Citations

Generate parenthetical or narrative in-text citations:

Parenthetical: (Smith, 2020, p. 45)
Narrative: Smith (2020) argues that...
Multiple authors with et al. handling

5. Batch Processing

Import citations from CSV files with structured data and generate complete bibliographies.

API Reference

CitationGenerator

Initialization :

gen = CitationGenerator(style='apa')

Parameters :

style (str): Citation style - 'apa', 'mla', 'chicago', 'ieee', or 'harvard'

Citation Methods

cite_book()

citation = gen.cite_book(
    authors=["Last, First", "Last, First"],
    title="Book Title",
    year=2020,
    publisher="Publisher Name",
    city="City",           # Optional
    edition="3rd ed.",     # Optional
    isbn="978-0-123456-78-9"  # Optional
)

Returns : Formatted citation string

cite_article()

citation = gen.cite_article(
    authors=["Last, First"],
    title="Article Title",
    journal="Journal Name",
    year=2020,
    volume=10,          # Optional
    issue=2,            # Optional
    pages="45-67",      # Optional
    doi="10.1234/example"  # Optional
)

Returns : Formatted citation string

cite_website()

citation = gen.cite_website(
    authors=["Last, First"],  # Can be empty list
    title="Page Title",
    url="https://example.com",
    access_date="2024-01-15",
    publish_date="2023-12-01"  # Optional
)

Returns : Formatted citation string

cite_from_doi()

citation = gen.cite_from_doi(doi="10.1234/example")

Looks up article metadata from CrossRef API and generates formatted citation.

Returns : Formatted citation string

Bibliography Management

add_to_bibliography()

gen.add_to_bibliography(citation)

Add a citation to the bibliography list.

generate_bibliography()

bibliography = gen.generate_bibliography(
    sort_by='author',      # 'author', 'year', or 'title'
    deduplicate=True       # Remove duplicate entries
)

Returns : Formatted bibliography string with hanging indent

export_bibtex()

gen.export_bibtex(output_path='references.bib')

Export bibliography as BibTeX format for LaTeX documents.

In-Text Citations

in_text_citation()

citation = gen.in_text_citation(
    authors=["Smith, J."],
    year=2020,
    page="45",          # Optional
    narrative=False     # True for narrative style
)

Returns :

Parenthetical: (Smith, 2020, p. 45)
Narrative: Smith (2020)

Batch Processing

import_from_csv()

citations = gen.import_from_csv(csv_path='citations.csv')

Import multiple citations from CSV file.

CSV Format :

type,authors,title,year,journal,publisher,doi,isbn,url,access_date
article,"Smith, J.|Doe, A.",Research Methods,2020,Journal of Science,,10.1234/example,,,
book,"Johnson, M.",Data Analysis,2019,,Academic Press,,978-0-123456-78-9,,
website,,"Web Page Title",2024,,,,,https://example.com,2024-01-15

Note : Separate multiple authors with | pipe character

Returns : List of formatted citation strings

CLI Usage

Single Citation

Book :

python scripts/citation_generator.py book \
    --authors "Smith, J." "Doe, A." \
    --title "Research Methods" \
    --year 2020 \
    --publisher "Academic Press" \
    --city "New York" \
    --style apa

Article :

python scripts/citation_generator.py article \
    --authors "Smith, J." \
    --title "Study Title" \
    --journal "Journal Name" \
    --year 2020 \
    --volume 10 \
    --issue 2 \
    --pages "45-67" \
    --doi "10.1234/example" \
    --style mla

Website :

python scripts/citation_generator.py website \
    --title "Page Title" \
    --url "https://example.com" \
    --access-date "2024-01-15" \
    --style chicago

DOI Lookup

python scripts/citation_generator.py doi \
    --doi "10.1234/example" \
    --style apa

Batch Processing

python scripts/citation_generator.py batch \
    --input citations.csv \
    --style harvard \
    --output bibliography.txt \
    --sort author

BibTeX Export

python scripts/citation_generator.py batch \
    --input citations.csv \
    --format bibtex \
    --output references.bib

CLI Arguments

Argument	Description	Default
`--style`, `-s`	Citation style (apa/mla/chicago/ieee/harvard)	apa
`--authors`, `-a`	Author names (multiple allowed)	-
`--title`, `-t`	Title of work	-
`--year`,

Examples

Example 1: APA Book Citation

gen = CitationGenerator(style='apa')
citation = gen.cite_book(
    authors=["Doe, Jane", "Smith, John"],
    title="The Art of Research",
    year=2021,
    publisher="University Press",
    edition="2nd ed."
)
print(citation)
# Doe, J., & Smith, J. (2021). The art of research (2nd ed.). University Press.

Example 2: MLA Article Citation

gen = CitationGenerator(style='mla')
citation = gen.cite_article(
    authors=["Johnson, Mary"],
    title="Digital Humanities in the 21st Century",
    journal="Modern Research Quarterly",
    year=2022,
    volume=15,
    issue=3,
    pages="112-145",
    doi="10.5678/mrq.2022.15.3"
)
print(citation)
# Johnson, Mary. "Digital Humanities in the 21st Century." Modern Research Quarterly, vol. 15, no. 3, 2022, pp. 112-145. DOI: 10.5678/mrq.2022.15.3.

Example 3: Chicago Website Citation

gen = CitationGenerator(style='chicago')
citation = gen.cite_website(
    authors=["Brown, Robert"],
    title="Understanding Machine Learning",
    url="https://ml-guide.example.com",
    access_date="2024-01-20",
    publish_date="2023-11-15"
)
print(citation)
# Brown, Robert. "Understanding Machine Learning." Last modified November 15, 2023. Accessed January 20, 2024. https://ml-guide.example.com.

Example 4: Building a Bibliography

gen = CitationGenerator(style='apa')

# Add multiple citations
gen.add_to_bibliography(gen.cite_book(
    authors=["Smith, A."],
    title="First Book",
    year=2020,
    publisher="Press A"
))

gen.add_to_bibliography(gen.cite_article(
    authors=["Jones, B."],
    title="Research Article",
    journal="Journal X",
    year=2021
))

# Generate formatted bibliography
bibliography = gen.generate_bibliography(sort_by='author')
print(bibliography)

Example 5: DOI Lookup

gen = CitationGenerator(style='ieee')
citation = gen.cite_from_doi(doi="10.1109/ACCESS.2019.2947014")
print(citation)
# Auto-fetches metadata and formats in IEEE style

Example 6: Batch Processing from CSV

gen = CitationGenerator(style='harvard')
citations = gen.import_from_csv('my_references.csv')

# Add all to bibliography
for citation in citations:
    gen.add_to_bibliography(citation)

# Generate and export
gen.export_bibtex('references.bib')

Dependencies

pandas>=2.0.0
requests>=2.31.0

Install dependencies:

pip install -r scripts/requirements.txt

Limitations

API Availability : DOI/ISBN lookups require internet connection and depend on third-party APIs (CrossRef)
API Rate Limits : CrossRef API has rate limits; implement delays for batch lookups
Style Variations : Some citation styles have discipline-specific variations not fully covered
Special Characters : Unicode support for accents and special characters may vary by output format
Edition Numbers : Different styles format editions differently (ordinal vs text)
Author Name Formats : Input should be "Last, First" format; parsing other formats may be inconsistent
Multiple Authors : Et al. rules vary by style (APA: 3+, MLA: 3+, Chicago: 4+)
Online-First Articles : Articles published online before print may have partial metadata
Non-English Sources : Some citation styles have specific rules for non-English sources that may not be fully implemented

Citation Style Guidelines

APA (American Psychological Association)

Author-date system
Ampersand (&) before last author
Title case for book titles, sentence case for article titles
DOI as URL: https://doi.org/10.xxxx

MLA (Modern Language Association)

Author-page system
"And" before last author
Title case for all titles
Container concept (journal is container for article)

Chicago (Chicago Manual of Style)

Notes and bibliography system
"And" before last author
Title case for titles
Access dates for websites

IEEE (Institute of Electrical and Electronics Engineers)

Numbered references [1], [2], etc.
Initials before last name
Quotation marks for article titles
Abbreviated journal names

Harvard

Author-date system
"And" before last author
Italic for book/journal titles
Available at: for URLs

Weekly Installs

Repository

dkyazzentwatwa/…t-skills

GitHub Stars

First Seen

Jan 24, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

opencode55

codex53

gemini-cli53

cursor52

github-copilot48

claude-code46

MCP图像生成技能：使用Gemini AI为营销、UI设计、演示文稿创建高质量图像

7,600 周安装

学术引文参考文献生成器 - 支持APA/MLA/Chicago/IEEE/Harvard格式

🇨🇳中文介绍

引文与参考文献生成器

快速开始

支持的引文格式

功能特性

1. 手动创建引文

相关 Skills

2. 自动元数据查找

3. 参考文献管理

4. 文内引用

5. 批量处理

API 参考

CitationGenerator

引文方法

cite_book()

cite_article()

cite_website()

cite_from_doi()

参考文献管理

add_to_bibliography()

generate_bibliography()

export_bibtex()

文内引用

in_text_citation()

批量处理

import_from_csv()

CLI 使用

单条引文

DOI 查找

批量处理

BibTeX 导出

CLI 参数

示例

示例 1: APA 书籍引文

示例 2: MLA 文章引文

示例 3: Chicago 网站引文

示例 4: 构建参考文献列表

示例 5: DOI 查找

示例 6: 从 CSV 批量处理

依赖项

限制

引文格式指南

APA (美国心理学会格式)

MLA (现代语言协会格式)

Chicago (芝加哥格式手册)

IEEE (电气与电子工程师学会格式)

Harvard

🇺🇸English

Citation & Bibliography Generator

Quick Start

Supported Citation Styles

Features

1. Manual Citation Creation

2. Automatic Metadata Lookup

3. Bibliography Management

4. In-Text Citations

5. Batch Processing

API Reference

CitationGenerator

Citation Methods

cite_book()

cite_article()

cite_website()

cite_from_doi()

Bibliography Management

add_to_bibliography()

generate_bibliography()

export_bibtex()

In-Text Citations

in_text_citation()

Batch Processing

import_from_csv()

CLI Usage

Single Citation

DOI Lookup

Batch Processing

BibTeX Export

CLI Arguments

Examples