vintage-latex README

The project's README from github.com/Foadsf/vintage-latex. As one markdown file: README.md.

Vintage scientific papers with LaTeX

Twenty small examples show independent mechanisms behind a convincing old-scientific-paper aesthetic. Each file is deliberately standalone: copy one, compile it, and remove individual effects to see what they contribute.

The examples fall into three groups: pure LaTeX pages (1, 2, 4, 5, 6, 10 to 14), standalone fiziko MetaPost figures (3, 7, 8, 9), and LaTeX pages with fiziko figures drawn inside them by LuaTeX's built-in MetaPost (15 to 20).

Low-resolution previews of the compiled output; the PDFs themselves are vector and searchable.

01 02 03 04
01 early modern page 02 engraved optics plate 03 Hooke apparatus 04 ornamented incipit
05 06 07 08
05 Victorian newspaper 06 natural history catalogue 07 lens rays 08 Atwood machine
09 10 11 12
09 shading atlas 10 table of logarithms 11 circumpolar star chart 12 snow-crystal micrographs
13 14 15 16
13 cooling curve 14 patent drawing sheet 15 inclined plane 16 telescope plate
17 18 19 20
17 terrestrial globe 18 mechanics primer 19 knots plate 20 phases of the moon

The examples

  1. 01-early-modern-page.tex -- OpenType old-style figures and historical ligatures, an explicit long s, warm paper and ink colors, asymmetric margins, a drop capital, spaced small capitals, marginalia, and printer's rules.
  2. 02-engraved-optics-plate.tex -- deterministic irregular strokes and line hatching in TikZ, with labels kept as real searchable text.
  3. 03-fiziko-hooke-apparatus.mp -- a compact Hooke apparatus drawn with the external fiziko MetaPost library: hatched support, modeled spring, hanging weight, and measured extension.
  4. 04-ornamented-incipit.tex -- an A5 early-scientific title page with a boxed three-line initial and a small vector ornament made from ordinary TikZ paths.
  5. 05-victorian-newspaper.tex -- a compact square broadsheet with a masthead, balanced columns, rule between columns, pull quotation, article heads, and meteorological register.
  6. 06-natural-history-catalogue.tex -- a museum catalogue page using hanging entries, dot leaders, explicit typographic roles, and old-style numeric data.
  7. 07-fiziko-lens-rays.mp -- a glass lens whose ray paths are computed by fiziko's refraction macro rather than drawn to a predetermined focal point.
  8. 08-fiziko-atwood-machine.mp -- an Atwood machine composed from a hatched support, shaded pulley, curved rope, hanging weights, and acceleration arrow.
  9. 09-fiziko-shading-atlas.mp -- a side-by-side comparison of line shading, stippling, and a variable-width shaded tube.
  10. 10-lua-table-of-logarithms.tex -- a five-place table of logarithms whose every digit is computed by a Lua function at compile time, set in lining tabular figures with the ruling of a nineteenth-century table.
  11. 11-circumpolar-star-chart.tex -- a polar star chart: one macro converts right ascension and declination to chart coordinates for thirty-four catalogued stars, hour circles lettered in roman numerals, and magnitude-graded discs.
  12. 12-snow-crystal-micrographs.tex -- four circular microscope fields; the crystals are grown by TikZ Lindenmayer-system grammars, with six rotated copies of one arm supplying the hexagonal symmetry.
  13. 13-cooling-curve-graph-paper.tex -- a pgfplots chart on sepia graph paper with inward ticks, open-circle plotting symbols, a hand-fitted curve, and an italic marginal remark.
  14. 14-patent-drawing-sheet.tex -- a patent-office plate of a centrifugal governor: numbered leader lines, sections hatched at forty-five degrees, engraved balls, and witness and inventor signature lines.
  15. 15-fiziko-inclined-plane.tex -- a treatise page whose figure is drawn by fiziko inside LuaLaTeX: a wooden wedge, a shaded ball, and the weight resolved along and normal to the slope, with labels set in the page's own text and math fonts.
  16. 16-fiziko-telescope-plate.tex -- a Keplerian telescope in which every ray is refracted by fiziko's tracing macro; the focus and the exit pupil, where the eye is placed, are found where computed rays cross the axis.
  17. 17-fiziko-terrestrial-globe.tex -- the earth from three stations using fiziko's globe with its built-in coastlines, plus a border row of small globes turned by equal steps.
  18. 18-fiziko-mechanics-primer.tex -- a two-column chapter with a loaded cart, a lever in balance, and a pendulum, each drawn in place in its column.
  19. 19-fiziko-knots-plate.tex -- trefoil, cinquefoil, and septafoil cords from one formula each, with fiziko finding the crossings and shading the rope.
  20. 20-fiziko-phases-of-the-moon.tex -- the moon in eight orbital positions under one fixed light, and the same eight phases as seen from the earth by turning the light about a fixed sphere.

The .tex files compile independently with LuaLaTeX. The .mp files are standalone MetaPost sources with fiziko as an explicit external dependency. Examples 15 to 20 need both: they are LuaLaTeX documents that load fiziko through luamplib.

Build

The quickest route is the script for your shell, run from the repository root. Both compile every example into build/ and skip the fiziko examples unless a fiziko checkout is given:

.\build.ps1 -Fiziko ..\fiziko            # PowerShell 7
./build.sh ../fiziko                      # POSIX shell

Append example names to build only those. The sections below spell out the same commands by hand.

Requirements:

From the repository root, create an output directory and compile all pure-LaTeX examples:

# PowerShell 7 on Windows
New-Item -ItemType Directory -Force build | Out-Null
$names = @(
  '01-early-modern-page',
  '02-engraved-optics-plate',
  '04-ornamented-incipit',
  '05-victorian-newspaper',
  '06-natural-history-catalogue',
  '10-lua-table-of-logarithms',
  '11-circumpolar-star-chart',
  '12-snow-crystal-micrographs',
  '13-cooling-curve-graph-paper',
  '14-patent-drawing-sheet'
)
foreach ($name in $names) {
  lualatex -interaction=nonstopmode -halt-on-error `
    -output-directory=build "examples/$name.tex"
}
# POSIX shell on Linux or macOS
mkdir -p build
for name in \
  01-early-modern-page \
  02-engraved-optics-plate \
  04-ornamented-incipit \
  05-victorian-newspaper \
  06-natural-history-catalogue \
  10-lua-table-of-logarithms \
  11-circumpolar-star-chart \
  12-snow-crystal-micrographs \
  13-cooling-curve-graph-paper \
  14-patent-drawing-sheet
do
  lualatex -interaction=nonstopmode -halt-on-error \
    -output-directory=build "examples/$name.tex"
done

The source files intentionally reject pdfLaTeX. That engine cannot provide the OpenType controls demonstrated here.

Build the fiziko examples

Clone fiziko separately; it is not vendored or relicensed here:

git clone https://github.com/jemmybutton/fiziko.git ../fiziko

MetaPost finds fiziko.mp through MPINPUTS. Preserve the trailing path separator so the normal MetaPost search path remains available.

# PowerShell 7 on Windows
$env:MPINPUTS = "$((Resolve-Path ../fiziko).Path);"
New-Item -ItemType Directory -Force build | Out-Null
$names = @(
  '03-fiziko-hooke-apparatus',
  '07-fiziko-lens-rays',
  '08-fiziko-atwood-machine',
  '09-fiziko-shading-atlas'
)
foreach ($name in $names) {
  # -job-name is required by MiKTeX's mpost; omit it on TeX Live (see below).
  mpost -interaction=nonstopmode -halt-on-error `
    -job-name=$name -output-directory=build "examples/$name.mp"
}
# POSIX shell on Linux or macOS
export MPINPUTS="$(cd ../fiziko && pwd):"
mkdir -p build
for name in \
  03-fiziko-hooke-apparatus \
  07-fiziko-lens-rays \
  08-fiziko-atwood-machine \
  09-fiziko-shading-atlas
do
  # Run from inside build/: TeX Live's mpost cannot read the mpx file its
  # btex step writes when -output-directory is used.
  (cd build && mpost -interaction=nonstopmode -halt-on-error \
    "../examples/$name.mp")
done

Each result is named build/<example-name>-1.eps. The two distributions disagree about the job-name flag: MiKTeX's mpost (3.00, checked September 2026) crashes with an access violation at the first btex label unless -job-name=<name> is given, while TeX Live's mpost rejects that spelling and needs no flag at all because the job name defaults to the file's basename. build.ps1 detects MiKTeX and adds the flag; build.sh never does. Convert the EPS files to PDF or PNG with Ghostscript; do not request PDF directly from MetaPost without checking the file signature. Every source uses prologues := 3 so labels are embedded and the output carries an EPSF header.

Build the LaTeX pages with fiziko inside them

Examples 15 to 20 additionally need:

luamplib finds fiziko.mp through the same MPINPUTS variable as above, so set it before running LuaLaTeX:

# PowerShell 7 on Windows
$env:MPINPUTS = "$((Resolve-Path ../fiziko).Path);"
New-Item -ItemType Directory -Force build | Out-Null
$names = @(
  '15-fiziko-inclined-plane',
  '16-fiziko-telescope-plate',
  '17-fiziko-terrestrial-globe',
  '18-fiziko-mechanics-primer',
  '19-fiziko-knots-plate',
  '20-fiziko-phases-of-the-moon'
)
foreach ($name in $names) {
  lualatex -interaction=nonstopmode -halt-on-error `
    -output-directory=build "examples/$name.tex"
}
# POSIX shell on Linux or macOS
export MPINPUTS="$(cd ../fiziko && pwd):"
mkdir -p build
for name in \
  15-fiziko-inclined-plane \
  16-fiziko-telescope-plate \
  17-fiziko-terrestrial-globe \
  18-fiziko-mechanics-primer \
  19-fiziko-knots-plate \
  20-fiziko-phases-of-the-moon
do
  lualatex -interaction=nonstopmode -halt-on-error \
    -output-directory=build "examples/$name.tex"
done

These pages share one pattern. \everymplib inputs fiziko.mp, fixes the random seed, sets the stroke width and light direction, and tints all strokes with the page's ink colour through drawoptions; each figure is then an ordinary mplibcode environment placed where it belongs in the text. Labels written between btex and etex are typeset by the document itself, which is why they appear in EB Garamond and Garamond Math rather than Computer Modern.

Two pitfalls met while writing them:

MiKTeX note: the MiKTeX package luamplib (2.42.8, checked September 2026) ships luamplib.sty but not the luamplib.lua module it requires, so \usepackage{luamplib} fails with "module 'luamplib' not found". The fix is to extract both files from the CTAN luamplib.dtx with luatex luamplib.dtx and place them together in a TEXMF root, then refresh the file name database. TeX Live is not affected.

What was corrected from the design discussion

These examples were developed from a Gemini design discussion supplied by the project owner. The useful ideas survived, but its sample was not copied as-is:

Design notes

This is a period-inspired visual treatment, not a historically exact facsimile. Real seventeenth-, nineteenth-, and early-twentieth-century publications differ substantially by press, date, language, paper, and reproduction process.

For accessible output, keep body text contrast high, retain all diagram labels as text, and do not rasterize the final PDF.

License

The source, prose, and generated examples are licensed under CC BY-SA 4.0. When adapting the project, credit it, link back to the repository, note your changes, and use the same license for the adaptation.

fiziko itself is not included in this repository. It remains a separate GPL-3.0 dependency under the terms published by its upstream project.

vintage-latex (Foadsf/vintage-latex)

Searching Database…

Что это?Коллекция из двадцати самостоятельных примеров на LuaLaTeX и MetaPost (fiziko), воспроизводящих вид старинных научных работ: гравированных таблиц, звёздных карт, вычисленных логарифмических таблиц, узлов и телескопов.
Это переиспользуемый LaTeX-пакет или просто набор файлов-примеров?Это набор независимых исходных файлов-примеров (.tex и .mp), а не пакет: каждый из них рассчитан на то, чтобы его копировали, компилировали и разбирали по частям, чтобы увидеть вклад отдельного эффекта.
Как скомпилировать эти примеры?Запустите из корня репозитория скрипт сборки для вашей оболочки (build.sh или build.ps1); он компилирует каждый пример в build/ и пропускает зависящие от fiziko, если вы дополнительно не укажете чекаут fiziko, а дописав имена конкретных примеров, можно собрать только их.
Что нужно установить перед сборкой?LuaLaTeX из TeX Live или MiKTeX, LaTeX-пакеты вроде fontspec, geometry, microtype, tikz и pgfplots, а также шрифт EB Garamond; примерам на fiziko дополнительно нужны отдельный клон библиотеки fiziko для MetaPost и Ghostscript для конвертации вывода EPS.
Есть ли подводные камни сборки, о которых стоит знать?pdfLaTeX намеренно отклоняется, поскольку не даёт нужных возможностей OpenType; TeX Live и MiKTeX по-разному понимают флаг job-name у mpost, что build.ps1 обрабатывает, а build.sh — нет; а в пакете luamplib у MiKTeX отсутствует необходимый Lua-модуль, который придётся вручную извлечь с CTAN.
Что такое fiziko?fiziko — это внешняя библиотека MetaPost для рисования физических диаграмм (пружины, блоки, линзы, узлы, глобусы), которую используют шесть примеров из двадцати; в этот репозиторий она не входит и клонируется отдельно.
Это исторически точное воссоздание старинных научных работ?Нет, README называет это «визуальной стилизацией под эпоху, а не исторически точной копией» — такие решения, как тёплая бумага, дрожание линий и старомодные цифры, являются сознательными дизайнерскими выборами, а не историческими правилами.
Почему в примерах fiziko фиксируется случайное зерно?Текстуры fiziko (например, древесные волокна или штриховка) используют случайную выборку, поэтому каждый пример fiziko закрепляет фиксированный randomseed, чтобы рисунок оставался одинаковым при повторных сборках.
Можно заменить EB Garamond на другой исторический шрифт?Да, README предлагает в качестве альтернатив шрифты вроде IM FELL English или Old Standard, но рекомендует заново проверить, поддерживает ли замена те же возможности OpenType, что используются здесь.
Creator
Foadsf
Size
1.1 MB
Stars
440
Updated
CommitSep 09
Age
1mo
Commits · 90 Days