NHL team hub pages
Use this when adding or refreshing an NHL club desk under The Pros.
This is not the sled team-profile flow in nikola/AGENTS.md. Club desks are Hugo section indexes, not team-profile-*.md posts.
Do not hand-edit content/the-pros/<league>/teams/<slug>/_index.md.
The layout is the Python template in hockey_generator.services.nhl.team_hubs.
Change that file, then rewrite every hub so the format stays in sync.
NHL hubs use /the-pros/nhl/teams/<slug>/; PWHL hubs use
/the-pros/pwhl/teams/<slug>/. Article posts stay under the team directory but
keep url: /posts/<post-slug>/.
Fast path
- Open
apps/hockey_addict_generator/src/hockey_generator/services/nhl/team_hubs.py. - Copy an existing
NhlTeamHub(...)inNHL_TEAM_HUBS(Lightning is the layout reference). - Fill in only the club-specific bits listed under Swap these. Do not invent tags, URLs, roster moves, scores, or league membership.
- Run
make write-nhl-team-hubs(orpython -m hockey_generator.cli.write_nhl_team_hubs). That rewrites every club_index.mdfrom the shared template, including sibling jump chips. - Add a
[[menu.main]]entry inhugo.tomland a chip oncontent/the-pros/_index.mdonly if the club should be in the top nav (in_nav=True). - New posts land in the club folder because
hugo_sectionsreadsNHL_TEAM_HUBS. The daily digest includes every NHL club desk (not PWHL). - To create pages for every NHL and PWHL club in the database (skipping ones that already exist):
python -m hockey_generator.cli.write_nhl_team_hubs --from-database --missing-only. Do not add those clubs to top nav unless they are already a nav item.
To change the page format (header, tools row, videos/podcasts, news): edit render_team_hub_page / _TEAM_HUB_BODY in team_hubs.py, then run make write-nhl-team-hubs. Do not restyle one _index.md by itself.
Files to open
- This file
apps/hockey_addict_generator/src/hockey_generator/services/nhl/team_hubs.pyapps/hockey_addict_site/hugo.toml[menu.main]only for nav clubscontent/the-pros/_index.mdonly for nav chipscontent/_index.mdonly if you need the homepage header shape
Do not copy _index.md from Lightning. The writer emits that layout.
Look up the club first
- A hub already exists in
NHL_TEAM_HUBS: update that dataclass, then rewrite. - A stub still lives under
content/posts/<slug>.md: keepaliases: ["/posts/<slug>/"]on the hub (the template already adds this). - Nothing exists: append
NhlTeamHuband rewrite.
Do not create a second slug for the same club. Article posts stay at
url: /posts/<post-slug>/. The hub uses /the-pros/<league>/teams/<slug>/;
old /the-pros/<slug>/ URLs are aliases only.
Page order (do not reorder)
- Homepage-style header (
nhl-hub-hero+home-hub-hero) - Stats (
TEAM_HUB_STATSmarkers): last 10 games and a two-week LLM desk note. NHL clubs only. Filled by the daily pipeline (write_nhl_team_hub_stats). - Compact black tool cards in one row
- Videos and podcasts in two columns (last 10 each)
- News (
post-list), unchanged when restyling tools or media
Put stats, tools, videos/podcasts, and news below the header. Do not nest the tools row inside the hero. Do not bring back per-show Coach Rox cards or Spotify show embeds.
Swap these
| Piece | What to change on NhlTeamHub |
|---|---|
| Identity | title, slug, html_id, short_name, kicker, date, description |
| Intro | Short Coach Rox desk intro. Keep facts the user pasted or that were already on the page. |
| Tools | nhl_path, nst, nst_label, ahl_name, ahl_url, optional extra_tiles |
| Shortcode tags | Tags that already exist on posts for that club (video_tags, podcast_tags, news_tag, summary_tag) |
| Post routing | section_exact, section_prefixes, section_contains, slug_prefixes |
| Nav | in_nav=True only if the club is a top-nav item |
Jump chips (#<id>-stats on NHL clubs, #<id>-tools, videos, podcasts, news, NHL hub, other nav clubs) are generated. Shared tile layout also lives in static/css/perf.css.
Tool cards
One Bootstrap row. Each card is a .col. Three columns on phones, six on desktop. Do not split tools across two rows. Do not stack them in a single column.
URL patterns (filled from the dataclass):
- NHL.com:
https://www.nhl.com/<nhl-path> - Daily Faceoff:
https://www.dailyfaceoff.com/teams/<slug>/line-combinations - Frozen Pool:
https://frozenpool.dobbersports.com/frozenpool_lastgamelines.php?team=<nst> - PuckPedia:
https://puckpedia.com/team/<slug> - Natural Stat Trick:
https://www.naturalstattrick.com/teamreport.php?team=<nst> - MoneyPuck:
https://moneypuck.com/ - Prospects:
/the-pros/nhl-prospects/
Card copy: NHL.com scores/video/tickets; Daily Faceoff lines and goalies; Frozen Pool last game lines (Dobber); PuckPedia cap hits and space; Natural Stat Trick 5v5 report; MoneyPuck game and season projections; AHL affiliate name; NHL Prospects draft classes and scouting shows.
Club-specific coverage sites go on extra_tiles (NhlHubTile href, title, subtitle). Lightning currently adds Lightning Insider, Bolts by the Bay, and Raw Charge. Extra tiles wrap onto the next row; do not change the three-across / six-across card width.
Videos, podcasts, news
stop="10" for media, stop="12" for news. Tags come from the dataclass. Use tags that already exist on posts.
Clubs already on this pattern
| Club | slug | nhl-path | NST | AHL | Videos | Podcasts | News |
|---|---|---|---|---|---|---|---|
| Lightning | tampa-bay-lightning |
lightning |
T.B |
Syracuse Crunch | tbl |
tbl-podcasts, tbl |
tampa_bay_lightning |
| Canadiens | montreal-canadiens |
canadiens |
MTL |
Laval Rocket | mtl |
mtl |
mtl |
| Panthers | florida-panthers |
panthers |
FLA |
Charlotte Checkers | fla |
fla |
fla |
| Maple Leafs | toronto-maple-leafs |
mapleleafs |
TOR |
Toronto Marlies | tor |
tor |
tor |
| Rangers | new-york-rangers |
rangers |
NYR |
Hartford Wolf Pack | nyr |
nyr |
nyr |
AHL sites already used: https://www.syracusecrunch.com/, https://www.lavalrocket.com/, https://www.charlottecheckers.com/, https://www.marlies.ca/, https://www.hartfordwolfpack.com/.
NHL daily feed summary
The daily digest (nhl-feed-summary-YYYY-MM-DD) is built from NHL_FEED_SUMMARY_DESKS in apps/hockey_addict_generator/src/hockey_generator/post_generator/feed_summary.py, which imports club desks from NHL_TEAM_HUBS.
Page order:
- Team jump chips for every NHL club
- League-wide NHL recap at the top (quotes and sentiment). No Works cited / Today’s coverage / Sources labels.
- League-wide Videos, Podcasts, and Feeds in three columns
- Club desks: city kicker plus nickname, Team Page (orange) left of Official Site, that club’s sentiment gauge and citations, then Videos | Podcasts | Feeds
ensure_nhl_feed_summary_source_registered copies desk summary_tag values onto the NHL Feed Summary source (teams before nhl).