mrkeyoor.com_
Tue 01 Sept 17:46 UTC
Dev Toolsevaluationupdated 29 Aug 2026

my-girlfriend-jingtian-latex review

My Girlfriend Jingtian is a Chinese-language XeLaTeX project for one specific short book, and it has no English documentation. It gives readers the finished PDF and gives TeX users the source, cover, and bundled Chinese fonts needed to study or modify its 5 x 8 inch layout.

+269 / 2dstars / 7d
Verdict

This repository gives you one 5 x 8 inch Chinese book and its XeLaTeX source, but it provides no English documentation, release, or declared project license. Read the PDF or borrow a layout technique if the terms fit your use; do not mistake it for a supported publishing framework. Template seekers will get farther with Typst, Pandoc, or a documented LaTeX class.

We ran it

Screenshot of my-girlfriend-jingtian-latex (github.com/HEJustinSun/my-girlfriend-jingtian-latex)

Answers from our run

Did you run my-girlfriend-jingtian-latex yourself?

No. Its code is TeX, and it carries no manifest our lab installs from, and no Dockerfile, so there was nothing standard to install, build or test. This review is written from the repository's own documentation.

Who should not use my-girlfriend-jingtian-latex?

English-only readers: the README and manuscript are Chinese, and the main branch has no English guide or edition.

What are the alternatives to my-girlfriend-jingtian-latex?

Typst, Pandoc, Overleaf. This repository gives you one 5 x 8 inch Chinese book and its XeLaTeX source, but it provides no English documentation, release, or declared project license.

Setup2/5Manual XeLaTeX path only; our lab could not run TeX
Docs2/5A two-command Chinese README with no customization guide
Community3/53,896 stars, but the large queue is mostly reader discussion
Maturity2/5One fixed book, no release, CI, or declared repository license

Who it’s for

Chinese readers who want the supplied PDF or want to inspect how this edition was typeset.
XeLaTeX users looking for a compact example of CJK book layout, running heads, custom paragraph spacing, and an included PDF cover.
Editors who are comfortable separating the useful layout ideas from a manuscript written for one named work.

Who it’s NOT for

English-only readers: the README and manuscript are Chinese, and the main branch has no English guide or edition.
Authors seeking a ready-made book template: the title, author, running heads, cover, fonts, spacing macros, and full manuscript are wired directly into main.tex.
Publishers that require clear reuse terms: GitHub reports no repository license, so the bundled source and finished book do not come with an explicit project-wide grant.
Teams that require an automated build check: the repository has no Dockerfile, and the README documents two manual XeLaTeX commands rather than CI.
Maintainers who want a focused support queue: GitHub listed 511 open issues and pull requests, while many recent issues were reader reactions rather than defect reports.

Setup reality

We did not run commit 0d064f6 in our 3-CPU, 8 GB sandbox. The lab does not support TeX as an ecosystem, and the repository has no Dockerfile that could supply a runnable path. There are therefore no measured install, build, or test results to report.

The README asks for XeLaTeX and a standard TeX Live distribution, then runs xelatex twice into a build directory. The two main Chinese fonts are bundled, but issue 317 notes that the Latin Modern separator font is referenced by name and may depend on a system installation.

This is a 5 x 8 inch book source with a fixed cover PDF and hard-coded Chinese metadata. Reusing the layout means editing TeX rather than filling a documented template, and the repository does not state a project license.

The 5 x 8 inch output is a finished book, not a template library

My Girlfriend Jingtian contains one Chinese manuscript set as a small paperback. The main branch supplies main.tex, a cover PDF, two Source Han font files, their license texts, and a finished copy of the book. Its TeX sets the paper to 5 x 8 inches, uses the book class, and defines running heads, opening-page treatment, story paragraphs, scene breaks, and blank pauses. That makes the repository useful as a concrete specimen. It does not expose those decisions through a configuration file or reusable class.

The distinction matters before you clone it. An author cannot drop a Markdown manuscript into a folder and receive a new book. The title, author, subject, running heads, cover path, font paths, and Chinese prose all live inside one TeX file. Reuse means reading the source and cutting out the parts you understand. For someone learning CJK book composition, that directness may be appealing. For a team building a repeatable publishing line, it creates immediate cleanup work.

The Chinese-only README gives 2 commands and little else

The README says the project requires XeLaTeX and a standard TeX Live distribution. It then creates a build directory and invokes xelatex twice with halt-on-error enabled. Those instructions are easy to read, but they stop before package installation, supported TeX Live versions, expected output, troubleshooting, or customization. There is no English documentation on the main branch, which English-only readers should treat as a firm boundary rather than a translation inconvenience.

The source is more informative than the guide. It shows geometry, fontspec, xeCJK, fancyhdr, pdfpages, and hyperref working together in one compact edition. The bundled Source Han Serif and Sans files remove two common font lookups. A third font, lmroman10-regular.otf, is requested by name for scene separators. Issue 317 points out that this file has no local path, so portability may depend on what the host TeX installation already provides.

What happened when we ran it

commit 0d064f6 was classified as TeX, an ecosystem outside our sandbox harness, and the checkout had no Dockerfile to provide another execution route. The lab environment was an unprivileged Debian container with 3 CPUs, 8 GB of RAM, and no secrets. Because no supported path existed, there is no install time, compiled-PDF result, test count, or dependency audit from the lab. Any claim that the supplied commands work on a fresh Debian host would go beyond the evidence.

The repository does include a finished PDF, so readers can inspect the intended artifact without compiling anything. That is helpful for judging the page size, running heads, spacing, and cover. It does not prove that another machine has all required TeX packages or fonts. If reproducibility matters, try the two documented commands in a pinned TeX Live image and record the engine version and log. This repository does not supply that pinning for you.

Issue 317 identifies layout and portability questions

One detailed issue examines five technical choices in main.tex. It argues that setstretch and the explicit baseline value may compound the line spacing, calls the separator font lookup a portability risk, and questions the configured header height. It also flags a spacing call inside a single-line box and a manual textheight adjustment after geometry. These are reporter findings, not confirmed maintainer decisions, but each points to a specific line that a TeX user can inspect.

That issue is more useful for adoption than the raw queue size. GitHub reported 511 combined open issues and pull requests when fetched, including 474 open issues and 37 open pull requests in separate searches. Many recent entries are jokes, reactions, translations, or proposed adaptations rather than support requests. The volume shows intense attention around the text. It does not show a mature maintenance process for the typesetting code, and buyers should not interpret the combined count as 511 software defects.

No declared license blocks casual reuse

GitHub reports no license for the repository, and the README does not state reuse terms. The included Source Han font files have their own license texts, but those files do not automatically license the manuscript, TeX source, cover, or generated PDF. Anyone planning to redistribute an altered edition, package the layout, or publish a translation needs permission or a separate legal basis. The absence matters more here because the repository mixes code-like TeX with a complete creative work.

There is also no GitHub release. The repository was created on August 27, 2026 and last pushed that same date, while issue activity continued through August 29. Those dates describe a new, active viral project rather than an abandoned one. They also leave no tagged version to pin. If you cite or modify it, record the commit you used because the main branch is the only published version marker available.

Choose it for study, not for a publishing pipeline

As a reading artifact, the project is unusually direct: the finished Chinese PDF sits beside the exact XeLaTeX source that produced the intended design. As an engineering dependency, it asks the adopter to solve licensing, environment pinning, parameterization, and validation. The 5 x 8 inch geometry and CJK font setup are worth studying, especially for editors who already know TeX and can judge issue 317 for themselves.

A reusable book workflow needs clearer inputs and outputs than this repository provides. Typst is a better fit for teams wanting a current typesetting system and packages. Pandoc suits writers who need Markdown and several formats. Overleaf reduces local TeX setup and adds collaboration. My Girlfriend Jingtian remains what its tiny README says it is: a XeLaTeX typesetting project for one named book.

Alternatives

ProjectWhat it isPick it when
TypstA modern typesetting system with its own markup, package catalog, and compiler.pick this instead when you want a maintained general-purpose typesetter and reusable templates rather than one finished Chinese book.
PandocA document converter that can turn Markdown and other formats into PDF through several engines.pick this instead when authors should work in Markdown and the publication pipeline needs several output formats.
OverleafA browser-based LaTeX editor with collaboration and a large template gallery.pick this instead when shared editing and a hosted TeX environment matter more than keeping the whole workflow local.

What people are saying

  1. [velocity-scout] HEJustinSun/my-girlfriend-jingtian-latex

Sources

  1. My Girlfriend Jingtian README
  2. My Girlfriend Jingtian XeLaTeX source
  3. My Girlfriend Jingtian repository facts
  4. Issue 317: typesetting concerns
  5. My Girlfriend Jingtian releases

More dev tools reviews

workmux · v2rayNG · SecLists · hashcat · eslint · fastfetch · the whole board →