76 lines
3.6 KiB
Markdown
76 lines
3.6 KiB
Markdown
|
# _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 |
|