mirror of
https://github.com/kevinveenbirkenbach/homepage.veen.world.git
synced 2026-08-24 13:14:32 +00:00
The interface ships translated; page content stays English until a LibreTranslate instance fills app/i18n/content/ through make i18n. A string without a catalogue entry falls back to its English source, so a half-filled catalogue degrades instead of breaking. Translation runs after ConfigurationResolver.resolve_links(), on a copy. resolve_links matches by the `name` field, so translating it beforehand would break every `link:` reference in the configuration. negotiate() normalises to the primary subtag itself. Werkzeug's best_match returns an exact match before it considers a primary-tag fallback, so the Chrome default `de-DE,en;q=0.8` resolves to English there. "/" carries Vary: Accept-Language, without which a shared cache pins the first visitor's language for everyone. The route rule lists the known codes as a converter argument. A bare "/<lang>/" answers /robots.txt and /favicon.ico with a permanently cacheable 308 to their trailing-slash form. Templates gain lang, dir, the RTL stylesheet, a canonical URL and 30 hreflang alternates. Those are the first external URLs in this app: ProxyFix takes the scheme from X-Forwarded-Proto so they do not claim http:// behind a TLS-terminating proxy, X-Forwarded-Host stays untrusted because nginx passes a client-supplied one through, and TRUSTED_HOSTS lets Flask reject a forged Host outright. Flask only autoescapes .html/.htm/.xml/.xhtml/.svg, so every *.html.j2 template interpolated configuration raw. Enabling it changes two lines of the shipped page, both an apostrophe. read_catalog degrades an unreadable catalogue to English rather than serving a 500, and drops non-string entries that would otherwise render as "42". i18n_sync writes atomically, never overwrites an existing entry, refuses to touch a catalogue it could not parse, and leaves the file alone when a run translated nothing. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
76 lines
2.5 KiB
JavaScript
76 lines
2.5 KiB
JavaScript
'use strict';
|
||
/**
|
||
* Copies third-party browser assets from node_modules into static/vendor/
|
||
* so Flask can serve them without any CDN dependency.
|
||
* Runs automatically via the "postinstall" npm hook.
|
||
*/
|
||
const fs = require('fs');
|
||
const path = require('path');
|
||
|
||
const NM = path.join(__dirname, '..', 'node_modules');
|
||
const VENDOR = path.join(__dirname, '..', 'static', 'vendor');
|
||
|
||
function copyFile(src, dest) {
|
||
fs.mkdirSync(path.dirname(dest), { recursive: true });
|
||
fs.copyFileSync(src, dest);
|
||
}
|
||
|
||
function copyDir(src, dest) {
|
||
fs.mkdirSync(dest, { recursive: true });
|
||
for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
|
||
const s = path.join(src, entry.name);
|
||
const d = path.join(dest, entry.name);
|
||
entry.isDirectory() ? copyDir(s, d) : fs.copyFileSync(s, d);
|
||
}
|
||
}
|
||
|
||
// Bootstrap CSS + JS bundle
|
||
copyFile(
|
||
path.join(NM, 'bootstrap', 'dist', 'css', 'bootstrap.min.css'),
|
||
path.join(VENDOR, 'bootstrap', 'css', 'bootstrap.min.css')
|
||
);
|
||
copyFile(
|
||
path.join(NM, 'bootstrap', 'dist', 'css', 'bootstrap.rtl.min.css'),
|
||
path.join(VENDOR, 'bootstrap', 'css', 'bootstrap.rtl.min.css')
|
||
);
|
||
copyFile(
|
||
path.join(NM, 'bootstrap', 'dist', 'js', 'bootstrap.bundle.min.js'),
|
||
path.join(VENDOR, 'bootstrap', 'js', 'bootstrap.bundle.min.js')
|
||
);
|
||
|
||
// Bootstrap Icons CSS + embedded fonts
|
||
copyFile(
|
||
path.join(NM, 'bootstrap-icons', 'font', 'bootstrap-icons.css'),
|
||
path.join(VENDOR, 'bootstrap-icons', 'font', 'bootstrap-icons.css')
|
||
);
|
||
copyDir(
|
||
path.join(NM, 'bootstrap-icons', 'font', 'fonts'),
|
||
path.join(VENDOR, 'bootstrap-icons', 'font', 'fonts')
|
||
);
|
||
|
||
// Font Awesome Free CSS + webfonts
|
||
copyFile(
|
||
path.join(NM, '@fortawesome', 'fontawesome-free', 'css', 'all.min.css'),
|
||
path.join(VENDOR, 'fontawesome', 'css', 'all.min.css')
|
||
);
|
||
copyDir(
|
||
path.join(NM, '@fortawesome', 'fontawesome-free', 'webfonts'),
|
||
path.join(VENDOR, 'fontawesome', 'webfonts')
|
||
);
|
||
|
||
// marked – browser UMD build (path varies by version)
|
||
const markedCandidates = [
|
||
path.join(NM, 'marked', 'marked.min.js'), // v4.x
|
||
path.join(NM, 'marked', 'lib', 'marked.umd.min.js'), // v5.x
|
||
path.join(NM, 'marked', 'dist', 'marked.min.js'), // v9+
|
||
];
|
||
const markedSrc = markedCandidates.find(p => fs.existsSync(p));
|
||
if (!markedSrc) throw new Error('marked: no browser UMD build found in node_modules');
|
||
copyFile(markedSrc, path.join(VENDOR, 'marked', 'marked.min.js'));
|
||
|
||
// jQuery
|
||
copyFile(
|
||
path.join(NM, 'jquery', 'dist', 'jquery.min.js'),
|
||
path.join(VENDOR, 'jquery', 'jquery.min.js')
|
||
);
|