transformers - ✅(Solved) Fix [i18n-<languageCode>] Translating docs to <languageName> [1 pull requests, 1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
huggingface/transformers#44365Fetched 2026-04-08 00:28:55
View on GitHub
Comments
0
Participants
1
Timeline
3
Reactions
0
Participants
Timeline (top)
closed ×1mentioned ×1subscribed ×1

PR fix notes

PR #20180: [i18n-KO] Translated index page to Korean

Description (problem / solution / changelog)

What does this PR do?

Translated the Getting started - index.mdx file of the documentation to Korean. I use transformers for my side-project and wanted to contribute. As a beginner, this seemed appropriate.

Some questions:

  • I can't access the pr documentation endpoint for Korean. Is there a missing step?
  • I left all the other files alone after copying the English docs. Is this acceptable for future updates or should I add contents to the _toctree.yml only when translation is complete? Should I delete all other files for a cleaner review?
  • In Korea, people use both Transformer and 트랜스포머 to describe the model. However, as this is more of a product of HuggingFace I opted not to translate it. May you please let me know which you would prefer?

Thank you in advance for your review.

<!-- Remove if not applicable -->

Part of https://github.com/huggingface/transformers/issues/20179

Before submitting

  • This PR fixes a typo or improves the docs (you can dismiss the other checks if that's the case).
  • Did you read the contributor guideline, Pull Request section?
  • Was this discussed/approved via a Github issue or the forum? Please add a link to it if that's the case.
  • Did you make sure to update the documentation with your changes? Here are the documentation guidelines, and here are tips on formatting docstrings.
  • Did you write any new necessary tests?

Who can review?

@sgugger, may you please review this PR?

<!-- Your PR will be replied to more quickly if you can figure out the right person to tag with @ If you know how to use git blame, that is the easiest way, otherwise, here is a rough guide of **who to tag**. Please tag fewer than 3 people. Models: - albert, bert, xlm: @LysandreJik - blenderbot, bart, marian, pegasus, encoderdecoder, t5: @patrickvonplaten, @patil-suraj - longformer, reformer, transfoxl, xlnet: @patrickvonplaten - fsmt: @stas00 - funnel: @sgugger - gpt2: @patrickvonplaten, @LysandreJik - rag: @patrickvonplaten, @lhoestq - tensorflow: @LysandreJik Library: - benchmarks: @patrickvonplaten - deepspeed: @stas00 - ray/raytune: @richardliaw, @amogkam - text generation: @patrickvonplaten - tokenizers: @n1t0, @LysandreJik - trainer: @sgugger - pipelines: @LysandreJik Documentation: @sgugger HF projects: - datasets: [different repo](https://github.com/huggingface/datasets) - rust tokenizers: [different repo](https://github.com/huggingface/tokenizers) Examples: - maintained examples (not research project or legacy): @sgugger, @patil-suraj - research_projects/bert-loses-patience: @JetRunner - research_projects/distillation: @VictorSanh -->

Changed files

  • .github/workflows/build_documentation.yml (modified, +1/-1)
  • .github/workflows/build_pr_documentation.yml (modified, +1/-1)
  • docs/source/ko/_config.py (added, +14/-0)
  • docs/source/ko/_toctree.yml (added, +58/-0)
  • docs/source/ko/in_translation.mdx (added, +1/-0)
  • docs/source/ko/index.mdx (added, +353/-0)
RAW_BUFFERClick to expand / collapse
<!-- Note: Please search to see if an issue already exists for the language you are trying to translate. -->

Hi!

Let's bring the documentation to all the <languageName>-speaking community 🌐 (currently 0 out of 267 complete)

Who would want to translate? Please follow the 🤗 TRANSLATING guide. Here is a list of the files ready for translation. Let us know in this issue if you'd like to translate any, and we'll add your name to the list.

Some notes:

  • Please translate using an informal tone (imagine you are talking with a friend about transformers 🤗).
  • Please translate in a gender-neutral way.
  • Add your translations to the folder called <languageCode> inside the source folder.
  • Register your translation in <languageCode>/_toctree.yml; please follow the order of the English version.
  • Once you're finished, open a pull request and tag this issue by including #issue-number in the description, where issue-number is the number of this issue. Please ping @stevhliu for review.
  • 🙋 If you'd like others to help you with the translation, you can also post in the 🤗 forums.

Get Started section

Tutorial section

<!-- Keep on adding more as you go 🔥 -->

extent analysis

Fix Plan

Step 1: Identify the Language and Create a New Folder

Create a new folder for the target language in the source folder. For example, if the language is Spanish, create a new folder called es inside the source folder.

Step 2: Translate the Files

Translate the files listed in the issue body using an informal tone and in a gender-neutral way. Add the translations to the newly created folder.

Step 3: Update the _toctree.yml File

Register the translation in the _toctree.yml file inside the language folder. Follow the order of the English version.

Step 4: Open a Pull Request

Once the translations are complete, open a pull request and tag the issue by including the issue number in the description. Ping @stevhliu for review.

Example Code Snippet for _toctree.yml File

title: Transformers en Español
toctree:
  - index
  - quicktour
  - installation
  - pipeline_tutorial
  - autoclass_tutorial
  - preprocessing
  - training
  - accelerate
  - model_sharing
  - multilingual

Example Code Snippet for index.md File

# Transformers en Español

Bienvenidos a la documentación de Transformers en español. Aquí encontrarás información sobre cómo utilizar Transformers para tus proyectos.

Step 5: Review and Merge the Pull Request

Wait for the pull request to be reviewed and merged by @stevhliu.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING