Working version
This commit is contained in:
Olaf
@@ -0,0 +1,2 @@
|
||||
example.log
|
||||
example.aux
|
||||
@@ -1,2 +1,120 @@
|
||||
# foldable-namecard
|
||||
|
||||
This repo contains a quick and easy style file for creating foldable name cards from a CVS input file.
|
||||
A LaTeX package for printing A4 foldable namecards with a name, 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](https://fonts.google.com/specimen/Hind) |
|
||||
| **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:**
|
||||
```bash
|
||||
# Download Hind from Google Fonts, then:
|
||||
cp ~/Downloads/Hind-*.otf ~/Library/Fonts/
|
||||
```
|
||||
|
||||
**Linux (Ubuntu/Debian):**
|
||||
```bash
|
||||
# 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
|
||||
|
||||
```latex
|
||||
\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
|
||||
|
||||
```latex
|
||||
\documentclass{article}
|
||||
\usepackage{foldable-namecard}
|
||||
|
||||
\namecardsetup{logo=mylogo.png}
|
||||
|
||||
\begin{document}
|
||||
\makefoldablenamecardsfromfile{names.csv}
|
||||
\end{document}
|
||||
```
|
||||
|
||||
The CSV file must contain one `name,country` pair per line. Blank lines are skipped.
|
||||
The package supports international characters including accented Latin letters and Chinese characters.
|
||||
|
||||
```
|
||||
Alex Johnson,Sweden
|
||||
Mina Patel,India
|
||||
Sofia Garcia,Spain
|
||||
Valgerður Ólafsdóttir,Iceland
|
||||
李明 (Lǐ Míng),China
|
||||
王芳,中国
|
||||
```
|
||||
|
||||
## Options (`\namecardsetup`)
|
||||
|
||||
| Key | Default | Description |
|
||||
|----------------|--------------|------------------------------------------|
|
||||
| `name` | `Your Name` | Name printed on the card |
|
||||
| `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` | *(on)* | Show bounding boxes for layout debugging |
|
||||
| `nodebugboxes` | — | Hide bounding boxes |
|
||||
|
||||
BIN
Binary file not shown.
+11
@@ -0,0 +1,11 @@
|
||||
% Compile with: xelatex example.tex
|
||||
\documentclass{article}
|
||||
\usepackage{foldable-namecard}
|
||||
|
||||
\namecardsetup{
|
||||
logo=isoclogo.png
|
||||
}
|
||||
|
||||
\begin{document}
|
||||
\makefoldablenamecardsfromfile{names.csv}
|
||||
\end{document}
|
||||
@@ -0,0 +1,185 @@
|
||||
\NeedsTeXFormat{LaTeX2e}
|
||||
\ProvidesPackage{foldable-namecard}[2026/07/01 A4 foldable namecard]
|
||||
|
||||
\RequirePackage[a4paper,margin=0mm]{geometry}
|
||||
\RequirePackage{graphicx}
|
||||
\RequirePackage{keyval}
|
||||
\RequirePackage{iftex}
|
||||
\RequirePackage{tikz}
|
||||
\usetikzlibrary{calc}
|
||||
\RequirePackage{xcolor}
|
||||
|
||||
\ifXeTeX\else
|
||||
\PackageError{foldable-namecard}{%
|
||||
This package requires XeLaTeX.\MessageBreak
|
||||
Please compile with xelatex instead of lualatex or pdflatex%
|
||||
}{%
|
||||
Compilation will abort. Re-run with: xelatex <your-file>.tex%
|
||||
}%
|
||||
\stop
|
||||
\fi
|
||||
|
||||
\tracinglostchars=0 % Suppress warnings about missing glyphs
|
||||
|
||||
\RequirePackage{fontspec}
|
||||
\IfFontExistsTF{Hind}{%
|
||||
\setmainfont{Hind}[
|
||||
BoldFont = Hind-Bold,
|
||||
UprightFont = Hind-Regular,
|
||||
SemiBoldFont = Hind-SemiBold,
|
||||
]%
|
||||
% Try multiple font options for fallback support
|
||||
\IfFontExistsTF{Liberation Sans}{%
|
||||
\newfontfamily\NC@namefont{Liberation Sans}[
|
||||
BoldFont = Liberation Sans Bold,
|
||||
]%
|
||||
}{%
|
||||
\IfFontExistsTF{DejaVu Sans}{%
|
||||
\newfontfamily\NC@namefont{DejaVu Sans}[
|
||||
BoldFont = DejaVu Sans Bold,
|
||||
]%
|
||||
}{%
|
||||
\let\NC@namefont\relax
|
||||
}%
|
||||
}%
|
||||
}{%
|
||||
\PackageWarningNoLine{foldable-namecard}{Hind font not found; using default font}%
|
||||
}
|
||||
\ifXeTeX
|
||||
\RequirePackage{xeCJK}
|
||||
\setCJKmainfont[
|
||||
BoldFont = RODE Noto Sans CJK SC B,
|
||||
]{RODE Noto Sans CJK SC R}
|
||||
\fi
|
||||
|
||||
\makeatletter
|
||||
|
||||
\newsavebox{\NC@namebox}
|
||||
|
||||
\newcommand\NC@name{Your Name}
|
||||
\newcommand\NC@country{Country}
|
||||
\newcommand\NC@logo{}
|
||||
\newlength\NC@logoheight
|
||||
\newlength\NC@logowidth
|
||||
\newif\ifNC@debugboxes
|
||||
|
||||
%\NC@debugboxestrue
|
||||
\setlength\NC@logoheight{10mm}
|
||||
\setlength\NC@logowidth{2cm}
|
||||
|
||||
\define@key{NC}{name}{\renewcommand\NC@name{#1}}
|
||||
\define@key{NC}{country}{\renewcommand\NC@country{#1}}
|
||||
\define@key{NC}{logo}{\renewcommand\NC@logo{#1}}
|
||||
\define@key{NC}{logoheight}{\setlength\NC@logoheight{#1}}
|
||||
\define@key{NC}{logowidth}{\setlength\NC@logowidth{#1}}
|
||||
\define@key{NC}{debugboxes}[true]{\NC@debugboxestrue}
|
||||
\define@key{NC}{nodebugboxes}[true]{\NC@debugboxesfalse}
|
||||
|
||||
\newcommand{\namecardsetup}[1]{%
|
||||
\setkeys{NC}{#1}%
|
||||
}
|
||||
|
||||
\newcommand{\NC@dbgbox}[1]{%
|
||||
\ifNC@debugboxes
|
||||
\fbox{#1}%
|
||||
\else
|
||||
#1%
|
||||
\fi
|
||||
}
|
||||
|
||||
\newcommand{\NC@renderlogo}{%
|
||||
\ifx\NC@logo\@empty
|
||||
% No logo configured.
|
||||
\else
|
||||
\begingroup
|
||||
\edef\NC@logofile{\NC@logo}%
|
||||
\IfFileExists{\NC@logofile}{%
|
||||
\NC@dbgbox{\includegraphics[width=\NC@logowidth,keepaspectratio]{\NC@logofile}}%
|
||||
}{%
|
||||
\fbox{\parbox[c][\NC@logoheight][c]{5cm}{\centering Logo file not found}}%
|
||||
}%
|
||||
\endgroup
|
||||
\fi
|
||||
}
|
||||
|
||||
\newcommand{\NC@panelcontent}{%
|
||||
\NC@dbgbox{%
|
||||
\begin{minipage}[c][0.92\paperwidth][c]{0.98\paperheight}
|
||||
\centering
|
||||
|
||||
% Measure height of name resized to 25cm width
|
||||
\savebox{\NC@namebox}{%
|
||||
\resizebox{0.95\linewidth}{!}{\bfseries\ifx\NC@namefont\relax\NC@name\else{\NC@namefont\NC@name}\fi}%
|
||||
}%
|
||||
% If height > 4cm, scale down to 4cm; otherwise use 25cm version
|
||||
\ifdim\ht\NC@namebox>4cm
|
||||
{\NC@dbgbox{\makebox[0.95\linewidth][c]{\resizebox{!}{4cm}{\bfseries\ifx\NC@namefont\relax\NC@name\else{\NC@namefont\NC@name}\fi}}}}%
|
||||
\else
|
||||
{\NC@dbgbox{\makebox[0.95\linewidth][c]{\usebox{\NC@namebox}}}}%
|
||||
\fi\par
|
||||
\vspace{5mm}
|
||||
{\NC@dbgbox{\makebox[0.9\linewidth][c]{\resizebox{!}{7.5mm}{\large \NC@country}}}\par}
|
||||
\end{minipage}%
|
||||
}%
|
||||
}
|
||||
|
||||
\ExplSyntaxOn
|
||||
\seq_new:N \l_nc_fields_seq
|
||||
\ior_new:N \l_nc_input_ior
|
||||
|
||||
\cs_new_protected:Npn \NC_process_csv_line:n #1
|
||||
{
|
||||
\tl_set:Nn \l_tmpa_tl {#1}
|
||||
\tl_trim_spaces:N \l_tmpa_tl
|
||||
\tl_if_blank:VTF \l_tmpa_tl
|
||||
{ }
|
||||
{
|
||||
\seq_set_split:NnV \l_nc_fields_seq { , } \l_tmpa_tl
|
||||
\seq_pop_left:NN \l_nc_fields_seq \l_tmpa_tl
|
||||
\tl_trim_spaces:N \l_tmpa_tl
|
||||
\seq_pop_left:NN \l_nc_fields_seq \l_tmpb_tl
|
||||
\tl_trim_spaces:N \l_tmpb_tl
|
||||
\typeout{===\ Printing\ namecard:\ \l_tmpa_tl,\ \l_tmpb_tl\ ===}
|
||||
\namecardsetup{name=\l_tmpa_tl,country=\l_tmpb_tl}
|
||||
\NC@renderpage
|
||||
\newpage
|
||||
}
|
||||
}
|
||||
|
||||
\NewDocumentCommand{\makefoldablenamecard}{ }
|
||||
{
|
||||
\NC@renderpage
|
||||
\newpage
|
||||
}
|
||||
|
||||
\NewDocumentCommand{\makefoldablenamecardsfromfile}{m}
|
||||
{
|
||||
\ior_open:Nn \l_nc_input_ior {#1}
|
||||
\ior_map_inline:Nn \l_nc_input_ior
|
||||
{ \NC_process_csv_line:n {##1} }
|
||||
\ior_close:N \l_nc_input_ior
|
||||
}
|
||||
\ExplSyntaxOff
|
||||
|
||||
\newcommand{\NC@renderpage}{%
|
||||
\thispagestyle{empty}%
|
||||
\begin{tikzpicture}[remember picture,overlay]
|
||||
% Fold guide at the center of the A4 page (parallel to long edge).
|
||||
\draw[dashed,gray!70,line width=0.4pt]
|
||||
([xshift=0.5\paperwidth]current page.south west) --
|
||||
([xshift=0.5\paperwidth]current page.north west);
|
||||
|
||||
% Left panel with text parallel to the long edge.
|
||||
\node[anchor=center] at ([xshift=0.30\paperwidth]current page.west) {\rotatebox{270}{\NC@panelcontent}};
|
||||
|
||||
% Right panel with opposite orientation for the folded side.
|
||||
\node[anchor=center] at ([xshift=0.70\paperwidth]current page.west) {\rotatebox{90}{\NC@panelcontent}};
|
||||
|
||||
% Logos at the outer edges of the page.
|
||||
\node[anchor=west] at ([xshift=10mm]current page.west) {\rotatebox{270}{\NC@renderlogo}};
|
||||
\node[anchor=east] at ([xshift=-10mm]current page.east) {\rotatebox{90}{\NC@renderlogo}};
|
||||
\end{tikzpicture}%
|
||||
\null
|
||||
}
|
||||
|
||||
\makeatother
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 11 KiB |
@@ -0,0 +1,8 @@
|
||||
Alex Johnson,Sweden
|
||||
Mina Patel,India
|
||||
Sofia Garcia,Spain
|
||||
Jan van den Heuvel tot Beichlingen, Netherlands
|
||||
Valgerður Ólafsdóttir, Iceland
|
||||
李明 (Lǐ Míng), China
|
||||
王芳,中国
|
||||
O.K., NL
|
||||
|
Reference in New Issue
Block a user