feat(marketing): rewrite site copy across all 12 locales

app/Console/Commands/GenerateOgImagesCommand.php

@@ -4,6 +4,7 @@
 
 use App\Services\Og\OgImageRenderer;
 use App\Services\Og\OgImageRenderException;
+use App\Support\Assets\AssetManifest;
 use App\Support\Content\ContentRepository;
 use App\Support\Localization\Locales;
 use App\Support\Localization\LocalizedUrl;
@@ -32,8 +33,8 @@
  * (`OgImages::cardPath()`, `OgImages::fallbackPath()`):
  *
  * - `site`: the generic brand card per locale, from `content/{locale}/home.json`
- *   → `og`. English goes to `/og.png`, regenerated in place so old shares and
- *   the platform's default pick it up; Vietnamese to `/og/vi/default.png`.
+ *   → `og`. English goes to `/og.png` unless supplied artwork already occupies
+ *   that URL, in which case it is preserved; Vietnamese to `/og/vi/default.png`.
  * - `feature`, `database`, `compare`: one card per page, from the `og` block
  *   of its content file. A page whose content has no `og` block keeps
  *   whatever card it has.
@@ -65,6 +66,7 @@ public function handle(
         OgImageRenderer $renderer,
         OgFonts $fonts,
         Filesystem $files,
+        AssetManifest $assets,
     ): int {
         $type = (string) $this->option('type');
         $locale = (string) $this->option('locale');
@@ -89,6 +91,12 @@ public function handle(
 
         if (($type === 'all' || $type === 'site') && $slug === null) {
             foreach ($locales as $code) {
+                if ($assets->ogCard(OgImages::SITE_CARD, $code) === OgImages::fallbackPath($code)) {
+                    $this->components->info("Preserved supplied site artwork ({$code}) at " . OgImages::fallbackPath($code));
+
+                    continue;
+                }
+
                 $card = $this->siteCard($content, $code);
 
                 if ($card === null) {

app/Support/Assets/AssetManifest.php

@@ -376,6 +376,11 @@ public function fileUrl(string $id, string $variant, ?string $locale, ?int $widt
         $base = $entry['replacement']['base'];
 
         if ($entry['kind'] === 'og-card') {
+            // The supplied default-language site card has one canonical URL,
+            // also used by old shares and the account app.
+            if ($id === 'og-site' && ($locale ?? Locales::default()) === Locales::default()) {
+                return '/og.png';
+            }
             return "{$dir}/{$base}-" . ($locale ?? Locales::default()) . ".{$format}";
         }
 

app/Support/Assets/HandoffDocument.php

@@ -890,6 +890,12 @@ private function filePattern(array $entry, array $kind, ?int $cap = null): strin
         $locales = Locales::codes();
 
         if ($entry['kind'] === 'og-card') {
+            if ($base === 'og-site') {
+                $locales = array_values(array_diff($locales, [Locales::default()]));
+
+                return 'public/og.png (en); ' . "{$dir}/{$base}-" . $this->brace($locales) . '.png';
+            }
+
             return "{$dir}/{$base}-" . $this->brace($locales) . '.png';
         }
 

app/Support/Seo/OgImages.php

@@ -19,7 +19,8 @@
  *
  * The bespoke card is the `og-site` entry of `resources/data/assets.json`
  * (spec §9.1, docs/rebuild/assets/og.md). Marking it `supplied` and dropping
- * in `og-site-{locale}.png` is all it takes: `AssetManifest::ogCard()` answers
+ * in `/og.png` for English or `og-site-{locale}.png` for another locale
+ * is all it takes: `AssetManifest::ogCard()` answers
  * only once the entry is supplied and that locale's file exists, so a locale
  * whose file is missing keeps its generated card.
  *
@@ -32,9 +33,9 @@
  * - A page card is `/og/{family}/{slug}.png` in the default locale, so every
  *   card shared before the rebuild keeps resolving, and
  *   `/og/{locale}/{family}/{slug}.png` in any other.
- * - The generic card is `/og.png` in the default locale (the file is
- *   regenerated in place, so old shares and the platform app's default pick up
- *   the new card) and `/og/{locale}/default.png` in any other (sitemap §C.7).
+ * - The generic card is `/og.png` in the default locale. Supplied artwork is
+ *   preserved by the generator, so old shares and the platform app use the
+ *   same card. Other locales retain their existing supplied/fallback paths.
  */
 final class OgImages
 {

lang/de/og.php

@@ -7,6 +7,6 @@
         'database' => 'Datenbanken',
         'feature' => 'Funktionen',
     ],
-    'author' => 'Das TablePro-Team',
+    'author' => 'TablePro',
     'byline' => ':author · :date',
 ];

lang/en/og.php

@@ -23,7 +23,7 @@
         'feature' => 'Features',
     ],
 
-    'author' => 'The TablePro team',
+    'author' => 'TablePro',
 
     'byline' => ':author · :date',
 ];

lang/es/og.php

@@ -7,6 +7,6 @@
         'database' => 'Bases de datos',
         'feature' => 'Funciones',
     ],
-    'author' => 'El equipo de TablePro',
+    'author' => 'TablePro',
     'byline' => ':author · :date',
 ];

lang/fr/og.php

@@ -7,6 +7,6 @@
         'database' => 'Bases de données',
         'feature' => 'Fonctionnalités',
     ],
-    'author' => 'L’équipe TablePro',
+    'author' => 'TablePro',
     'byline' => ':author · :date',
 ];

lang/id/og.php

@@ -7,6 +7,6 @@
         'database' => 'Database',
         'feature' => 'Fitur',
     ],
-    'author' => 'Tim TablePro',
+    'author' => 'TablePro',
     'byline' => ':author · :date',
 ];

lang/it/og.php

@@ -7,6 +7,6 @@
         'database' => 'Database',
         'feature' => 'Funzionalità',
     ],
-    'author' => 'Il team TablePro',
+    'author' => 'TablePro',
     'byline' => ':author · :date',
 ];

lang/ja/og.php

@@ -7,6 +7,6 @@
         'database' => 'データベース',
         'feature' => '機能',
     ],
-    'author' => 'TablePro チーム',
+    'author' => 'TablePro',
     'byline' => ':author · :date',
 ];

lang/ko/og.php

@@ -7,6 +7,6 @@
         'database' => '데이터베이스',
         'feature' => '기능',
     ],
-    'author' => 'TablePro 팀',
+    'author' => 'TablePro',
     'byline' => ':author · :date',
 ];

lang/pt-BR/og.php

@@ -7,6 +7,6 @@
         'database' => 'Bancos de dados',
         'feature' => 'Recursos',
     ],
-    'author' => 'A equipe TablePro',
+    'author' => 'TablePro',
     'byline' => ':author · :date',
 ];

lang/vi/og.php

@@ -17,7 +17,7 @@
         'feature' => 'Tính năng',
     ],
 
-    'author' => 'Đội ngũ TablePro',
+    'author' => 'TablePro',
 
     'byline' => ':author · :date',
 ];

lang/zh-Hans/og.php

@@ -7,6 +7,6 @@
         'database' => '数据库',
         'feature' => '功能',
     ],
-    'author' => 'TablePro 团队',
+    'author' => 'TablePro',
     'byline' => ':author · :date',
 ];

lang/zh-Hant/og.php

@@ -7,6 +7,6 @@
         'database' => '資料庫',
         'feature' => '功能',
     ],
-    'author' => 'TablePro 團隊',
+    'author' => 'TablePro',
     'byline' => ':author · :date',
 ];