Skip to content

Commit cb5a2e2

Browse files
committed
Markup: Add print.css; update graphics; add PUBLISHING document
1 parent 3a2efec commit cb5a2e2

14 files changed

+203
-388
lines changed

Diff for: PUBLISHING.md

+20
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
# Publishing the annual PDF
2+
3+
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:
4+
5+
```
6+
title: ECMAScript® 2024 Language Specification
7+
shortname: ECMA-262
8+
version: 15th Edition
9+
date: 2024-06-25
10+
```
11+
12+
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`.
13+
14+
Then, run `prince` to generate your PDF.
15+
16+
```shell
17+
prince --script ./node_modules/ecmarkup/js/print.js out/index.html -o path/to/output.pdf
18+
```
19+
20+
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 for: img/ecma-header.svg

+1
Loading

Diff for: img/ecma-logo.svg

+1-120
Loading

Diff for: img/figure-1.svg

+1-1
Loading

Diff for: img/figure-2.svg

+1-1
Loading

Diff for: img/module-graph-cycle-async.svg

+1-69
Loading

Diff for: img/module-graph-cycle.svg

+1-63
Loading

Diff for: img/module-graph-missing.svg

+1-48
Loading

0 commit comments

Comments
 (0)