Enable doc in Spanish (#16518)

* Reorganize doc for multilingual support * Fix style * Style * Toc trees * Adapt templates
2025-07-31 02:02:21 +06:00 · 2022-04-04 10:25:46 -04:00 · 2022-04-04 10:25:46 -04:00 · b9a768b3ff
commit b9a768b3ff
parent 3951b9f390
206 changed files with 71 additions and 30 deletions
--- a/.github/workflows/build_documentation.yml
+++ b/.github/workflows/build_documentation.yml
@ -15,5 +15,6 @@ jobs:
      commit_sha: ${{ github.sha }}
      package: transformers
      notebook_folder: transformers_doc
+      languages: en es
    secrets:
      token: ${{ secrets.HUGGINGFACE_PUSH }}
--- a/.github/workflows/build_pr_documentation.yml
+++ b/.github/workflows/build_pr_documentation.yml
@ -14,3 +14,4 @@ jobs:
      commit_sha: ${{ github.event.pull_request.head.sha }}
      pr_number: ${{ github.event.number }}
      package: transformers
+      languages: en es
--- a/docs/source/contributing.md
+++ b/docs/source/contributing.md
@ -1 +0,0 @@
-../../CONTRIBUTING.md
--- a/docs/source/en/_config.py
+++ b/docs/source/en/_config.py
@ -0,0 +1,14 @@
+# docstyle-ignore
+INSTALL_CONTENT = """
+# Transformers installation
+! pip install transformers datasets
+# To install from source instead of the last release, comment the command above and uncomment the following one.
+# ! pip install git+https://github.com/huggingface/transformers.git
+"""
+
+notebook_first_cells = [{"type": "code", "content": INSTALL_CONTENT}]
+black_avoid_patterns = {
+    "{processor_class}": "FakeProcessorClass",
+    "{model_class}": "FakeModelClass",
+    "{object_class}": "FakeObjectClass",    
+}
--- a/docs/source/en/_toctree.yml
+++ b/docs/source/en/_toctree.yml
--- a/docs/source/en/accelerate.mdx
+++ b/docs/source/en/accelerate.mdx
--- a/docs/source/en/add_new_model.mdx
+++ b/docs/source/en/add_new_model.mdx
--- a/docs/source/en/add_new_pipeline.mdx
+++ b/docs/source/en/add_new_pipeline.mdx
--- a/docs/source/en/autoclass_tutorial.mdx
+++ b/docs/source/en/autoclass_tutorial.mdx
--- a/docs/source/en/benchmarks.mdx
+++ b/docs/source/en/benchmarks.mdx
--- a/docs/source/en/bertology.mdx
+++ b/docs/source/en/bertology.mdx
--- a/docs/source/en/community.mdx
+++ b/docs/source/en/community.mdx
--- a/docs/source/en/contributing.md
+++ b/docs/source/en/contributing.md
@ -0,0 +1 @@
+../../../CONTRIBUTING.md
--- a/docs/source/en/converting_tensorflow_models.mdx
+++ b/docs/source/en/converting_tensorflow_models.mdx
--- a/docs/source/en/create_a_model.mdx
+++ b/docs/source/en/create_a_model.mdx
--- a/docs/source/en/custom_models.mdx
+++ b/docs/source/en/custom_models.mdx
--- a/docs/source/en/debugging.mdx
+++ b/docs/source/en/debugging.mdx
--- a/docs/source/en/fast_tokenizers.mdx
+++ b/docs/source/en/fast_tokenizers.mdx
--- a/docs/source/en/glossary.mdx
+++ b/docs/source/en/glossary.mdx
--- a/docs/source/en/index.mdx
+++ b/docs/source/en/index.mdx
--- a/docs/source/en/installation.mdx
+++ b/docs/source/en/installation.mdx
--- a/docs/source/en/internal/file_utils.mdx
+++ b/docs/source/en/internal/file_utils.mdx
--- a/docs/source/en/internal/generation_utils.mdx
+++ b/docs/source/en/internal/generation_utils.mdx
--- a/docs/source/en/internal/modeling_utils.mdx
+++ b/docs/source/en/internal/modeling_utils.mdx
--- a/docs/source/en/internal/pipelines_utils.mdx
+++ b/docs/source/en/internal/pipelines_utils.mdx
--- a/docs/source/en/internal/tokenization_utils.mdx
+++ b/docs/source/en/internal/tokenization_utils.mdx
--- a/docs/source/en/internal/trainer_utils.mdx
+++ b/docs/source/en/internal/trainer_utils.mdx
--- a/docs/source/en/main_classes/callback.mdx
+++ b/docs/source/en/main_classes/callback.mdx
--- a/docs/source/en/main_classes/configuration.mdx
+++ b/docs/source/en/main_classes/configuration.mdx
--- a/docs/source/en/main_classes/data_collator.mdx
+++ b/docs/source/en/main_classes/data_collator.mdx
--- a/docs/source/en/main_classes/deepspeed.mdx
+++ b/docs/source/en/main_classes/deepspeed.mdx
--- a/docs/source/en/main_classes/feature_extractor.mdx
+++ b/docs/source/en/main_classes/feature_extractor.mdx
--- a/docs/source/en/main_classes/keras_callbacks.mdx
+++ b/docs/source/en/main_classes/keras_callbacks.mdx
--- a/docs/source/en/main_classes/logging.mdx
+++ b/docs/source/en/main_classes/logging.mdx
--- a/docs/source/en/main_classes/model.mdx
+++ b/docs/source/en/main_classes/model.mdx
--- a/docs/source/en/main_classes/onnx.mdx
+++ b/docs/source/en/main_classes/onnx.mdx
--- a/docs/source/en/main_classes/optimizer_schedules.mdx
+++ b/docs/source/en/main_classes/optimizer_schedules.mdx
--- a/docs/source/en/main_classes/output.mdx
+++ b/docs/source/en/main_classes/output.mdx
--- a/docs/source/en/main_classes/pipelines.mdx
+++ b/docs/source/en/main_classes/pipelines.mdx
--- a/docs/source/en/main_classes/processors.mdx
+++ b/docs/source/en/main_classes/processors.mdx
--- a/docs/source/en/main_classes/text_generation.mdx
+++ b/docs/source/en/main_classes/text_generation.mdx
--- a/docs/source/en/main_classes/tokenizer.mdx
+++ b/docs/source/en/main_classes/tokenizer.mdx
--- a/docs/source/en/main_classes/trainer.mdx
+++ b/docs/source/en/main_classes/trainer.mdx
--- a/docs/source/en/migration.mdx
+++ b/docs/source/en/migration.mdx
--- a/docs/source/en/model_doc/albert.mdx
+++ b/docs/source/en/model_doc/albert.mdx
--- a/docs/source/en/model_doc/auto.mdx
+++ b/docs/source/en/model_doc/auto.mdx
--- a/docs/source/en/model_doc/bart.mdx
+++ b/docs/source/en/model_doc/bart.mdx
--- a/docs/source/en/model_doc/barthez.mdx
+++ b/docs/source/en/model_doc/barthez.mdx
--- a/docs/source/en/model_doc/bartpho.mdx
+++ b/docs/source/en/model_doc/bartpho.mdx
--- a/docs/source/en/model_doc/beit.mdx
+++ b/docs/source/en/model_doc/beit.mdx
--- a/docs/source/en/model_doc/bert-generation.mdx
+++ b/docs/source/en/model_doc/bert-generation.mdx
--- a/docs/source/en/model_doc/bert-japanese.mdx
+++ b/docs/source/en/model_doc/bert-japanese.mdx
--- a/docs/source/en/model_doc/bert.mdx
+++ b/docs/source/en/model_doc/bert.mdx
--- a/docs/source/en/model_doc/bertweet.mdx
+++ b/docs/source/en/model_doc/bertweet.mdx
--- a/docs/source/en/model_doc/big_bird.mdx
+++ b/docs/source/en/model_doc/big_bird.mdx
--- a/docs/source/en/model_doc/bigbird_pegasus.mdx
+++ b/docs/source/en/model_doc/bigbird_pegasus.mdx
--- a/docs/source/en/model_doc/blenderbot-small.mdx
+++ b/docs/source/en/model_doc/blenderbot-small.mdx
--- a/docs/source/en/model_doc/blenderbot.mdx
+++ b/docs/source/en/model_doc/blenderbot.mdx
--- a/docs/source/en/model_doc/bort.mdx
+++ b/docs/source/en/model_doc/bort.mdx
--- a/docs/source/en/model_doc/byt5.mdx
+++ b/docs/source/en/model_doc/byt5.mdx
--- a/docs/source/en/model_doc/camembert.mdx
+++ b/docs/source/en/model_doc/camembert.mdx
--- a/docs/source/en/model_doc/canine.mdx
+++ b/docs/source/en/model_doc/canine.mdx
--- a/docs/source/en/model_doc/clip.mdx
+++ b/docs/source/en/model_doc/clip.mdx
--- a/docs/source/en/model_doc/convbert.mdx
+++ b/docs/source/en/model_doc/convbert.mdx
--- a/docs/source/en/model_doc/convnext.mdx
+++ b/docs/source/en/model_doc/convnext.mdx
--- a/docs/source/en/model_doc/cpm.mdx
+++ b/docs/source/en/model_doc/cpm.mdx
--- a/docs/source/en/model_doc/ctrl.mdx
+++ b/docs/source/en/model_doc/ctrl.mdx
--- a/docs/source/en/model_doc/data2vec.mdx
+++ b/docs/source/en/model_doc/data2vec.mdx
--- a/docs/source/en/model_doc/deberta-v2.mdx
+++ b/docs/source/en/model_doc/deberta-v2.mdx
--- a/docs/source/en/model_doc/deberta.mdx
+++ b/docs/source/en/model_doc/deberta.mdx
--- a/docs/source/en/model_doc/decision_transformer.mdx
+++ b/docs/source/en/model_doc/decision_transformer.mdx
--- a/docs/source/en/model_doc/deit.mdx
+++ b/docs/source/en/model_doc/deit.mdx
--- a/docs/source/en/model_doc/detr.mdx
+++ b/docs/source/en/model_doc/detr.mdx
--- a/docs/source/en/model_doc/dialogpt.mdx
+++ b/docs/source/en/model_doc/dialogpt.mdx
--- a/docs/source/en/model_doc/distilbert.mdx
+++ b/docs/source/en/model_doc/distilbert.mdx
--- a/docs/source/en/model_doc/dit.mdx
+++ b/docs/source/en/model_doc/dit.mdx
--- a/docs/source/en/model_doc/dpr.mdx
+++ b/docs/source/en/model_doc/dpr.mdx
--- a/docs/source/en/model_doc/dpt.mdx
+++ b/docs/source/en/model_doc/dpt.mdx
--- a/docs/source/en/model_doc/electra.mdx
+++ b/docs/source/en/model_doc/electra.mdx
--- a/docs/source/en/model_doc/encoder-decoder.mdx
+++ b/docs/source/en/model_doc/encoder-decoder.mdx
--- a/docs/source/en/model_doc/flaubert.mdx
+++ b/docs/source/en/model_doc/flaubert.mdx
--- a/docs/source/en/model_doc/fnet.mdx
+++ b/docs/source/en/model_doc/fnet.mdx
--- a/docs/source/en/model_doc/fsmt.mdx
+++ b/docs/source/en/model_doc/fsmt.mdx
--- a/docs/source/en/model_doc/funnel.mdx
+++ b/docs/source/en/model_doc/funnel.mdx
--- a/docs/source/en/model_doc/glpn.mdx
+++ b/docs/source/en/model_doc/glpn.mdx
--- a/docs/source/en/model_doc/gpt2.mdx
+++ b/docs/source/en/model_doc/gpt2.mdx
--- a/docs/source/en/model_doc/gpt_neo.mdx
+++ b/docs/source/en/model_doc/gpt_neo.mdx
--- a/docs/source/en/model_doc/gptj.mdx
+++ b/docs/source/en/model_doc/gptj.mdx
--- a/docs/source/en/model_doc/herbert.mdx
+++ b/docs/source/en/model_doc/herbert.mdx
--- a/docs/source/en/model_doc/hubert.mdx
+++ b/docs/source/en/model_doc/hubert.mdx
--- a/docs/source/en/model_doc/ibert.mdx
+++ b/docs/source/en/model_doc/ibert.mdx
--- a/docs/source/en/model_doc/imagegpt.mdx
+++ b/docs/source/en/model_doc/imagegpt.mdx
--- a/docs/source/en/model_doc/layoutlm.mdx
+++ b/docs/source/en/model_doc/layoutlm.mdx
--- a/docs/source/en/model_doc/layoutlmv2.mdx
+++ b/docs/source/en/model_doc/layoutlmv2.mdx
--- a/docs/source/en/model_doc/layoutxlm.mdx
+++ b/docs/source/en/model_doc/layoutxlm.mdx
--- a/docs/source/en/model_doc/led.mdx
+++ b/docs/source/en/model_doc/led.mdx
--- a/docs/source/en/model_doc/longformer.mdx
+++ b/docs/source/en/model_doc/longformer.mdx
--- a/docs/source/en/model_doc/luke.mdx
+++ b/docs/source/en/model_doc/luke.mdx
--- a/docs/source/en/model_doc/lxmert.mdx
+++ b/docs/source/en/model_doc/lxmert.mdx
--- a/docs/source/en/model_doc/m2m_100.mdx
+++ b/docs/source/en/model_doc/m2m_100.mdx
--- a/Show More
+++ b/Show More