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…

这是什么?一组共 20 个独立的 LuaLaTeX 和 MetaPost(fiziko)示例文件,重现老式科学论文的外观:雕版图版、星图、算好的对数表、绳结和望远镜。
这是一个可复用的 LaTeX 宏包,还是只是一组示例文件?它是一组独立的示例源文件(.tex 和 .mp),不是宏包:每个文件都供你复制、编译并拆开研究,看看单个效果各自贡献了什么。
这些示例怎么编译?在仓库根目录运行适合你 shell 的构建脚本(build.sh 或 build.ps1);它会把每个示例编译进 build/,如果你没有另外提供 fiziko 检出,就会跳过依赖 fiziko 的示例;你还可以在命令后追加具体的示例名,只编译那几个。
构建之前需要装好什么?TeX Live 或 MiKTeX 提供的 LuaLaTeX,fontspec、geometry、microtype、tikz 和 pgfplots 等 LaTeX 宏包,外加 EB Garamond 字体;基于 fiziko 的示例还需要单独克隆一份 fiziko MetaPost 库,并用 Ghostscript 转换 EPS 输出。
构建上有什么我该知道的坑吗?pdfLaTeX 会被有意拒绝,因为它无法提供所需的 OpenType 控制;TeX Live 和 MiKTeX 对 mpost 的 job-name 标志处理不一致,build.ps1 处理了这种情况而 build.sh 没有;另外,MiKTeX 的 luamplib 宏包缺少一个必需的 Lua 模块,必须从 CTAN 手动提取。
fiziko 是什么?fiziko 是一个外部 MetaPost 库,用来绘制物理风格的图示(弹簧、滑轮、透镜、绳结、地球仪),20 个示例中有 6 个用到它;它不包含在本仓库里,必须单独克隆。
这是对老式科学论文符合史实的重现吗?不是,README 称它“是一种时代风格的视觉处理,而非历史上精确的复本”——暖色纸张、线条抖动和旧式数字这些选择都是刻意的设计决定,不是历史规则。
为什么 fiziko 图形要固定随机种子?fiziko 的纹理(比如木纹和影线)使用随机采样,所以每个 fiziko 示例都固定一个 randomseed,保证图形在多次重建之间保持一致。
我可以用别的历史字体替换 EB Garamond 吗?可以,README 建议 IM FELL English 或 Old Standard 等字体作为替代,但建议重新确认所选字体支持这里用到的同一批 OpenType 特性。
Creator
Foadsf
Size
1.1 MB
Stars
439
Updated
CommitSep 09
Age
1mo
Commits · 90 Days