Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

French docs sidebar shows English section labels

Aperta
  • Qualcosa non va?
#1,793 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
58/100
Tipo di issue
Bug
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
typescript
Ambito
internationalization

Direzione di ricerca

Start with apps/outreach/astro.config.ts:71-102 and the Starlight typedoc sidebar options and group-building functions named in the issue. Build apps/outreach and inspect dist/fr/docs/introduction/home/index.html; done means the sidebar shows the expected French labels while English pages remain unchanged. There is no unit or Playwright suite for apps/outreach.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Area: Outreach Bug Difficulty: Low Good First Issue Priority: Low

On the French docs pages, the sidebar's section headings are in English: "Tutorials", "Reference", "Changelog" and "Runtime Core API". The sidebar groups in astro.config.ts set only label, with no translations, so Starlight shows the same string in every locale. The French home page names the same sections "Tutoriels" and "Référence", and every other piece of Starlight chrome on those pages is French ("Sur cette page", "Suivant"). A French reader sees the page call the section "Référence" while the sidebar beside it says "Reference". (The pages inside these sections are English-only by design, docs/AGENTS.md; this concerns only the navigation labels.)

Where

apps/outreach/astro.config.ts:79-102 (excerpt):

{
  autogenerate: { directory: 'docs/2-tutorials' },
  label: 'Tutorials'
},
...
{
  autogenerate: { directory: 'docs/5-reference' },
  label: 'Reference'
},
{
  label: 'Changelog',
  slug: 'docs/changelog'
},

and :71-74, the typedoc group:

sidebar: {
  collapsed: true,
  label: 'Runtime Core API'
},

docs/fr/1-introduction/1.0-home.md names them "Tutoriels (en anglais)" and "Référence (en anglais)".

Reproduce

  1. Open https://opendatacapture.org/fr/docs/introduction/home/.
  2. Read the sidebar group headings.

Actual: "Introduction, Tutorials, Guides, Concepts, Reference, Changelog, Runtime Core API".
Expected: "Introduction, Tutoriels, Guides, Concepts, Référence, Journal des modifications, API de Runtime Core", matching the French home page.

Tests

apps/outreach has no unit or Playwright suite, by decision (apps/outreach/AGENTS.md). Verify through the build: the sidebar in dist/fr/docs/introduction/home/index.html shows the French labels, and the English pages are unchanged.

Suggested fix

Add translations: { fr: '…' } to the Tutorials, Reference and Changelog sidebar entries, which Starlight supports on both groups and links. For the typedoc group, add a translations field to StarlightTypeDocSidebarOptions and pass it through in getSidebarGroupFromPackageReflections/getSidebarGroupFromReflections.

Lingua principale
TypeScript
Stelle
119
Fork
19
Merge medio
1g 2h
PR unite (30g)
56

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di DouglasNeuroInformatics/OpenDataCapture

Tutte le issue di DouglasNeuroInformatics/OpenDataCapture

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.