Skip to content

[i18n-ES] Add Spanish translation for guides/overview - #4852

Open
nicolasdmolina wants to merge 1 commit into
huggingface:mainfrom
nicolasdmolina:i18n-es-guides-overview
Open

[i18n-ES] Add Spanish translation for guides/overview#4852
nicolasdmolina wants to merge 1 commit into
huggingface:mainfrom
nicolasdmolina:i18n-es-guides-overview

Conversation

@nicolasdmolina

@nicolasdmolina nicolasdmolina commented Sep 10, 2026

Copy link
Copy Markdown

Summary

Spanish docs are still missing from main. #4401 already bootstraps Get Started (index.md, quick-start.md, installation.md), so this PR does not repeat those pages.

This adds one How-to guides page so the es locale can start building and grow one chapter at a time:

  • docs/source/es/guides/overview.md
  • docs/source/es/_toctree.yml (only this chapter, per TRANSLATING.md)
  • register es in the main and PR documentation workflows

Prose is informal and gender-neutral. HTML, relative links, doc-builder syntax, and product names (Hub, Spaces, HfFileSystem, Model Cards, Jobs, …) stay aligned with the English overview. Linked guide pages are not translated yet; they can land in later PRs, same as Hindi did in #4405.

Part of #2640 and #1700. Reviewers from the issue: @Wauplin @hanouticelina @stevhliu.

If a Spanish-speaking reviewer can skim the wording, that would help a lot. Happy to adjust.

Verification

  • Compared the Spanish page to docs/source/en/guides/overview.md: 14 cards, same hrefs, same CSS classes, same line count.
  • Parsed the new _toctree.yml and both workflow files as YAML.
  • make style and make quality (ruff + generated-file checks + ty check src) passed. No Python/runtime changes, so library tests were not rerun.

Example

After the docs build, the new page should show up under Spanish as the How-to guides landing page, with the same card grid as https://huggingface.co/docs/huggingface_hub/en/guides/overview.


Note

Low Risk
Documentation-only i18n and CI language list updates; no library or runtime behavior changes.

Overview
Adds Spanish (es) to the huggingface_hub doc build by registering es in the main and PR documentation GitHub workflows, and introducing the first How-to guides slice for that locale.

New content includes docs/source/es/_toctree.yml (chapter Guías prácticasguides/overview) and a Spanish guides/overview.md landing page that mirrors the English card grid (same links, markup, and product names). Individual guide pages behind those links are not translated in this PR.

Reviewed by Cursor Bugbot for commit a7ba61f. Bugbot is set up for automated code reviews on this repo. Configure here.

Start the Spanish docs with the How-to guides landing page, following
TRANSLATING.md. Get Started pages are already in huggingface#4401, so this PR only
adds guides/overview.md, a matching toctree, and registers `es` in the
doc build workflows.
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