my articles
  • TeX 83.3%
  • Makefile 14.9%
  • Lua 1.8%
Find a file
2026-04-24 12:14:14 +03:00
.github/workflows Add permissions for contents in GitHub Actions workflow 2026-04-18 19:23:53 +03:00
.obsidian Update article metadata and bibliography entries for accuracy and completeness 2026-04-24 12:14:14 +03:00
.pandoc init 2026-04-18 18:34:13 +03:00
config init 2026-04-18 18:34:13 +03:00
out Update article metadata and bibliography entries for accuracy and completeness 2026-04-24 12:14:14 +03:00
src Update article metadata and bibliography entries for accuracy and completeness 2026-04-24 12:14:14 +03:00
templates init 2026-04-18 18:34:13 +03:00
.DS_Store Update article metadata and bibliography entries for accuracy and completeness 2026-04-24 12:14:14 +03:00
actions.log Refactor code structure for improved readability and maintainability 2026-04-18 19:20:03 +03:00
Makefile init 2026-04-18 18:34:13 +03:00
README.md Refactor code structure for improved readability and maintainability 2026-04-18 19:20:03 +03:00

First Battle of İnönü Project

An academic article project about the First Battle of İnönü during the Turkish War of Independence, built with Pandoc.

Requirements

  • Pandoc — Document converter
  • XeLaTeX — PDF engine
  • citeproc — Citation processing (bundled with Pandoc)

Installation (macOS)

brew install pandoc
brew install --cask mactex-no-gui

Installation (Linux / Ubuntu on GitHub Actions)

The PDF build requires "Times New Roman" font. On Ubuntu-based systems (including GitHub Actions runners), install the minimal LaTeX packages and Microsoft TrueType fonts:

sudo apt-get update
sudo apt-get install -y pandoc texlive-xetex texlive-latex-recommended texlive-fonts-recommended ttf-mscorefonts-installer
sudo fc-cache -f -v

Usage

make        # Build both DOCX and PDF
make docx   # Build Word document
make pdf    # Build PDF
make clean  # Remove generated files

Project Structure

├── config/        # CSL style files
├── templates/     # Document templates
├── src/           # Source files
│   ├── filters/   # Lua filters
│   └── images/    # Images
└── out/           # Generated output files

Notes

This project was created as part of a high school history assignment.

I put this project together because I don’t trust companies like Google or Microsoft, and I also think the DOCX format is unsuitable for academic papers.

I’m not stupid; I just wanted to avoid a few extra mouse clicks. (Like selecting styles in Word.)

Anyway, I’d like to thank my history lecturer for setting this project. (My history grades are poor.)