BR Localisation (Português / Brazil) ​

Brazilian-Portuguese guides for uma.guide. Served under /br/.

This README is a contributor note, not a site page — README.md files are excluded from VitePress routing.

Translating a guide ​

  1. Copy the English guide from docs/src/guides/<slug>.md to docs/src/br/guides/<slug>.md (same filename).

  2. Translate only:

    • the prose (paragraphs, list items, section headings);
    • the title and description fields in the frontmatter (the --- block at the top).

  3. Do NOT change:

    • Vue components: <TypeIcon>, <StatBox>, <ImageBox>, <SkillHover>, <Uma>, <SupportCard>, etc. — copy them exactly as-is;
    • table structure (translate only cell text, where present);
    • image paths (src="...") and values like stats="speed:1600 ...";
    • math formulas ($...$).

  4. Enable the language toggle. Add the guide's <slug> to the TRANSLATED_GUIDES set in docs/.vitepress/theme/components/GuideLangSwitch.vue. Without this, the EN / PT-BR button won't appear.

  5. Open a Pull Request with both changes (the translated .md + the TRANSLATED_GUIDES entry).

Verify locally ​

sh
npm install
npm run docs:dev

Open http://localhost:5173/br/guides/<slug> in the browser. The language toggle (EN / PT-BR) should show at the top of the article and switch between versions.

Translated so far ​

GuideSlugStatus
Grand Concertgrand-concertstub (awaiting translation)

Update this table when a translation is finished.

Known limitations (v1) ​

  • The site chrome (nav, search, guides listing) stays in English on /br/ pages. Only the guide body is translated for now.
  • /br/ guides don't appear in search or the guides-listing page — the indexer only reads docs/src/guides/. Reach them via the language toggle.

These will be addressed when UI localisation (Layer 2) lands.