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