Skip to content

Add static site generator, responsive UI, Arabic i18n, and optional translation proxy#6

Open
K1SysAdmin wants to merge 2 commits into
mainfrom
codex/plan-ui-optimization-and-revision-5o6ysg
Open

Add static site generator, responsive UI, Arabic i18n, and optional translation proxy#6
K1SysAdmin wants to merge 2 commits into
mainfrom
codex/plan-ui-optimization-and-revision-5o6ysg

Conversation

@K1SysAdmin

Copy link
Copy Markdown
Contributor

Motivation

  • Provide a maintainable source-driven static site workflow and replace hand-edited /docs HTML with generated output and a simple Python-based build tool.
  • Add a modern responsive UI, language controls, and curated Arabic localization to support bilingual presentation and machine translation tooling.
  • Offer an optional serverless proxy pattern so machine-translation provider keys remain server-side and are not exposed to browser JavaScript.

Description

  • Add a dependency-free static site generator scripts/build_site.py plus a site manifest site/site_manifest.json and HTML template site/templates/page.html to render Markdown from source/quartz-content-vault into /docs.
  • Introduce a large UI refresh in docs/assets/site.css and interactive controls in docs/assets/site.js that implement theme switching, language switching (en/ar), audience pathway injection, and a machine-translation trigger using an optional proxy.
  • Add Arabic localization catalogs site/i18n/ar.json and docs/assets/i18n.ar.json, curated translated text, and several new content pages in source/quartz-content-vault plus updated FILE_INVENTORY.md and an expanded README_DEPLOY.md with build/deploy instructions.
  • Provide an optional serverless translation proxy example under serverless/translate-proxy/ including worker.js and README.md that demonstrates safely proxying translations to DeepL with CORS and basic payload handling.

Testing

  • Performed a local validation build using python3 scripts/build_site.py --clean which generated pages into docs/, produced docs/assets/search-index.json, and completed without errors.
  • Confirmed site.js boots controls on DOMContentLoaded and that theme/locale choices are persisted to localStorage during manual smoke testing in a browser.

Codex Task

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant