atheos-blog-lxc/scripts/fix-panel-layout.sh

#!/bin/sh
# Re-apply the UI/layout fixes to a rebuilt or updated Atheos tree.
#
# Why this exists: Atheos has no releases and `scripts/update-atheos.sh` replaces the whole
# application directory, so any local patch is lost on update. These are the two that were
# needed to make the editor usable. Both are IDEMPOTENT - run it as often as you like.
#
#   1. panel { height: 500px }      ->  height:auto; max-height:58vh
#      Every modal panel was forced to a fixed 500px box, so dialogs with short content showed
#      a large empty black region and anything after the panel (codegit's "Branch:" toolbar)
#      was pushed OUTSIDE the modal. See docs/known-issues.md §4.
#
#   2. nginx: Cache-Control: no-cache for *.css/*.js
#      Theme/bundle changes were invisible behind the browser cache. §5.
#
# Usage:  sh scripts/fix-panel-layout.sh          (run ON the guest, as root)
set -e

ATH=/var/www/atheos
CSS=$ATH/theme/main.min.css
SCSS=$ATH/theme/modules/common/_panel.scss
NGX=/etc/nginx/http.d/atheos.conf

echo "=== 1. panel layout ==="
OLD='height:500px;position:relative;border-left:var(--borderLight)'
NEW='height:auto;max-height:58vh;position:relative;border-left:var(--borderLight)'
if [ ! -f "$CSS" ]; then
  echo "  !! $CSS not found - is Atheos installed?"
elif grep -qF "$NEW" "$CSS"; then
  echo "  already applied"
elif grep -qF "$OLD" "$CSS"; then
  [ -f "$CSS.orig" ] || cp -a "$CSS" "$CSS.orig"
  php83 -r '$f=$argv[1];$o=$argv[2];$n=$argv[3];$s=file_get_contents($f);
            if(strpos($s,$o)===false){exit(1);} file_put_contents($f,str_replace($o,$n,$s));' "$CSS" "$OLD" "$NEW"
  echo "  applied to main.min.css"
else
  echo "  !! expected panel rule not found - inspect manually"
  echo "     (upstream may have changed it; diff against $CSS.orig)"
fi

# keep the SCSS source consistent so the shipped CSS is not contradicted by the source
if [ -f "$SCSS" ] && grep -q 'height: 500px;' "$SCSS"; then
  [ -f "$SCSS.orig" ] || cp -a "$SCSS" "$SCSS.orig"
  php83 -r '$f=$argv[1];$s=file_get_contents($f);
            $s=str_replace("height: 500px;","height: auto;\n\tmax-height: 58vh;",$s);
            file_put_contents($f,$s);' "$SCSS"
  echo "  synchronised _panel.scss"
fi

echo "=== 2. nginx cache headers ==="
if [ ! -f "$NGX" ]; then
  echo "  !! $NGX not found"
elif grep -q 'must-revalidate' "$NGX"; then
  echo "  already applied"
else
  [ -f "$NGX.orig" ] || cp -a "$NGX" "$NGX.orig"
  cat > /tmp/.cacheblock <<'EOF'

    # Atheos serves theme/main.min.css and the generated *.min.js/css bundles from STABLE URLs
    # with no cache headers, so a CSS/JS fix stays invisible behind the browser cache until a
    # hard refresh. "no-cache" permits caching but forces revalidation: normal loads still get a
    # cheap 304, and a change is guaranteed to be picked up on the next load.
    location ~* \.(css|js)$ {
        add_header Cache-Control "no-cache, must-revalidate";
        try_files $uri =404;
    }
EOF
  php83 -r '$f=$argv[1];$b=$argv[2];$s=file_get_contents($f);
            $p=strrpos($s,"}"); if($p===false){exit(1);}
            file_put_contents($f,substr($s,0,$p).file_get_contents($b).substr($s,$p));' "$NGX" /tmp/.cacheblock
  rm -f /tmp/.cacheblock
  nginx -t >/dev/null 2>&1 && rc-service nginx reload >/dev/null 2>&1 && echo "  applied + nginx reloaded" \
    || echo "  !! nginx -t failed - restore $NGX.orig"
fi

echo "=== 3. cache-busting versioned asset URLs ==="
# Atheos serves theme/main.min.css and the generated bundles from STABLE paths with no version:
#   <link rel="stylesheet" href="theme/main.min.css">
# A browser then keeps its cached copy across a change, so a CSS/JS fix appears not to work.
# Appending each file's mtime means a changed file gets a NEW url (fetched immediately) and an
# unchanged one keeps its url (stays cached). Better than headers alone: it also defeats a
# browser cache that was already poisoned before any header was set.
SM=$ATH/classes/sourcemanager.php
IX=$ATH/index.php
if grep -q 'filemtime($path)' "$SM" 2>/dev/null; then
  echo "  getTag already versioned"
else
  [ -f "$SM.orig" ] || cp -a "$SM" "$SM.orig"
  php83 -r '
$f=$argv[1]; $s=file_get_contents($f);
$old = "    function getTag(\$type, \$path) {\n        return \$type === \"css\" ? \"\\t<link rel=\\\"stylesheet\\\" href=\\\"\$path\\\">\\n\": \"\\t<script type=\\\"text/javascript\\\" src=\\\"\$path\\\"></script>\\n\";\n    }";
if (strpos($s,$old) === false) { fwrite(STDERR, "  !! getTag signature changed - inspect $f\n"); exit(1); }
$new = "    function getTag(\$type, \$path) {\n        // Version the URL by mtime so a changed asset is fetched immediately instead of being\n        // served from the browser cache (docs/known-issues.md §5).\n        if (file_exists(\$path)) {\n            \$path .= \"?v=\" . filemtime(\$path);\n        }\n        return \$type === \"css\" ? \"\\t<link rel=\\\"stylesheet\\\" href=\\\"\$path\\\">\\n\": \"\\t<script type=\\\"text/javascript\\\" src=\\\"\$path\\\"></script>\\n\";\n    }";
file_put_contents($f, str_replace($old,$new,$s)); echo "  versioned getTag\n";' "$SM"
  php83 -l "$SM" >/dev/null 2>&1 || echo "  !! SYNTAX ERROR in $SM - restore $SM.orig"
fi

if grep -q 'theme/main.min.css?v=' "$IX" 2>/dev/null; then
  echo "  index.php already versioned"
else
  [ -f "$IX.orig" ] || cp -a "$IX" "$IX.orig"
  php83 -r '
$f=$argv[1]; $s=file_get_contents($f);
$old = "    echo(\"\\t<link rel=\\\"stylesheet\\\" href=\\\"theme/main.min.css\\\">\\n\");";
if (strpos($s,$old) === false) { fwrite(STDERR, "  !! theme echo line changed - inspect $f\n"); exit(1); }
$new = "    // Version the theme URL by mtime; otherwise a browser keeps its cached copy across a\n    // theme change and the fix appears not to work (docs/known-issues.md §5).\n    \$themeV = file_exists(\"theme/main.min.css\") ? filemtime(\"theme/main.min.css\") : time();\n    echo(\"\\t<link rel=\\\"stylesheet\\\" href=\\\"theme/main.min.css?v=\$themeV\\\">\\n\");";
file_put_contents($f, str_replace($old,$new,$s)); echo "  versioned index.php theme link\n";' "$IX"
  php83 -l "$IX" >/dev/null 2>&1 || echo "  !! SYNTAX ERROR in $IX - restore $IX.orig"
fi

echo "=== done ==="