Markup: Add print.css; update graphics; add PUBLISHING document

tc39 · Jul 3, 2024 · cb5a2e2 · cb5a2e2
1 parent 3a2efec
commit cb5a2e2
Show file tree

Hide file tree

Showing 14 changed files with 203 additions and 388 deletions.
diff --git a/PUBLISHING.md b/PUBLISHING.md
@@ -0,0 +1,20 @@
+# Publishing the annual PDF
+
+First, make sure you've provided appropriate front matter. `title`, `shortname`, `version`, and `date` are **mandatory**. If generating a final annual edition, date should reflect the date of the Ecma GA which will ratify the Standard. For example:
+
+```
+title: ECMAScript® 2024 Language Specification
+shortname: ECMA-262
+version: 15th Edition
+date: 2024-06-25
+```
+
+Use the package script `build-for-pdf`. Importantly, you want to make sure your image directory and print.css file wind up in the same output directory as your markup, i.e.  your `ecmarkup` command should include the options `--assets external`, `--assets-dir out`, and `--old-toc`.
+
+Then, run `prince` to generate your PDF.
+
+```shell
+prince --script ./node_modules/ecmarkup/js/print.js out/index.html -o path/to/output.pdf
+```
+
+Spend 5-10 minutes double-checking the PDF for egregious layout issues. That means quickly skimming all 800+ pages looking for whitespace or content split in a confusing manner. Tinker with `print.css` only as needed. Compare cover & table of contents to previous years.
diff --git a/img/ecma-header.svg b/img/ecma-header.svg
diff --git a/img/ecma-logo.svg b/img/ecma-logo.svg
diff --git a/img/figure-1.svg b/img/figure-1.svg
diff --git a/img/figure-2.svg b/img/figure-2.svg
diff --git a/img/module-graph-cycle-async.svg b/img/module-graph-cycle-async.svg
diff --git a/img/module-graph-cycle.svg b/img/module-graph-cycle.svg
diff --git a/img/module-graph-missing.svg b/img/module-graph-missing.svg