diff --git a/.github/assets/banner-dark.svg b/.github/assets/banner-dark.svg
index e3af6417f..7c084ceec 100644
--- a/.github/assets/banner-dark.svg
+++ b/.github/assets/banner-dark.svg
@@ -1 +1 @@
-
+
diff --git a/.github/assets/banner-light.svg b/.github/assets/banner-light.svg
index d8e1c521c..1693b03a6 100644
--- a/.github/assets/banner-light.svg
+++ b/.github/assets/banner-light.svg
@@ -1 +1 @@
-
+
diff --git a/.github/assets/favicon.png b/.github/assets/favicon.png
index 309c48ec6..e869124c6 100644
Binary files a/.github/assets/favicon.png and b/.github/assets/favicon.png differ
diff --git a/.github/assets/logo.png b/.github/assets/logo.png
index 244558a2c..718ff2987 100644
Binary files a/.github/assets/logo.png and b/.github/assets/logo.png differ
diff --git a/.github/assets/logo.svg b/.github/assets/logo.svg
new file mode 100644
index 000000000..a78d5fb39
--- /dev/null
+++ b/.github/assets/logo.svg
@@ -0,0 +1 @@
+
diff --git a/.github/assets/social-preview.png b/.github/assets/social-preview.png
index 2908a0ada..680b1be2d 100644
Binary files a/.github/assets/social-preview.png and b/.github/assets/social-preview.png differ
diff --git a/docs_assets/og/contribute.png b/docs_assets/og/contribute.png
index 88a40b47d..e018caabe 100644
Binary files a/docs_assets/og/contribute.png and b/docs_assets/og/contribute.png differ
diff --git a/docs_assets/og/explore.png b/docs_assets/og/explore.png
index 7e4c409de..b5ff9a8f4 100644
Binary files a/docs_assets/og/explore.png and b/docs_assets/og/explore.png differ
diff --git a/docs_assets/og/home.png b/docs_assets/og/home.png
index a10a74f97..f532edf25 100644
Binary files a/docs_assets/og/home.png and b/docs_assets/og/home.png differ
diff --git a/docs_assets/og/platforms/amberelec.png b/docs_assets/og/platforms/amberelec.png
index 072bbf59a..4c0effb7a 100644
Binary files a/docs_assets/og/platforms/amberelec.png and b/docs_assets/og/platforms/amberelec.png differ
diff --git a/docs_assets/og/platforms/batocera.png b/docs_assets/og/platforms/batocera.png
index 78a0712b8..5c9860e40 100644
Binary files a/docs_assets/og/platforms/batocera.png and b/docs_assets/og/platforms/batocera.png differ
diff --git a/docs_assets/og/platforms/bizhawk.png b/docs_assets/og/platforms/bizhawk.png
index 1a4e9a921..3812d54ac 100644
Binary files a/docs_assets/og/platforms/bizhawk.png and b/docs_assets/og/platforms/bizhawk.png differ
diff --git a/docs_assets/og/platforms/emudeck.png b/docs_assets/og/platforms/emudeck.png
index 0664e9aa8..fbce9331c 100644
Binary files a/docs_assets/og/platforms/emudeck.png and b/docs_assets/og/platforms/emudeck.png differ
diff --git a/docs_assets/og/platforms/emuelec.png b/docs_assets/og/platforms/emuelec.png
index 0c11d700d..46cfcbef6 100644
Binary files a/docs_assets/og/platforms/emuelec.png and b/docs_assets/og/platforms/emuelec.png differ
diff --git a/docs_assets/og/platforms/knulli.png b/docs_assets/og/platforms/knulli.png
index 45815db45..b4929957b 100644
Binary files a/docs_assets/og/platforms/knulli.png and b/docs_assets/og/platforms/knulli.png differ
diff --git a/docs_assets/og/platforms/lakka.png b/docs_assets/og/platforms/lakka.png
index 5eb4050cc..0b00d0bc1 100644
Binary files a/docs_assets/og/platforms/lakka.png and b/docs_assets/og/platforms/lakka.png differ
diff --git a/docs_assets/og/platforms/minui.png b/docs_assets/og/platforms/minui.png
index 21cd1eaeb..5c46e7c09 100644
Binary files a/docs_assets/og/platforms/minui.png and b/docs_assets/og/platforms/minui.png differ
diff --git a/docs_assets/og/platforms/misterfpga.png b/docs_assets/og/platforms/misterfpga.png
index 32cfc9873..df2a16640 100644
Binary files a/docs_assets/og/platforms/misterfpga.png and b/docs_assets/og/platforms/misterfpga.png differ
diff --git a/docs_assets/og/platforms/myminui.png b/docs_assets/og/platforms/myminui.png
index bc3b00131..349da32d8 100644
Binary files a/docs_assets/og/platforms/myminui.png and b/docs_assets/og/platforms/myminui.png differ
diff --git a/docs_assets/og/platforms/nextui.png b/docs_assets/og/platforms/nextui.png
index a32a1e051..95c6ede47 100644
Binary files a/docs_assets/og/platforms/nextui.png and b/docs_assets/og/platforms/nextui.png differ
diff --git a/docs_assets/og/platforms/recalbox.png b/docs_assets/og/platforms/recalbox.png
index 43822f16f..c56e5c3ee 100644
Binary files a/docs_assets/og/platforms/recalbox.png and b/docs_assets/og/platforms/recalbox.png differ
diff --git a/docs_assets/og/platforms/retroarch.png b/docs_assets/og/platforms/retroarch.png
index 1d22e15c8..21ec722a4 100644
Binary files a/docs_assets/og/platforms/retroarch.png and b/docs_assets/og/platforms/retroarch.png differ
diff --git a/docs_assets/og/platforms/retrobat.png b/docs_assets/og/platforms/retrobat.png
index 2bb5a8dcf..57835e7a2 100644
Binary files a/docs_assets/og/platforms/retrobat.png and b/docs_assets/og/platforms/retrobat.png differ
diff --git a/docs_assets/og/platforms/retrodeck.png b/docs_assets/og/platforms/retrodeck.png
index bdf6818b9..51d23bcfb 100644
Binary files a/docs_assets/og/platforms/retrodeck.png and b/docs_assets/og/platforms/retrodeck.png differ
diff --git a/docs_assets/og/platforms/retropie.png b/docs_assets/og/platforms/retropie.png
index 901a3e88c..c56f72b90 100644
Binary files a/docs_assets/og/platforms/retropie.png and b/docs_assets/og/platforms/retropie.png differ
diff --git a/docs_assets/og/platforms/rocknix.png b/docs_assets/og/platforms/rocknix.png
index 6a09bd19a..18ea95873 100644
Binary files a/docs_assets/og/platforms/rocknix.png and b/docs_assets/og/platforms/rocknix.png differ
diff --git a/docs_assets/og/platforms/romm.png b/docs_assets/og/platforms/romm.png
index 786b0239d..6254d1273 100644
Binary files a/docs_assets/og/platforms/romm.png and b/docs_assets/og/platforms/romm.png differ
diff --git a/docs_assets/og/reference.png b/docs_assets/og/reference.png
index fc688a7a7..b373cae3a 100644
Binary files a/docs_assets/og/reference.png and b/docs_assets/og/reference.png differ
diff --git a/docs_assets/og/setup.png b/docs_assets/og/setup.png
index 84bd6f810..c7eace936 100644
Binary files a/docs_assets/og/setup.png and b/docs_assets/og/setup.png differ
diff --git a/docs_assets/og/start.png b/docs_assets/og/start.png
index 152452309..df02182ff 100644
Binary files a/docs_assets/og/start.png and b/docs_assets/og/start.png differ
diff --git a/docs_assets/og/systems/3d-realms.png b/docs_assets/og/systems/3d-realms.png
index 6c1aceab2..2c165f3cc 100644
Binary files a/docs_assets/og/systems/3d-realms.png and b/docs_assets/og/systems/3d-realms.png differ
diff --git a/docs_assets/og/systems/3do-company.png b/docs_assets/og/systems/3do-company.png
index ecef1826b..578da5ed8 100644
Binary files a/docs_assets/og/systems/3do-company.png and b/docs_assets/og/systems/3do-company.png differ
diff --git a/docs_assets/og/systems/acorn.png b/docs_assets/og/systems/acorn.png
index afe851b18..54c636947 100644
Binary files a/docs_assets/og/systems/acorn.png and b/docs_assets/og/systems/acorn.png differ
diff --git a/docs_assets/og/systems/amstrad.png b/docs_assets/og/systems/amstrad.png
index cd840f30a..c86855c0f 100644
Binary files a/docs_assets/og/systems/amstrad.png and b/docs_assets/og/systems/amstrad.png differ
diff --git a/docs_assets/og/systems/apf.png b/docs_assets/og/systems/apf.png
index b9e5cda5b..d0a45c30a 100644
Binary files a/docs_assets/og/systems/apf.png and b/docs_assets/og/systems/apf.png differ
diff --git a/docs_assets/og/systems/apogee.png b/docs_assets/og/systems/apogee.png
index 5df63ae90..c3f561a75 100644
Binary files a/docs_assets/og/systems/apogee.png and b/docs_assets/og/systems/apogee.png differ
diff --git a/docs_assets/og/systems/apple.png b/docs_assets/og/systems/apple.png
index 8d457c4e8..5ceda23a3 100644
Binary files a/docs_assets/og/systems/apple.png and b/docs_assets/og/systems/apple.png differ
diff --git a/docs_assets/og/systems/aquaplus.png b/docs_assets/og/systems/aquaplus.png
index eee80780f..0339bc7f4 100644
Binary files a/docs_assets/og/systems/aquaplus.png and b/docs_assets/og/systems/aquaplus.png differ
diff --git a/docs_assets/og/systems/arcade.png b/docs_assets/og/systems/arcade.png
index a7ce05be6..cbcee825b 100644
Binary files a/docs_assets/og/systems/arcade.png and b/docs_assets/og/systems/arcade.png differ
diff --git a/docs_assets/og/systems/atari.png b/docs_assets/og/systems/atari.png
index 0b4765995..79d26c86e 100644
Binary files a/docs_assets/og/systems/atari.png and b/docs_assets/og/systems/atari.png differ
diff --git a/docs_assets/og/systems/bally.png b/docs_assets/og/systems/bally.png
index 4919a8259..57bc2818e 100644
Binary files a/docs_assets/og/systems/bally.png and b/docs_assets/og/systems/bally.png differ
diff --git a/docs_assets/og/systems/bandai.png b/docs_assets/og/systems/bandai.png
index 30afff098..8016e0d8d 100644
Binary files a/docs_assets/og/systems/bandai.png and b/docs_assets/og/systems/bandai.png differ
diff --git a/docs_assets/og/systems/bbk.png b/docs_assets/og/systems/bbk.png
index 89c1eb9f2..9bc66c27b 100644
Binary files a/docs_assets/og/systems/bbk.png and b/docs_assets/og/systems/bbk.png differ
diff --git a/docs_assets/og/systems/bit-corporation.png b/docs_assets/og/systems/bit-corporation.png
index 981aa7300..7ca7620bd 100644
Binary files a/docs_assets/og/systems/bit-corporation.png and b/docs_assets/og/systems/bit-corporation.png differ
diff --git a/docs_assets/og/systems/blizzard.png b/docs_assets/og/systems/blizzard.png
index d377eb92f..57921e303 100644
Binary files a/docs_assets/og/systems/blizzard.png and b/docs_assets/og/systems/blizzard.png differ
diff --git a/docs_assets/og/systems/bungie.png b/docs_assets/og/systems/bungie.png
index f8365bd27..3f6c21676 100644
Binary files a/docs_assets/og/systems/bungie.png and b/docs_assets/og/systems/bungie.png differ
diff --git a/docs_assets/og/systems/camputers.png b/docs_assets/og/systems/camputers.png
index 0a760df24..61d544f85 100644
Binary files a/docs_assets/og/systems/camputers.png and b/docs_assets/og/systems/camputers.png differ
diff --git a/docs_assets/og/systems/casio.png b/docs_assets/og/systems/casio.png
index 4c762962e..addf2c04c 100644
Binary files a/docs_assets/og/systems/casio.png and b/docs_assets/og/systems/casio.png differ
diff --git a/docs_assets/og/systems/coleco.png b/docs_assets/og/systems/coleco.png
index a02a40402..ba9893e64 100644
Binary files a/docs_assets/og/systems/coleco.png and b/docs_assets/og/systems/coleco.png differ
diff --git a/docs_assets/og/systems/commodore.png b/docs_assets/og/systems/commodore.png
index e915c6482..8eb9dfef8 100644
Binary files a/docs_assets/og/systems/commodore.png and b/docs_assets/og/systems/commodore.png differ
diff --git a/docs_assets/og/systems/dinothawr.png b/docs_assets/og/systems/dinothawr.png
index cd585ee3f..8d5ab49ef 100644
Binary files a/docs_assets/og/systems/dinothawr.png and b/docs_assets/og/systems/dinothawr.png differ
diff --git a/docs_assets/og/systems/dos.png b/docs_assets/og/systems/dos.png
index 62b39c535..db0efe6bc 100644
Binary files a/docs_assets/og/systems/dos.png and b/docs_assets/og/systems/dos.png differ
diff --git a/docs_assets/og/systems/dragon.png b/docs_assets/og/systems/dragon.png
index d1bf13e10..ae7018c7a 100644
Binary files a/docs_assets/og/systems/dragon.png and b/docs_assets/og/systems/dragon.png differ
diff --git a/docs_assets/og/systems/eaca.png b/docs_assets/og/systems/eaca.png
index c740fb1fa..f317b5c1c 100644
Binary files a/docs_assets/og/systems/eaca.png and b/docs_assets/og/systems/eaca.png differ
diff --git a/docs_assets/og/systems/electronic-arts.png b/docs_assets/og/systems/electronic-arts.png
index 52cfc6a44..af0b726e1 100644
Binary files a/docs_assets/og/systems/electronic-arts.png and b/docs_assets/og/systems/electronic-arts.png differ
diff --git a/docs_assets/og/systems/elektronika.png b/docs_assets/og/systems/elektronika.png
index dad9570e6..eb864ad65 100644
Binary files a/docs_assets/og/systems/elektronika.png and b/docs_assets/og/systems/elektronika.png differ
diff --git a/docs_assets/og/systems/enterprise.png b/docs_assets/og/systems/enterprise.png
index 6cef95a27..f5ddd889a 100644
Binary files a/docs_assets/og/systems/enterprise.png and b/docs_assets/og/systems/enterprise.png differ
diff --git a/docs_assets/og/systems/entex.png b/docs_assets/og/systems/entex.png
index f915662bb..a2aa7c255 100644
Binary files a/docs_assets/og/systems/entex.png and b/docs_assets/og/systems/entex.png differ
diff --git a/docs_assets/og/systems/epic-megagames.png b/docs_assets/og/systems/epic-megagames.png
index 2313133cb..1e2c4399f 100644
Binary files a/docs_assets/og/systems/epic-megagames.png and b/docs_assets/og/systems/epic-megagames.png differ
diff --git a/docs_assets/og/systems/epoch.png b/docs_assets/og/systems/epoch.png
index 23afa089c..0dfb80d60 100644
Binary files a/docs_assets/og/systems/epoch.png and b/docs_assets/og/systems/epoch.png differ
diff --git a/docs_assets/og/systems/fairchild.png b/docs_assets/og/systems/fairchild.png
index f9f5c7edb..a1cf0cde9 100644
Binary files a/docs_assets/og/systems/fairchild.png and b/docs_assets/og/systems/fairchild.png differ
diff --git a/docs_assets/og/systems/fujitsu.png b/docs_assets/og/systems/fujitsu.png
index 25b56c795..b82450756 100644
Binary files a/docs_assets/og/systems/fujitsu.png and b/docs_assets/og/systems/fujitsu.png differ
diff --git a/docs_assets/og/systems/funtech.png b/docs_assets/og/systems/funtech.png
index eacddf034..5360bdb9f 100644
Binary files a/docs_assets/og/systems/funtech.png and b/docs_assets/og/systems/funtech.png differ
diff --git a/docs_assets/og/systems/galaksija.png b/docs_assets/og/systems/galaksija.png
index d8df0625d..12ec56078 100644
Binary files a/docs_assets/og/systems/galaksija.png and b/docs_assets/og/systems/galaksija.png differ
diff --git a/docs_assets/og/systems/game-engines.png b/docs_assets/og/systems/game-engines.png
index 0057af6f2..6f6912372 100644
Binary files a/docs_assets/og/systems/game-engines.png and b/docs_assets/og/systems/game-engines.png differ
diff --git a/docs_assets/og/systems/gamepark.png b/docs_assets/og/systems/gamepark.png
index 4ac6d2291..591a72c70 100644
Binary files a/docs_assets/og/systems/gamepark.png and b/docs_assets/og/systems/gamepark.png differ
diff --git a/docs_assets/og/systems/gce.png b/docs_assets/og/systems/gce.png
index 0966094dc..8c0a5dad8 100644
Binary files a/docs_assets/og/systems/gce.png and b/docs_assets/og/systems/gce.png differ
diff --git a/docs_assets/og/systems/gemei.png b/docs_assets/og/systems/gemei.png
index 0bb90ffa4..859c99413 100644
Binary files a/docs_assets/og/systems/gemei.png and b/docs_assets/og/systems/gemei.png differ
diff --git a/docs_assets/og/systems/grundy.png b/docs_assets/og/systems/grundy.png
index 274f9e7a4..334e5aa91 100644
Binary files a/docs_assets/og/systems/grundy.png and b/docs_assets/og/systems/grundy.png differ
diff --git a/docs_assets/og/systems/hartung.png b/docs_assets/og/systems/hartung.png
index dbd41c890..3844a3ac6 100644
Binary files a/docs_assets/og/systems/hartung.png and b/docs_assets/og/systems/hartung.png differ
diff --git a/docs_assets/og/systems/ibm.png b/docs_assets/og/systems/ibm.png
index bb9031884..70332e15a 100644
Binary files a/docs_assets/og/systems/ibm.png and b/docs_assets/og/systems/ibm.png differ
diff --git a/docs_assets/og/systems/id-software.png b/docs_assets/og/systems/id-software.png
index 9637c8568..ba4c36d37 100644
Binary files a/docs_assets/og/systems/id-software.png and b/docs_assets/og/systems/id-software.png differ
diff --git a/docs_assets/og/systems/infocom.png b/docs_assets/og/systems/infocom.png
index c396c370c..59a31623b 100644
Binary files a/docs_assets/og/systems/infocom.png and b/docs_assets/og/systems/infocom.png differ
diff --git a/docs_assets/og/systems/interact.png b/docs_assets/og/systems/interact.png
index 0a15665b6..1a320c877 100644
Binary files a/docs_assets/og/systems/interact.png and b/docs_assets/og/systems/interact.png differ
diff --git a/docs_assets/og/systems/interplay.png b/docs_assets/og/systems/interplay.png
index 3da0c569f..f32c9723c 100644
Binary files a/docs_assets/og/systems/interplay.png and b/docs_assets/og/systems/interplay.png differ
diff --git a/docs_assets/og/systems/java.png b/docs_assets/og/systems/java.png
index e5311cf36..17e409e62 100644
Binary files a/docs_assets/og/systems/java.png and b/docs_assets/og/systems/java.png differ
diff --git a/docs_assets/og/systems/lexaloffle.png b/docs_assets/og/systems/lexaloffle.png
index e3fddd5d6..899331413 100644
Binary files a/docs_assets/og/systems/lexaloffle.png and b/docs_assets/og/systems/lexaloffle.png differ
diff --git a/docs_assets/og/systems/magnavox.png b/docs_assets/og/systems/magnavox.png
index 0f267f77d..bb2543d9b 100644
Binary files a/docs_assets/og/systems/magnavox.png and b/docs_assets/og/systems/magnavox.png differ
diff --git a/docs_assets/og/systems/mattel.png b/docs_assets/og/systems/mattel.png
index 81943eeac..918d4ec27 100644
Binary files a/docs_assets/og/systems/mattel.png and b/docs_assets/og/systems/mattel.png differ
diff --git a/docs_assets/og/systems/microsoft.png b/docs_assets/og/systems/microsoft.png
index 165a80dc9..f2772d0b3 100644
Binary files a/docs_assets/og/systems/microsoft.png and b/docs_assets/og/systems/microsoft.png differ
diff --git a/docs_assets/og/systems/monolith.png b/docs_assets/og/systems/monolith.png
index 511ad4997..bc142ef32 100644
Binary files a/docs_assets/og/systems/monolith.png and b/docs_assets/og/systems/monolith.png differ
diff --git a/docs_assets/og/systems/nec.png b/docs_assets/og/systems/nec.png
index e1545ed1f..06228b19b 100644
Binary files a/docs_assets/og/systems/nec.png and b/docs_assets/og/systems/nec.png differ
diff --git a/docs_assets/og/systems/nintendo.png b/docs_assets/og/systems/nintendo.png
index 84f91f054..dbf3ab6bf 100644
Binary files a/docs_assets/og/systems/nintendo.png and b/docs_assets/og/systems/nintendo.png differ
diff --git a/docs_assets/og/systems/nokia.png b/docs_assets/og/systems/nokia.png
index 5b01c37f5..25fc41491 100644
Binary files a/docs_assets/og/systems/nokia.png and b/docs_assets/og/systems/nokia.png differ
diff --git a/docs_assets/og/systems/oric.png b/docs_assets/og/systems/oric.png
deleted file mode 100644
index 2a0051a70..000000000
Binary files a/docs_assets/og/systems/oric.png and /dev/null differ
diff --git a/docs_assets/og/systems/other.png b/docs_assets/og/systems/other.png
index b79cbff94..1507e45c8 100644
Binary files a/docs_assets/og/systems/other.png and b/docs_assets/og/systems/other.png differ
diff --git a/docs_assets/og/systems/palm.png b/docs_assets/og/systems/palm.png
index e599dce17..4d55cd8b7 100644
Binary files a/docs_assets/og/systems/palm.png and b/docs_assets/og/systems/palm.png differ
diff --git a/docs_assets/og/systems/pc.png b/docs_assets/og/systems/pc.png
index 0e9d3cdb4..985e9fb87 100644
Binary files a/docs_assets/og/systems/pc.png and b/docs_assets/og/systems/pc.png differ
diff --git a/docs_assets/og/systems/philips.png b/docs_assets/og/systems/philips.png
index 696c545cc..6a6a0e1b3 100644
Binary files a/docs_assets/og/systems/philips.png and b/docs_assets/og/systems/philips.png differ
diff --git a/docs_assets/og/systems/pioneer.png b/docs_assets/og/systems/pioneer.png
index 51530fce6..e1da0590b 100644
Binary files a/docs_assets/og/systems/pioneer.png and b/docs_assets/og/systems/pioneer.png differ
diff --git a/docs_assets/og/systems/qemu.png b/docs_assets/og/systems/qemu.png
index 0b6a6421d..0a5151e1f 100644
Binary files a/docs_assets/og/systems/qemu.png and b/docs_assets/og/systems/qemu.png differ
diff --git a/docs_assets/og/systems/rca.png b/docs_assets/og/systems/rca.png
index 53245404e..f77200353 100644
Binary files a/docs_assets/og/systems/rca.png and b/docs_assets/og/systems/rca.png differ
diff --git a/docs_assets/og/systems/real3d.png b/docs_assets/og/systems/real3d.png
index 84d00566d..713e02756 100644
Binary files a/docs_assets/og/systems/real3d.png and b/docs_assets/og/systems/real3d.png differ
diff --git a/docs_assets/og/systems/roland.png b/docs_assets/og/systems/roland.png
index 874c5f8c2..66374d211 100644
Binary files a/docs_assets/og/systems/roland.png and b/docs_assets/og/systems/roland.png differ
diff --git a/docs_assets/og/systems/rpg-maker.png b/docs_assets/og/systems/rpg-maker.png
index a2ea0855a..5d18684d9 100644
Binary files a/docs_assets/og/systems/rpg-maker.png and b/docs_assets/og/systems/rpg-maker.png differ
diff --git a/docs_assets/og/systems/scummvm.png b/docs_assets/og/systems/scummvm.png
index 3da8bc4d2..fb8a1bdda 100644
Binary files a/docs_assets/og/systems/scummvm.png and b/docs_assets/og/systems/scummvm.png differ
diff --git a/docs_assets/og/systems/sdl.png b/docs_assets/og/systems/sdl.png
index 4dbae5287..a9915e287 100644
Binary files a/docs_assets/og/systems/sdl.png and b/docs_assets/og/systems/sdl.png differ
diff --git a/docs_assets/og/systems/sdlpal.png b/docs_assets/og/systems/sdlpal.png
index 8adc34283..e0f085fc7 100644
Binary files a/docs_assets/og/systems/sdlpal.png and b/docs_assets/og/systems/sdlpal.png differ
diff --git a/docs_assets/og/systems/sega.png b/docs_assets/og/systems/sega.png
index 3a39f179a..b7049560e 100644
Binary files a/docs_assets/og/systems/sega.png and b/docs_assets/og/systems/sega.png differ
diff --git a/docs_assets/og/systems/sharp.png b/docs_assets/og/systems/sharp.png
index c08efecf5..576d26657 100644
Binary files a/docs_assets/og/systems/sharp.png and b/docs_assets/og/systems/sharp.png differ
diff --git a/docs_assets/og/systems/sinclair.png b/docs_assets/og/systems/sinclair.png
index df0eb7d93..b09a5f26f 100644
Binary files a/docs_assets/og/systems/sinclair.png and b/docs_assets/og/systems/sinclair.png differ
diff --git a/docs_assets/og/systems/snk.png b/docs_assets/og/systems/snk.png
index 5292a8103..467a4e2c8 100644
Binary files a/docs_assets/og/systems/snk.png and b/docs_assets/og/systems/snk.png differ
diff --git a/docs_assets/og/systems/softdisk.png b/docs_assets/og/systems/softdisk.png
index 51bc943fa..35ffc9430 100644
Binary files a/docs_assets/og/systems/softdisk.png and b/docs_assets/og/systems/softdisk.png differ
diff --git a/docs_assets/og/systems/sony.png b/docs_assets/og/systems/sony.png
index feaa921f3..ec70f9004 100644
Binary files a/docs_assets/og/systems/sony.png and b/docs_assets/og/systems/sony.png differ
diff --git a/docs_assets/og/systems/sord.png b/docs_assets/og/systems/sord.png
index b49f9df51..899d38430 100644
Binary files a/docs_assets/og/systems/sord.png and b/docs_assets/og/systems/sord.png differ
diff --git a/docs_assets/og/systems/synertek.png b/docs_assets/og/systems/synertek.png
index fcca2471f..1eb97d62d 100644
Binary files a/docs_assets/og/systems/synertek.png and b/docs_assets/og/systems/synertek.png differ
diff --git a/docs_assets/og/systems/tandy.png b/docs_assets/og/systems/tandy.png
index c986751a9..cfcfd8ad9 100644
Binary files a/docs_assets/og/systems/tandy.png and b/docs_assets/og/systems/tandy.png differ
diff --git a/docs_assets/og/systems/tangerine.png b/docs_assets/og/systems/tangerine.png
index 9e8884026..12e2d1c3f 100644
Binary files a/docs_assets/og/systems/tangerine.png and b/docs_assets/og/systems/tangerine.png differ
diff --git a/docs_assets/og/systems/texas-instruments.png b/docs_assets/og/systems/texas-instruments.png
index daa259b06..a78aaa063 100644
Binary files a/docs_assets/og/systems/texas-instruments.png and b/docs_assets/og/systems/texas-instruments.png differ
diff --git a/docs_assets/og/systems/thomson.png b/docs_assets/og/systems/thomson.png
index 29b141872..aa9f58dd8 100644
Binary files a/docs_assets/og/systems/thomson.png and b/docs_assets/og/systems/thomson.png differ
diff --git a/docs_assets/og/systems/tiger.png b/docs_assets/og/systems/tiger.png
index 62f70520e..ea54ee9fa 100644
Binary files a/docs_assets/og/systems/tiger.png and b/docs_assets/og/systems/tiger.png differ
diff --git a/docs_assets/og/systems/timetop.png b/docs_assets/og/systems/timetop.png
index 278a4c139..f74cf0406 100644
Binary files a/docs_assets/og/systems/timetop.png and b/docs_assets/og/systems/timetop.png differ
diff --git a/docs_assets/og/systems/tomy.png b/docs_assets/og/systems/tomy.png
index 9ad202f65..ea354d259 100644
Binary files a/docs_assets/og/systems/tomy.png and b/docs_assets/og/systems/tomy.png differ
diff --git a/docs_assets/og/systems/toys-for-bob.png b/docs_assets/og/systems/toys-for-bob.png
index fbaa9a38a..9119224cf 100644
Binary files a/docs_assets/og/systems/toys-for-bob.png and b/docs_assets/og/systems/toys-for-bob.png differ
diff --git a/docs_assets/og/systems/valve.png b/docs_assets/og/systems/valve.png
index ce603ac50..8297a9550 100644
Binary files a/docs_assets/og/systems/valve.png and b/docs_assets/og/systems/valve.png differ
diff --git a/docs_assets/og/systems/videobrain.png b/docs_assets/og/systems/videobrain.png
index 8d1bbeb85..ffb5d7942 100644
Binary files a/docs_assets/og/systems/videobrain.png and b/docs_assets/og/systems/videobrain.png differ
diff --git a/docs_assets/og/systems/videoton.png b/docs_assets/og/systems/videoton.png
index 766f1e8fe..bb5572c7c 100644
Binary files a/docs_assets/og/systems/videoton.png and b/docs_assets/og/systems/videoton.png differ
diff --git a/docs_assets/og/systems/vircon.png b/docs_assets/og/systems/vircon.png
index 47695434c..52f556644 100644
Binary files a/docs_assets/og/systems/vircon.png and b/docs_assets/og/systems/vircon.png differ
diff --git a/docs_assets/og/systems/vtech.png b/docs_assets/og/systems/vtech.png
index 472d5a9e2..73b20ea8f 100644
Binary files a/docs_assets/og/systems/vtech.png and b/docs_assets/og/systems/vtech.png differ
diff --git a/docs_assets/og/systems/wenquxing.png b/docs_assets/og/systems/wenquxing.png
index d0956768b..e3c0413a6 100644
Binary files a/docs_assets/og/systems/wenquxing.png and b/docs_assets/og/systems/wenquxing.png differ
diff --git a/docs_assets/og/systems/zc.png b/docs_assets/og/systems/zc.png
index 6bbcff5d2..e34ffceb8 100644
Binary files a/docs_assets/og/systems/zc.png and b/docs_assets/og/systems/zc.png differ
diff --git a/scripts/make_og_cards.py b/scripts/make_og_cards.py
index 0dd0409ae..c0e4a7c84 100644
--- a/scripts/make_og_cards.py
+++ b/scripts/make_og_cards.py
@@ -30,7 +30,7 @@ from common import list_registered_platforms, load_platform_config # noqa: E402
from sitediagrams import OG_SECTIONS, og_card_svg, wrap # noqa: E402
OUT = ROOT / "docs_assets" / "og"
-LOGO = ROOT / ".github" / "assets" / "logo.png"
+LOGO = ROOT / "docs_assets" / "brand" / "logo.svg"
PLATFORM_TAGLINE = "Which BIOS files it needs, and where each one goes"
# The tagline's box on the card: og_card_svg wraps it at this width and
# size, and three lines fit above the address.
@@ -87,7 +87,7 @@ def system_cards() -> dict[str, tuple[str, str]]:
}
-def card_svg(key: str, logo: bytes, titles: dict[str, tuple[str, str]]) -> str:
+def card_svg(key: str, logo: str, titles: dict[str, tuple[str, str]]) -> str:
if key in OG_SECTIONS:
return og_card_svg(key, logo)
# A page card is a section card with the page's own title and tagline.
@@ -116,7 +116,7 @@ def main() -> None:
if args.only in (None, "systems"):
titles.update(system_cards())
keys = [*(OG_SECTIONS if args.only in (None, "sections") else []), *titles]
- logo = LOGO.read_bytes()
+ logo = LOGO.read_text(encoding="utf-8")
with sync_playwright() as playwright:
browser = playwright.chromium.launch()
page = browser.new_page(viewport={"width": 1200, "height": 630})
diff --git a/scripts/make_site_icons.py b/scripts/make_site_icons.py
index fbf94609a..bc58499f1 100644
--- a/scripts/make_site_icons.py
+++ b/scripts/make_site_icons.py
@@ -1,5 +1,5 @@
#!/usr/bin/env python3
-"""Write the site's own mark: header logo, favicon and touch icon.
+"""Write the project's mark: the site's icons and the repository's logos.
The mark is the chip of the project logo drawn as vector shapes: a body,
four pins per side and the pixel glyph on a 4 by 4 grid. Three variants:
@@ -14,6 +14,15 @@ four pins per side and the pixel glyph on a 4 by 4 grid. Three variants:
The files land in ``docs_assets/brand/``, which generate_site.py copies into
the site. The site build never runs this script.
+The repository's own images come from the same shapes, in ``.github/assets/``:
+
+- ``logo.svg`` and ``logo.png`` (256 px): the chip in colour, as the favicon.
+- ``favicon.png`` (32 px).
+- ``banner-light.svg`` and ``banner-dark.svg``: the mark and the name as the
+ site header shows them, for the README in each scheme.
+- ``social-preview.png`` (1280 by 640): the mark and the name in white on the
+ sharing cards' indigo, uploaded by hand in the repository settings.
+
python scripts/make_site_icons.py
"""
@@ -23,10 +32,18 @@ from pathlib import Path
ROOT = Path(__file__).resolve().parent.parent
OUT = ROOT / "docs_assets" / "brand"
+PROJECT = ROOT / ".github" / "assets"
HEADER = "#3b3f7a"
GLYPH = "#8be0f7"
GLYPH_DIM = "#4fa3c4"
+# The site title: the light scheme's accent, the dark scheme's accent.
+TITLE = {"light": "#273c8f", "dark": "#aebcff"}
+# The mark beside it: the header logo in each scheme (website/src/assets).
+MARK = {"light": HEADER, "dark": "#fff"}
+# The sharing cards' background (sitediagrams.og_card_svg).
+CARD = "#2b2e5c"
+FONT = "system-ui, -apple-system, 'Segoe UI', 'Noto Sans', Helvetica, Arial, sans-serif"
# (column, row, dim) on the 4 by 4 grid, read from the project logo.
PIXELS = [
@@ -76,13 +93,42 @@ def _body(fill: str, extra: str = "") -> str:
return f'