Project Oberon TeX 项目使用说明

1. 项目的目录结构及介绍

Project Oberon TeX 项目目录结构如下：

tex-oberon/
├── pdfs/
├── src/
│   ├── grammar.peg
│   ├── grammar.pegjs
│   ├── Makefile
│   ├── README.md
│   ├── LICENSE.md
│   ├── oberon.tex
│   ├── plan.org
│   ├── taocpmac.tex
│   ├── tex_pygments_formatter.py
│   ├── unfinished-chapters.tex
└── ...

• pdfs/: 存放生成的 PDF 文件。

• src/: 包含项目的主要源文件和配置文件。

  • grammar.peg: 语法文件，用于定义项目的语法规则。
  • grammar.pegjs: JavaScript 语法的 PEG.js 文件。
  • Makefile: 用于构建项目的 Makefile 文件。
  • README.md: 项目说明文件。
  • LICENSE.md: 项目许可证文件。
  • oberon.tex: 主 TeX 文件，用于排版 Project Oberon。
  • plan.org: 计划文件，可能是项目的规划或笔记。
  • taocpmac.tex: Knuth 的宏定义文件。
  • tex_pygments_formatter.py: 用于格式化代码片段的 Python 脚本。
  • unfinished-chapters.tex: 未完成章节的 TeX 文件。

2. 项目的启动文件介绍

项目的启动文件是 oberon.tex，这是主 TeX 文件，用于排版 Project Oberon 的内容。要编译这个文件，你需要使用 TeX 发行版，如 TeX Live 或 MiKTeX。

编译命令如下：

luatex oberon.tex

执行此命令后，你可以在 pdfs/ 目录中找到生成的 PDF 文件。

3. 项目的配置文件介绍

项目的配置文件主要是 Makefile，它定义了构建项目所需的命令和步骤。以下是 Makefile 的一些基本用法：

.PHONY: all pdf

all: pdf

pdf: oberon.pdf

oberon.pdf: oberon.tex
	luatex oberon.tex

在这个 Makefile 中，all 目标依赖于 pdf 目标，而 pdf 目标又依赖于 oberon.pdf 文件。oberon.pdf 文件的生成依赖于 oberon.tex 文件，并使用 luatex 命令进行编译。

你可以通过以下命令来构建 PDF：

make

这将调用 luatex 命令来编译 oberon.tex 文件，并在 pdfs/ 目录中生成 oberon.pdf 文件。

以上是 Project Oberon TeX 项目的目录结构、启动文件和配置文件的简要介绍。希望这能帮助您更好地了解和使用该项目。