Skip to content

dylangaeta/JHU-thesis-LaTeX

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

41 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

(unofficial) Johns Hopkins University PhD Dissertation/MS Thesis Template for LaTeX/Overleaf

Author: Dylan C. Gaeta (2026)

Overview

An easily customizable LaTeX template for PhD dissertations and M.S. theses (or GBO/DQE/thesis proposals) that meets Johns Hopkins University Sheridan Libraries formatting requirements. This template provides a structured, modular approach to dissertation writing in LaTeX/Overleaf with compliance to JHU formatting standards as of the Spring 2026 term.

Getting Started

Option 1: Use with Overleaf 🌱 (RECOMMENDED)

Overleaf requires a ZIP file upload. Here's the easiest way:

  1. Download ZIP from GitHub:

    • Click the green "Code" button above
    • Select "Download ZIP"
    • Save JHU-thesis-LaTeX-main.zip to your computer
  2. Upload to Overleaf:

    • Go to Overleaf.com
    • Click "New Project" β†’ "Upload Project"
    • Select the downloaded JHU-thesis-LaTeX-main.zip file
    • Overleaf will automatically extract and set up your project
  3. Start editing:

    • The main document is main.tex
    • Edit files in the Overleaf editor
    • Compile by clicking the "Recompile" button

Note: Overleaf automatically handles LaTeX compilation, so you don't need to run manual commands.

Option 2: Download for Local Use πŸ’»

  1. Download the template:

    • Click the green "Code" button β†’ "Download ZIP"
    • Extract to your desired location
  2. Edit core files:

    • output.xmpdata: Your title, name, subject, and keywords for PDF/A metadata
    • frontmatter/cover.tex: Title, author, degree, and date
    • frontmatter/abstract.tex: Your abstract
    • frontmatter/readers.tex: Your readers/committee
    • frontmatter/acknowledgments.tex: Your acknowledgments
    • frontmatter/quote.tex: Optional epigraph/quotation page
  3. Add your content:

    • introduction/introduction.tex: Introduction chapter
    • chapter*/chapter*.tex: Main chapters (currently 3 provided)
    • conclusion/conclusion.tex: Conclusions chapter
    • appendix/appendix*/appendix*.tex: Appendices (currently 3 provided)
    • backmatter/dissertation.bib: Bibliography entries
  4. Compile:

    pdflatex main.tex
    bibtex main
    pdflatex main.tex
    pdflatex main.tex

Compilation Notes

  • Use pdflatex for best PDF/A compatibility
  • Run bibtex between LaTeX runs for bibliography updates
  • Three LaTeX runs typically needed for cross-references and TOC
  • Ensure all .tex files are UTF-8 encoded

Note: These commands are for compiling LaTeX on your local device. You do NOT need to worry about this if you use Overleaf.

Template Structure

JHU-thesis-LaTeX/
β”œβ”€β”€ main.tex                        # Document body and chapter ordering
β”œβ”€β”€ preamble.sty                    # All packages, PDF/A compliance, and formatting
β”œβ”€β”€ output.xmpdata                  # ⚠️ PDF/A metadata β€” UPDATE WITH YOUR INFO
β”œβ”€β”€ .gitignore                      # Excludes build artifacts from version control
β”œβ”€β”€ sRGB_IEC61966-2-1_black_scaled.icc  # ICC color profile for PDF/A-1b
β”œβ”€β”€ latexmkrc.txt                   # latexmk configuration (optional)
β”œβ”€β”€ figures/                        # Introduction figures
β”‚   └── badwater-basin.JPG
β”œβ”€β”€ frontmatter/
β”‚   β”œβ”€β”€ cover.tex                   # Title page
β”‚   β”œβ”€β”€ abstract.tex                # Abstract (≀350 words)
β”‚   β”œβ”€β”€ readers.tex                 # Thesis/reading committee (optional)
β”‚   β”œβ”€β”€ acknowledgments.tex         # Acknowledgments page (optional)
β”‚   β”œβ”€β”€ quote.tex                   # Epigraph/quotation page (optional)
β”‚   └── toc.tex                     # Table of contents generation
β”œβ”€β”€ introduction/
β”‚   └── introduction.tex            # Introduction chapter
β”œβ”€β”€ chapter1/
β”‚   β”œβ”€β”€ chapter1.tex                # Chapter 1 content
β”‚   └── figures/                    # Chapter 1 figures
β”œβ”€β”€ chapter2/
β”‚   β”œβ”€β”€ chapter2.tex                # Chapter 2 content
β”‚   └── figures/                    # Chapter 2 figures
β”œβ”€β”€ chapter3/
β”‚   β”œβ”€β”€ chapter3.tex                # Chapter 3 content
β”‚   └── figures/                    # Chapter 3 figures
β”œβ”€β”€ conclusion/
β”‚   └── conclusion.tex              # Conclusions chapter
β”œβ”€β”€ appendix/
β”‚   β”œβ”€β”€ appendixA/
β”‚   β”‚   β”œβ”€β”€ appendixA.tex           # Appendix A content
β”‚   β”‚   └── figures/                # Appendix A figures
β”‚   β”œβ”€β”€ appendixB/
β”‚   β”‚   β”œβ”€β”€ appendixB.tex           # Appendix B content
β”‚   β”‚   └── figures/                # Appendix B figures
β”‚   └── appendixC/
β”‚       β”œβ”€β”€ appendixC.tex           # Appendix C content
β”‚       └── figures/                # Appendix C figures
└── backmatter/
    β”œβ”€β”€ references.tex              # References chapter
    └── dissertation.bib            # Bibliography database

Key Features

JHU Compliance

  • Frontmatter Order: Title page β†’ Abstract β†’ Readers β†’ Acknowledgments (Preface) β†’ Table of Contents β†’ Lists of Figures/Tables
  • Page Numbering: Roman numerals for frontmatter, Arabic for main text, centered at bottom
  • Margins: 1 inch on all sides (option for 1.5 inch left margins for physical print copy submission)
  • Font: Compatible with both serif and sans serif fonts
  • Spacing: Double-spaced main text and abstract
  • References Structure: Unified chapter containing appendices and bibliography

Technical Features

  • PDF/A-1b Format: Full compliance for dissertation submission with embedded ICC color profile
  • Modular Design: Each chapter in separate directory with its own figures/ folder for easy management
  • Bibliography Management: natbib package with flexible citation styles
  • Figure/Table Support: Pre-configured formatting with automatic numbering (Figure X.Y / Table X.Y)
  • Mathematical Notation: Full LaTeX math support with appropriate spacing
  • Graphics Path Resolution: Automatic figure lookup across all chapter directories via \graphicspath

Johns Hopkins University Formatting Requirements (August 2025)

Based on official requirements from https://www.library.jhu.edu/library-services/electronic-theses-dissertations/formatting-requirements/:

Title Page Requirements

  • βœ… Content centered within margins
  • βœ… Page number hidden
  • βœ… Title in ALL CAPITAL LETTERS
  • βœ… Required statement: "A dissertation submitted to Johns Hopkins University in conformity with the requirements for the degree of [doctoral degree]"
  • βœ… Location: "Baltimore, Maryland"
  • βœ… Date in "Month Year" format
  • βœ… Optional copyright notice at bottom

General Layout Requirements

  • βœ… Margins: 1 inch on all sides
  • βœ… Fonts: Sans serif recommended (Arial, Calibri, Helvetica) - template supports both serif and sans serif
  • βœ… Font Size: 10pt minimum (template uses 12pt)
  • βœ… Spacing: Double-spaced main text and abstract
  • βœ… Page Numbers: Centered at bottom of page
  • βœ… Format: Must be submitted as PDF/A

Page Numbering Requirements

  • βœ… Title page: Hidden page number
  • βœ… Front matter: Roman numerals (ii, iii, iv, etc.)
  • βœ… Main content: Arabic numerals (1, 2, 3, etc.)
  • βœ… Position: Centered at bottom of page

Required Front Matter Order

  1. βœ… Title Page
  2. βœ… Abstract (350 words maximum)
  3. βœ… Preface (includes Acknowledgments)
  4. βœ… Table of Contents
  5. βœ… List of Tables (if applicable)
  6. βœ… List of Figures (if applicable)

Content Requirements

  • βœ… Abstract: Maximum 350 words, double-spaced
  • βœ… Bibliography: Properly formatted academic citations
  • βœ… PDF/A-1b Format: Ensures long-term digital preservation
  • βœ… Accessibility: Proper document structure for screen readers

Customization

Changing Fonts

To use sans serif fonts (JHU recommended), modify preamble.sty:

\usepackage{helvet}
\renewcommand{\familydefault}{\sfdefault}

Adding Chapters

  1. Create new directory: chapter4/
  2. Create chapter4/figures/ for chapter-specific images
  3. Add chapter4/chapter4.tex with content
  4. Add the graphics path in preamble.sty: {chapter4/figures/}%
  5. Include in main.tex: \input{chapter4/chapter4}

Adding Figures

Place figures in the appropriate figures/ directory:

  • Introduction figures β†’ figures/
  • Chapter figures β†’ chapter*/figures/
  • Appendix figures β†’ appendix/appendix*/figures/

Use descriptive, hyphenated filenames (e.g., badwater-basin.JPG, alabama-hills.JPG).

⚠️ PDF/A-1b Image Compliance: All figures must use the sRGB color profile to match this template's output intent. Images from iPhones, newer Macs, and many digital cameras often use Display P3 or Adobe RGB, which can cause PDF/A validation failures or color shifts. Before adding your figures, ensure they meet these requirements:

  • Color space: sRGB IEC61966-2.1 (not Display P3, Adobe RGB, or ProPhoto RGB)
  • Embedded ICC profile: sRGB profile must be embedded in the image file
  • Format: JPG or PNG (JPG recommended for photographs)

To convert images without altering scientific print quality, you can use Claude (ask it to batch-convert your figures from Display P3 to sRGB using Python/Pillow with perceptual rendering intent), or use ImageMagick from the command line:

magick input.jpg -profile sRGB.icc -quality 95 output.jpg

The sample figures included in this template have already been converted to sRGB at 300 DPI print resolution.

Modifying Bibliography Style

Edit the bibliography section in preamble.sty to change citation styles, or modify backmatter/references.tex to add multiple bibliographies.

PDF/A Metadata (REQUIRED)

Before compiling your final submission, you must update output.xmpdata with your personal information. This file controls the XMP metadata embedded in the PDF/A-1b output. Replace the placeholder values:

\Title{Your Actual Dissertation Title}
\Author{Your Full Name}
\Subject{Your Degree/Subject Topic}
\Keywords{keyword1 \sep keyword2 \sep keyword3}
\Copyright{Copyright \copyright\ 2026 by Your Full Name}

The \Publisher and \Org fields are pre-set to Johns Hopkins University and should not need changes. If this file is not updated, your PDF metadata will contain placeholder text, which may cause issues during the Sheridan Libraries submission review.

Support

For JHU-specific formatting questions, consult:

For LaTeX technical issues, refer to comprehensive LaTeX documentation or TeX Stack Exchange.


This template was created in March 2026 and reflects current JHU dissertation requirements. Always verify with the latest official guidelines before submission.

About

🐦 LaTeX/Overleaf template for a Johns Hopkins University Ph.D. dissertation/M.S. thesis that satisfies JHU Sheridan Libraries ETD formatting requirements (as of Spring 2026).

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors