# _ASSETS

Shared fonts and logos for every document in DOCUMENTATION PROJECT. The build engine
(`_STANDARDS/mpmdoc`) reads from here; project folders should never keep their own copies.

```
_ASSETS/
  mpm/                     ← Message Point Media (default brand)
    logos/png/             24 raster logos (documents, screen)
    logos/svg/             40 vector logos (print, large format, drawings)
    fonts/                 official variable TTFs + OFL licences
      web/                 JetBrains Mono source + static/ (generated Latin-subset weights)
      fonts_embed.css      GENERATED: what the engine inlines into PDFs
      make_embed.py        regenerates web/ and fonts_embed.css
      cjk/                 MPM SC: Noto Sans CJK SC (SIL OFL), GB2312 cut, TrueType outlines,
                           for Chinese editions (standard §12); make_cjk.py rebuilds it
```

Source: the **mpm-brand-voice** plugin kit, which mirrors the MPM Logos Drive folder
(`01 New Logos > PNG / SVG`) and Google Fonts. Update the plugin or Drive first, then re-copy here.

## Which logo

| Use | File |
|---|---|
| **Document header on white (engine default)** | `logos/png/Logo-Gold-Black.png` |
| Dark title block, dark banner, cover on Ink | `logos/png/Logo-Gold-White.png` |
| Single-colour black print / fax / legal | `logos/png/Logo-Black-Text.png` |
| Icon only on a dark background | `logos/png/Logo-White-Cutout.png` |
| Transit-agency proposal / sell sheet, light background | `logos/png/MPM-Transitpoint-Dark.png` |
| Same, dark background | `logos/png/MPM-Transitpoint-Light.png` |
| Drawings (DWG title block), print | the matching `.svg` in `logos/svg/` |
| Transit product sub-brands (Smart Stop, Mobile, MPRail …) | `logos/svg/` only, always alongside the MPM logo |

> **Note:** `Logo-Standard-Dark.png` is labelled the "default" in the brand plugin, but the file
> is the dark-icon variant (no gold). Documents use `Logo-Gold-Black.png`, which is the version
> on every document built so far.

**Rules:**
- Never put a dark-text logo on a dark background.
- Don't stretch, recolour or add effects.
- Keep clear space equal to the height of the M icon.
- "Powered by MPM" (`Logo-Powered`) is for partner/OEM use only.

## Fonts

| Role | Family | File |
|---|---|---|
| Headings, kickers, labels, captions | Montserrat | `fonts/Montserrat-wght.ttf` (+ Italic) |
| Body | Open Sans | `fonts/OpenSans-wght.ttf` (+ Italic) |
| Numbers, dimensions, part numbers, calcs | JetBrains Mono | `fonts/web/JetBrainsMono-wght-latin.woff2` |

- All three are variable fonts: one file per family covers every weight.
- Montserrat and Open Sans are the MPM brand fonts. JetBrains Mono is the documentation standard's addition for numeric content.
- Never substitute Arial, Calibri or a system font.
- To install them on your Mac (for Word, Keynote, etc.), double-click the `.ttf` files.

After replacing any font file:

```
pip install fonttools brotli
python3 _ASSETS/mpm/fonts/make_embed.py
```

## Colour system (official MPM)

| Name | Hex | Used for in documents |
|---|---|---|
| Middle Gold | `#DCBB4F` | Accent rules, step numbers, header underline |
| Dark Gold | `#998643` | Kickers, labels, FIG/TABLE tags, gold text on light backgrounds |
| Light Gold | `#F5CD15` | Gold on dark backgrounds only |
| Dark Shade | `#232022` | Text, dark callout boxes |
| Light Shade | `#F5F1EC` | Info strip, notes, calc blocks |
| Light Accent | `#849698` | Ledes, captions, secondary text, running footer |
| Dark Accent | `#A42D20` | Warnings, limits, failing values (accent: keep under 10% of the page) |
| 2nd Dark Accent | `#282637` | Not used in documents |