Editing Wiki.tetrain.com Runbook (section)

== Phase 6 — Logo sizing fix (verified exact, from the decision log) ==

Two root causes, both already diagnosed precisely in the decision log:

<pre>
<nowiki>
# 1. Wrong skin variant — legacy Vector was being selected instead of Vector 2022
#    Fix: in LocalSettings.php, change:
#      $wgDefaultSkin = "vector";
#    to:
#      $wgDefaultSkin = "vector-2022";
</nowiki>
</pre>

<pre>
<nowiki>
# 2. Logo was being force-fit into Vector 2022's fixed 50x50 icon slot, distorting it.
mkdir -p /var/www/wiki/resources/assets/logo
# download the real company logo (tetra_logo_2017Web.png, 198x399px) and host it locally
# rather than hotlinking www.tetrain.com, then re-composite onto properly sized, transparent,
# square canvases at each density (letterboxed/centered, not stretched):
#   tetrain_logo_1x.png   -> 50x50
#   tetrain_logo_1.5x.png -> 75x75
#   tetrain_logo_2x.png   -> 100x100
</nowiki>
</pre>

Then set (already reflected in the Phase 5.4 <code><nowiki>LocalSettings.php</nowiki></code> listing above):

<pre>
<nowiki>
$wgLogos = [
	"1x" => "$wgResourceBasePath/resources/assets/logo/tetrain_logo_1x.png",
	"1.5x" => "$wgResourceBasePath/resources/assets/logo/tetrain_logo_1.5x.png",
	"2x" => "$wgResourceBasePath/resources/assets/logo/tetrain_logo_2x.png",
	"icon" => "$wgResourceBasePath/resources/assets/logo/tetrain_logo_1x.png",
];
</nowiki>
</pre>

<pre>
<nowiki>
php maintenance/run.php purgeList   # or Special:Purge on the affected pages — clear the cached logo
</nowiki>
</pre>

'''Verify''': served logo image is genuinely 50×50px (checked via direct image fetch), no distortion.

----