latex

academic_doc_generator.project.latex

LaTeX generation for project work grading letters.

create_project_grading_letter_tex(filename, author, title, examiner, contact, gender, work_type='Praxisprojekt', place='Gummersbach', date='\\today', signature_file='signature.png', grade_mark=None)

Create a LaTeX file for a project work grading letter with TH Köln footer.

Parameters:

Name	Type	Description	Default
filename	str	Output path for the LaTeX file.	required
author	str	Author info (name and ID).	required
title	str	Title of the project work.	required
examiner	str	Name of the examiner.	required
contact	str	Contact address of the examiner.	required
gender	str	Gender indicator ("Herr" or "Frau") for formal address.	required
work_type	str	Type of work (default: "Praxisprojekt").	'Praxisprojekt'
place	str	Place of issue (default: "Gummersbach").	'Gummersbach'
date	str	Date string (default: LaTeX \today).	'\\today'
signature_file	str	Path to signature image file (default: "signature.png").	'signature.png'
grade_mark	Optional[str]	The mark obtained (default: None, results in a blank line).	None

Source code in src/academic_doc_generator/project/latex.py

def create_project_grading_letter_tex(
    filename: str,
    author: str,
    title: str,
    examiner: str,
    contact: str,
    gender: str,
    work_type: str = "Praxisprojekt",
    place: str = "Gummersbach",
    date: str = r"\today",
    signature_file: str = "signature.png",
    grade_mark: Optional[str] = None,
) -> None:
    """Create a LaTeX file for a project work grading letter with TH Köln footer.

    Args:
        filename: Output path for the LaTeX file.
        author: Author info (name and ID).
        title: Title of the project work.
        examiner: Name of the examiner.
        contact: Contact address of the examiner.
        gender: Gender indicator ("Herr" or "Frau") for formal address.
        work_type: Type of work (default: "Praxisprojekt").
        place: Place of issue (default: "Gummersbach").
        date: Date string (default: LaTeX \\today).
        signature_file: Path to signature image file (default: "signature.png").
        grade_mark: The mark obtained (default: None, results in a blank line).
    """
    semester = get_semester()

    # Escape all text inputs for LaTeX
    author_safe = escape_for_latex(author, preserve_latex=False)
    title_safe = escape_for_latex(title, preserve_latex=False)
    work_type_safe = escape_for_latex(work_type, preserve_latex=False)

    sein_ihr = "sein" if gender == "Herr" else "ihr"
    er_sie = "Er" if gender == "Herr" else "Sie"

    # Handle mark
    mark_tex = grade_mark if grade_mark is not None else r"\underline{\hspace{2cm}}"

    # Handle signature
    signature_path_safe = signature_file.replace("\\", "/")
    signature_tex = f"\\includegraphics[width=4cm]{{{signature_path_safe}}}"
    if not os.path.exists(signature_file):
        signature_tex = f"""\\iffalse
% Uncomment the following line and provide the path to your signature image
% {signature_tex}
\\fi"""

    rendered_output = f"""\\documentclass[11pt,ngerman,parskip=full]{{scrlttr2}}
\\usepackage{{fontspec}}
\\setmainfont{{Latin Modern Roman}}
\\usepackage[ngerman]{{babel}}
\\usepackage{{geometry}}
\\geometry{{a4paper, top=25mm, left=25mm, right=25mm, bottom=30mm}}
\\usepackage{{graphicx}}

% Sender info
\\setkomavar{{fromname}}{{{examiner}}}
\\setkomavar{{fromaddress}}{{Steinmüllerallee 1\\\\51643 Gummersbach}}
\\setkomavar{{fromphone}}{{+49 2261-8196-6204}}
\\setkomavar{{fromemail}}{{{contact}}}
\\setkomavar{{place}}{{{place}}}
\\setkomavar{{date}}{{{date}}}
\\setkomavar{{subject}}{{{work_type_safe} {gender} {author_safe}}}

% Footer
\\setkomavar{{firstfoot}}{{%
  \\parbox[t]{{\\textwidth}}{{\\footnotesize
    Technische Hochschule Köln, Campus Gummersbach \\\\
    Sitz des Präsidiums: Claudiusstrasse 1, 50678 Köln \\\\
    www.th-koeln.de \\\\
    Steuer-Nr.: 214/5817/3402 - USt-IdNr.: DE 122653679 \\\\
    Bankverbindung: Sparkasse KölnBonn \\\\
    IBAN: DE34 3705 0198 1900 7098 56 - BIC: COLSDE33
  }}
}}

\\begin{{document}}

\\begin{{letter}}{{Prüfungsausschuss der TH Köln}}

\\opening{{Sehr geehrte Mitarbeiter*innen des Prüfungsservice,}}

{gender}

{author_safe},

hat im {semester} {sein_ihr} {work_type_safe} bei mir gemacht. {er_sie} hat die Note {mark_tex} erhalten.

Das Thema war:

{title_safe}

\\closing{{Danke und viele Grü{{\\ss}}e,}}

{signature_tex}

\\end{{letter}}

\\end{{document}}
"""

    with open(filename, "w", encoding="utf-8") as f:
        f.write(rendered_output)
    print(f"LaTeX file for project grading created: {filename}")