Jason StedwellandClaude Opus 5.5
5b52636003
MPM Document Standard 1.3, mpmdoc build engine, templates for TN, INS, SOP, BOM, SVY, TAP, DWG, TSB, PRO, SOW and WO (Chinese editions for TN and DWG), glossary, MPM fonts and logos, and the mpm-technical-documents plugin 1.3.0. Worked examples ship in the kit zip on Drive only. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01NWatTMmqmGatgHjDZvWs5b
77 lines
3.6 KiB
Markdown
77 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 |
|