Skip to content

Redesign website (GitHub Pages /docs), clean repo for public release, SEO + AI-engine optimization - #323

Merged
Luxshan2000 merged 4 commits into
mainfrom
website/redesign-and-pages
Jun 18, 2026
Merged

Luxshan2000 merged 4 commits into
mainfrom
website/redesign-and-pages

Conversation

@Luxshan2000

Copy link
Copy Markdown
Collaborator

Prepares KuralHub for its public release (paper to appear at Interspeech 2026): a redesigned, minimal, documentation-style website served via GitHub Pages from /docs, repo hygiene, and deep SEO + AI/agent-engine optimization.

Website (new docs/, Pages from /docs)

  • Full redesign in a minimal, professional documentation theme — neutral palette, single restrained accent, low motion (replaces the old generic ui/ site).
  • Home: hero, about, methodology, key-findings gallery, researcher profile cards (photo slots + initials fallback; email/LinkedIn/Scholar), FAQ, copyable BibTeX.
  • Benchmark: static "best model per language" summary + interactive results (filter by family/model) — 363 runs.
  • Datasets: searchable catalog of all 70 languages, markdown rendered from a self-contained same-origin mirror; ?q= / ?lang= deep links.
  • Minimal favicon + generated OG image.

SEO + AI / agent engine optimization (GEO/AEO)

  • Static, crawlable content pre-rendered via scripts/build_site.py (bots that don't run JS now see the full catalog, benchmark summary, and FAQ).
  • Structured data (JSON-LD): Dataset + ItemList of all 90+ datasets (Google Dataset Search), FAQPage, WebSite+SearchAction, Organization, CollectionPage, BreadcrumbList, ScholarlyArticle.
  • llms.txt / llms-full.txt for LLM/agent discovery.
  • robots.txt explicitly welcomes AI crawlers (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, …) + search bots; sitemap.xml.

Repo hygiene

  • README: Interspeech 2026 (to appear) badges/citation, removed placeholder Scholar/arXiv links, affiliation note, accurate stats. LICENSE → 2026.
  • Moved research artifacts out of ui/: ui/train_val_test_logs → results/, ui/benchmark.json → results/; updated generate_benchmark.py and run_training.py paths; make run_ui serves docs/.
  • Removed the old ui/ website folder (replaced by docs/).
  • scripts/sync-datasets.sh + scripts/build_site.py regenerate the self-contained site data.
  • datasets/ content was left untouched (maintained manually).

Go-live (after merge)

  1. Make the repo public, then Settings → Pages → branch main, folder /docs.
  2. Add researcher photos to docs/assets/profiles/ (see README there).
  3. Submit sitemap.xml to Google Search Console / Bing; add backlinks (paper, repo website field, Papers with Code, Hugging Face).
  4. Once published, replace the "To appear" citation/badge with the final DOI and add real Scholar links (TEAM array in docs/index.html).

Verified locally in headless Chrome: all pages render, all assets 200, all JSON-LD valid.

🤖 Generated with Claude Code

Luxshan2000 and others added 4 commits June 4, 2026 06:04
…elease

Website (new docs/, GitHub Pages from /docs):
- Full redesign: distinctive scholarly UI with custom design system
  (replaces the old generic Tailwind-CDN site in ui/)
- index: hero, about, methodology, key-findings gallery, researcher
  profile cards (photo slots + initials fallback, email/LinkedIn/Scholar),
  copyable BibTeX citation
- benchmark: interactive results (filter by family/model), 363 runs
- datasets: searchable catalog of all 70 languages, markdown rendered
  from a self-contained same-origin mirror (docs/datasets/)
- SEO: per-page titles/descriptions, canonical, Open Graph + Twitter
  cards, JSON-LD (Dataset + ScholarlyArticle), sitemap.xml, robots.txt,
  favicon, generated OG image
- Add Kazakh + Quechua to language_families.json (were unmapped)

Repo hygiene:
- README: Interspeech 2026 (to appear) badges/citation, fix placeholder
  Scholar links, affiliation note, accurate coverage stats
- LICENSE year -> 2026
- Move research artifacts out of ui/: ui/train_val_test_logs -> results/,
  ui/benchmark.json -> results/; update generate_benchmark.py and
  run_training.py paths; Makefile run_ui serves docs/
- Remove old ui/ website folder (replaced by docs/)
- Add scripts/sync-datasets.sh + build_languages_manifest.py to
  regenerate the self-contained site data

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- Replace colorful gradient/emotion-spectrum theme with a calm neutral
  palette (white/grays) and a single restrained blue accent
- Light hero (was dark gradient); remove decorative waveform + dotted overlay
- Cut hover effects: no card/figure/person lift or heavy shadows; rely on
  borders and subtle background changes; low-motion reveal (opacity only)
- Bordered, organized cards/tables; crisper radii; lighter footer & page
  headers; light citation code block; neutral initials avatars
- Fix sub-page eyebrow colors for the light headers; drop non-functional
  sticky toolbar; correct datasets intro copy

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Make content crawlable by bots that don't run JS, and richly structured:
- Pre-render static content via scripts/build_site.py: 70-language catalog
  into datasets.html and a "best model per language" table into benchmark.html
  (JS now only enhances pre-rendered content)
- Structured data (JSON-LD): Dataset + ItemList of all 90+ datasets (Google
  Dataset Search), FAQPage, WebSite + SearchAction, Organization,
  CollectionPage, BreadcrumbList, ScholarlyArticle
- llms.txt + llms-full.txt for LLM/agent discovery (llmstxt.org)
- robots.txt explicitly welcomes AI crawlers (GPTBot, ClaudeBot,
  PerplexityBot, Google-Extended, CCBot, …) + search bots; links sitemap
- Visible FAQ section targeting common SER/dataset queries
- Enhanced robots meta (max-image-preview:large), ?q= / ?lang= deep links
- Minimal favicon + OG image (drop old gradient); theme-color -> neutral
- Replace build_languages_manifest.py with build_site.py; sync script + docs
  README updated with SEO/AEO notes and an off-page go-live checklist

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@Luxshan2000
Luxshan2000 merged commit 281c16e into main Jun 18, 2026
@Luxshan2000
Luxshan2000 deleted the website/redesign-and-pages branch June 18, 2026 15:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant