foldable-namecard

A LaTeX package for printing A4 foldable namecards with a name, optional second line, country, and logo.

Requirements

Compiler

This package requires XeLaTeX. It will produce a hard error and abort if compiled with pdflatex or lualatex. The package uses fontspec and xeCJK for advanced font handling, which are only fully supported by XeLaTeX.

Compile with:

xelatex example.tex

LaTeX Packages

The following packages are required (most are part of a standard TeX Live or MiKTeX installation):

• geometry - Page layout
• graphicx - Image handling
• keyval - Key-value options
• iftex - Conditional compilation based on engine
• tikz and pgf - Drawing and positioning
• xcolor - Color support
• fontspec - Font configuration (XeTeX)
• xeCJK - CJK character support (for Chinese, Japanese, Korean)

System Fonts

You must install the following fonts on your system:

Font	Purpose	Notes
Hind	Primary font for names and text	Download from Google Fonts
Liberation Sans or DejaVu Sans	Fallback for extended Latin characters (accents, diacritics like ǐ)	Usually pre-installed on Linux/macOS; use one if Hind lacks certain glyphs
Noto Sans CJK SC (or system CJK font)	Chinese character support	For rendering Chinese names

Installation Instructions

macOS:

# Download Hind from Google Fonts, then:
cp ~/Downloads/Hind-*.otf ~/Library/Fonts/

Linux (Ubuntu/Debian):

# Install system fonts
sudo apt-get install fonts-hind fonts-dejavu fonts-noto-cjk

# Or manually copy to ~/.fonts/ and run:
fc-cache -fv

Windows:

# Download Hind from Google Fonts
# Right-click .otf files → Install

If any font is missing, the package will attempt to use fallbacks or emit a warning.

Usage

Single card

\documentclass{article}
\usepackage{foldable-namecard}

\namecardsetup{
  name=Alex Johnson,
  country=Sweden,
  logo=mylogo.png
}

\begin{document}
\makefoldablenamecard
\end{document}

Batch printing from a CSV file

\documentclass{article}
\usepackage{foldable-namecard}

\namecardsetup{logo=mylogo.png}

\begin{document}
\makefoldablenamecardsfromfile{names.csv}
\end{document}

The CSV file may contain either two fields or three fields per line. With two fields, the package treats them as name,country. With three fields, it treats them as name,subtitle,country, printing the middle field underneath the name. Blank lines are skipped. The package supports international characters including accented Latin letters and Chinese characters.

Alex Johnson,Sweden
Mina Patel,Product Design,India
Sofia Garcia,Spain
Valgerður Ólafsdóttir,Engineering,Iceland
李明,(Lǐ Míng),China
王芳,中国 
Myrryam Haddar,مريم حدار, Egypt

Options (\namecardsetup)

Key	Default	Description
name	Your Name	Name printed on the card
subtitle	(none)	Optional line printed under the name
country	Country	Country printed below the name
logo	(none)	Path to logo image file
logowidth	2cm	Width of the logo
logoheight	10mm	Height constraint for the logo
debugboxes	(off)	Show bounding boxes for layout debugging
nodebugboxes	—	Hide bounding boxes