thermograph/frontend/server/internal/render/templates/city.html.tmpl
emi 92e74c585a
All checks were successful
Sync infra to hosts / sync-beta (push) Successful in 13s
Sync infra to hosts / sync-prod (push) Successful in 12s
secrets-guard / encrypted (push) Successful in 7s
shell-lint / shellcheck (push) Successful in 8s
Build + push frontend image (Forgejo registry) / build-push (push) Successful in 53s
Deploy frontend to beta VPS / deploy (push) Successful in 1m16s
secrets-guard / encrypted (pull_request) Successful in 5s
shell-lint / shellcheck (pull_request) Successful in 6s
frontend: rewrite the SSR content service in Go (#28)
Ports frontend/ (Jinja2/FastAPI, ~1180 LOC) to Go with html/template. No
climate math, no DB, no auth -- every route fetches from the backend's
/content/* API.

Verified with a golden-HTML diff, not just unit tests: both the Python
original and the Go rewrite were run against the same committed fixtures
and every route compared byte-for-byte, confirmed programmatically. That
process caught defects unit tests alone missed, since map[string]any has
no compile-time field check:

- Render-context keys were snake_case throughout while the templates read
  PascalCase fields. A missing map key doesn't error, it silently renders
  empty -- title, meta description, canonical URL, OpenGraph tags, and the
  homepage's entire ranked list were blank on every page despite every
  route returning 200. Fixed by renaming every key to match each
  template's own documented field contract, and passing API structs
  straight through wherever their fields already matched (removes a whole
  layer of future drift risk).
- Three pages 500'd: ToolHref needed a composed href, not a bare
  "lat,lon" fragment; the records table needed the raw API struct.
- JSON-LD was double-encoded: <script type="application/ld+json"> is
  JAVASCRIPT context to html/template's escaper regardless of the
  script's type attribute, so template.HTML gets re-escaped as a quoted
  JS string. Needed template.JS. The glossary term page's JSON-LD was
  never built at all -- added.
- html/template silently strips literal HTML and JS comments from parsed
  output (verified in isolation) -- both need a FuncMap function
  returning template.HTML/template.JS to survive.

Packaging: 187MB -> 22.6MB. Two defects caught before reaching a host: the
Swarm stack's entrypoint override with no explicit command drops the
image's CMD entirely (every deploy would have exited 127), and
COPY --chown by name fails under the classic Docker builder on Alpine.
Both fixed.

go build/vet/test -race clean; docker build passes its embedded test step
under both BuildKit and the classic builder; shellcheck 0 findings.
2026-07-24 00:53:48 +00:00

101 lines
No EOL
6.1 KiB
Cheetah
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

{{/* Ported from templates/city.html.j2. Extra data (built by the handler
inside unit_scope(default_unit), as content.py's city_page did):
.Breadcrumb; .City (needs .Slug); .Display/.Name string;
.YearRange [2]int; .NYears int;
.Months []{Name, Slug string; HighF, LowF, RangeLoF, RangeHiF *float64;
High, Low, Precip template.HTML;
Bar *{Left, Width string; C1, C2 string}}
— Bar.Left/Width are STRINGS pre-formatted to Python's repr of
round(x, 1) ("36.0", not "36"): Go's %v drops the ".0" and the golden
diff would catch it;
.Warmest/.Coldest/.Wettest *month (entries of .Months, or nil);
.Records contentapi.AllTimeRecords (raw floats; .Fmt.Temp in-template);
.Today *{Date string; Cards []{Label, Grade, Cls string;
Value template.HTML; Percentile *float64}};
.Flavor *{Extract string; URL string}; .Event *{Text string; URL string};
.ToolHref string (full "{base}/#{lat:.5f},{lon:.5f}" href — composed
inline, html/template's fragment urlEscaper would %-escape the comma);
.CompareURL string ("{base}/compare#loc={lat:.4f},{lon:.4f}");
.JSONLDStr template.JS (compacted raw payload bytes — the |safe site;
trusted backend-owned JSON-LD, never re-marshaled through a Go map). */}}{{template "base_head_start" .}}{{template "base_head_end" .}}<script type="application/ld+json">{{.JSONLDStr}}</script>{{template "base_body_start" .}}{{template "breadcrumb" .}}
<article class="climate-page">
<h1>{{.Display}} climate</h1>
<p class="lede">Average temperatures, precipitation and all-time records for <b>{{.Display}}</b>,
with every day graded against ~{{.NYears}} years of local climate history
({{index .YearRange 0}}{{index .YearRange 1}}).{{if and .Warmest .Coldest}} Its warmest month is
<b>{{.Warmest.Name}}</b>, averaging a high of {{.Warmest.High}}, and its coldest is
<b>{{.Coldest.Name}}</b>, with an average low of {{.Coldest.Low}}.{{end}}</p>
{{if .Flavor}} <p class="city-blurb">{{.Flavor.Extract}}{{if .Flavor.URL}}
<a class="blurb-src" href="{{.Flavor.URL}}" rel="nofollow">via Wikipedia</a>{{end}}</p>
{{end}}
{{if .Today}} <section class="climate-today">
<h2>How today compares</h2>
<p class="muted">Latest recorded day: {{.Today.Date}}. Each reading placed on {{.Display}}'s
own ±7-day seasonal distribution.</p>
<div class="today-cards">
{{range .Today.Cards}} <div class="today-card" style="border-left-color: var(--{{.Cls}})">
<span class="tc-label">{{.Label}}</span>
<span class="tc-value">{{.Value}}</span>
{{if .Percentile}}<span class="tc-grade">{{.Grade}} · {{ordinal .Percentile}} pct</span>
{{else}}<span class="tc-grade">{{.Grade}}</span>{{end}} </div>
{{end}} </div>
<p><a class="cta" href="{{.ToolHref}}">Open {{.Name}} in the live weather grader →</a></p>
</section>
{{end}}
{{if .Event}} <section class="city-event">
<h2>Notable weather in {{.Name}}</h2>
<p>{{.Event.Text}}{{if .Event.URL}} <a href="{{.Event.URL}}" rel="nofollow">Read&nbsp;more&nbsp;→</a>{{end}}</p>
</section>
{{end}}
<section class="climate-normals">
<h2>{{.Name}} average temperatures by month</h2>
<p>Typical daily high and low, and average precipitation, for each month in {{.Display}},
based on {{index .YearRange 0}}{{index .YearRange 1}} records.
{{if .Wettest}}The wettest month is <b>{{.Wettest.Name}}</b> ({{.Wettest.Precip}} on an average day).{{end}}</p>
<div class="table-wrap">
<table class="normals-table">
<thead><tr><th>Month</th><th>Avg high</th><th>Avg low</th><th>Avg precip</th></tr></thead>
<tbody>
{{range .Months}} <tr>
<td><a href="{{$.Base}}/climate/{{$.City.Slug}}/{{.Slug}}">{{.Name}}</a></td>
<td class="t-cell t-{{$.Fmt.TempClass .HighF}}">{{.High}}</td>
<td class="t-cell t-{{$.Fmt.TempClass .LowF}}">{{.Low}}</td>
<td>{{.Precip}}</td>
</tr>
{{end}} </tbody>
</table>
</div>
<div class="range-strip" aria-hidden="true">
{{range .Months}} <div class="range-row">
<span class="range-month">{{slice .Name 0 3}}</span>
<span class="range-track">
{{if .Bar}}<span class="range-fill" style="left:{{.Bar.Left}}%;width:{{.Bar.Width}}%;--c1:var(--{{.Bar.C1}});--c2:var(--{{.Bar.C2}})"></span>{{end}} </span>
{{if and .RangeLoF .RangeHiF}} <span class="range-vals">{{$.Fmt.TempBare .RangeLoF}}{{$.Fmt.TempBare .RangeHiF}}</span>
{{else}}<span class="range-vals">—</span>{{end}} </div>
{{end}} </div>
<p class="range-note muted">Each bar spans the 10th-percentile daily low to the 90th-percentile daily
high (the range most days fall within), coloured cold&nbsp;→&nbsp;hot on a shared
{{.Fmt.Temp -10.0}} to {{.Fmt.Temp 115.0}} scale, so the whole year's rhythm reads at a glance.</p>
</section>
<section class="city-travel">
<h2>Thinking of visiting {{.Name}}?</h2>
<p>Trips live and die by the weather. See how {{.Name}}'s comfort stacks up against where
you live. {{.Name}} is pre-loaded, just add your city.</p>
<p><a class="cta" href="{{.CompareURL}}">Compare {{.Name}}'s comfort with your city →</a></p>
</section>
{{if or .Records.Tmax .Records.Tmin}} <section class="climate-records">
<h2>Record extremes</h2>
<ul>
{{if .Records.Tmax}}<li><b>Hottest day on record:</b> {{.Fmt.Temp .Records.Tmax.Max}} on {{.Records.Tmax.MaxDate}}</li>{{end}}{{if .Records.Tmin}}<li><b>Coldest day on record:</b> {{.Fmt.Temp .Records.Tmin.Min}} on {{.Records.Tmin.MinDate}}</li>{{end}} </ul>
<p><a href="{{.Base}}/climate/{{.City.Slug}}/records">All {{.Name}} weather records →</a></p>
</section>
{{end}}
<p class="climate-foot muted">Percentiles compare each day to {{.Display}}'s own history, so grades are
relative to this location: a “Near Record” day here isn't the same temperature as elsewhere.
<a href="{{.AssetBase}}/legend">How the grades work →</a></p>
</article>
{{template "base_body_end" .}}{{template "base_scripts_default" .}}{{template "base_tail" .}}