Add automatic doc sorting (huggingface#1940)

* automatically sort docs

* add new check toc doc

* add new check toc doc

* add

* add new check toc doc

* add

* add new check toc doc

* correct

* finalize

Makefile

@@ -45,12 +45,14 @@ quality:
 	isort --check-only $(check_dirs)
 	flake8 $(check_dirs)
 	doc-builder style src/diffusers docs/source --max_len 119 --check_only --path_to_docs docs/source
+	python utils/check_doc_toc.py
 
 # Format source code automatically and check is there are any problems left that need manual fixing
 
 extra_style_checks:
 	python utils/custom_init_isort.py
 	doc-builder style src/diffusers docs/source --max_len 119 --path_to_docs docs/source
+	python utils/check_doc_toc.py --fix_and_overwrite
 
 # this target runs checks on all files and potentially modifies some of them
 

docs/source/en/_toctree.yml

@@ -1,195 +1,194 @@
 - sections:
   - local: index
-    title: "🧨 Diffusers"
+    title: 🧨 Diffusers
   - local: quicktour
-    title: "Quicktour"
+    title: Quicktour
   - local: stable_diffusion
-    title: "Stable Diffusion"
+    title: Stable Diffusion
   - local: installation
-    title: "Installation"
-  title: "Get started"
+    title: Installation
+  title: Get started
 - sections:
   - sections:
     - local: using-diffusers/loading
-      title: "Loading Pipelines, Models, and Schedulers"
+      title: Loading Pipelines, Models, and Schedulers
     - local: using-diffusers/schedulers
-      title: "Using different Schedulers"
+      title: Using different Schedulers
     - local: using-diffusers/configuration
-      title: "Configuring Pipelines, Models, and Schedulers"
+      title: Configuring Pipelines, Models, and Schedulers
     - local: using-diffusers/custom_pipeline_overview
-      title: "Loading and Adding Custom Pipelines"
-    title: "Loading & Hub"
+      title: Loading and Adding Custom Pipelines
+    title: Loading & Hub
   - sections:
     - local: using-diffusers/unconditional_image_generation
-      title: "Unconditional Image Generation"
+      title: Unconditional Image Generation
     - local: using-diffusers/conditional_image_generation
-      title: "Text-to-Image Generation"
+      title: Text-to-Image Generation
     - local: using-diffusers/img2img
-      title: "Text-Guided Image-to-Image"
+      title: Text-Guided Image-to-Image
     - local: using-diffusers/inpaint
-      title: "Text-Guided Image-Inpainting"
+      title: Text-Guided Image-Inpainting
     - local: using-diffusers/depth2img
-      title: "Text-Guided Depth-to-Image"
+      title: Text-Guided Depth-to-Image
     - local: using-diffusers/reusing_seeds
-      title: "Reusing seeds for deterministic generation"
+      title: Reusing seeds for deterministic generation
     - local: using-diffusers/custom_pipeline_examples
-      title: "Community Pipelines"
+      title: Community Pipelines
     - local: using-diffusers/contribute_pipeline
-      title: "How to contribute a Pipeline"
-    title: "Pipelines for Inference"
+      title: How to contribute a Pipeline
+    title: Pipelines for Inference
   - sections:
     - local: using-diffusers/rl
-      title: "Reinforcement Learning"
+      title: Reinforcement Learning
     - local: using-diffusers/audio
-      title: "Audio"
+      title: Audio
     - local: using-diffusers/other-modalities
-      title: "Other Modalities"
-    title: "Taking Diffusers Beyond Images"
-  title: "Using Diffusers"
+      title: Other Modalities
+    title: Taking Diffusers Beyond Images
+  title: Using Diffusers
 - sections:
   - local: optimization/fp16
-    title: "Memory and Speed"
+    title: Memory and Speed
   - local: optimization/xformers
-    title: "xFormers"
+    title: xFormers
   - local: optimization/onnx
-    title: "ONNX"
+    title: ONNX
   - local: optimization/open_vino
-    title: "OpenVINO"
+    title: OpenVINO
   - local: optimization/mps
-    title: "MPS"
+    title: MPS
   - local: optimization/habana
-    title: "Habana Gaudi"
-  title: "Optimization/Special Hardware"
+    title: Habana Gaudi
+  title: Optimization/Special Hardware
 - sections:
   - local: training/overview
-    title: "Overview"
+    title: Overview
   - local: training/unconditional_training
-    title: "Unconditional Image Generation"
+    title: Unconditional Image Generation
   - local: training/text_inversion
-    title: "Textual Inversion"
+    title: Textual Inversion
   - local: training/dreambooth
-    title: "Dreambooth"
+    title: Dreambooth
   - local: training/text2image
-    title: "Text-to-image fine-tuning"
-  title: "Training"
+    title: Text-to-image fine-tuning
+  title: Training
 - sections:
   - local: conceptual/philosophy
-    title: "Philosophy"
+    title: Philosophy
   - local: conceptual/contribution
-    title: "How to contribute?"
-  title: "Conceptual Guides"
+    title: How to contribute?
+  title: Conceptual Guides
 - sections:
   - sections:
     - local: api/models
-      title: "Models"
+      title: Models
     - local: api/diffusion_pipeline
-      title: "Diffusion Pipeline"
+      title: Diffusion Pipeline
     - local: api/logging
-      title: "Logging"
+      title: Logging
     - local: api/configuration
-      title: "Configuration"
+      title: Configuration
     - local: api/outputs
-      title: "Outputs"
-    title: "Main Classes"
-
+      title: Outputs
+    title: Main Classes
   - sections:
     - local: api/pipelines/overview
-      title: "Overview"
+      title: Overview
     - local: api/pipelines/alt_diffusion
-      title: "AltDiffusion"
+      title: AltDiffusion
+    - local: api/pipelines/audio_diffusion
+      title: Audio Diffusion
     - local: api/pipelines/cycle_diffusion
-      title: "Cycle Diffusion"
+      title: Cycle Diffusion
+    - local: api/pipelines/dance_diffusion
+      title: Dance Diffusion
     - local: api/pipelines/ddim
-      title: "DDIM"
+      title: DDIM
     - local: api/pipelines/ddpm
-      title: "DDPM"
+      title: DDPM
     - local: api/pipelines/latent_diffusion
-      title: "Latent Diffusion"
-    - local: api/pipelines/latent_diffusion_uncond
-      title: "Unconditional Latent Diffusion"
+      title: Latent Diffusion
     - local: api/pipelines/paint_by_example
-      title: "PaintByExample"
+      title: PaintByExample
     - local: api/pipelines/pndm
-      title: "PNDM"
+      title: PNDM
+    - local: api/pipelines/repaint
+      title: RePaint
+    - local: api/pipelines/stable_diffusion_safe
+      title: Safe Stable Diffusion
     - local: api/pipelines/score_sde_ve
-      title: "Score SDE VE"
+      title: Score SDE VE
     - sections:
       - local: api/pipelines/stable_diffusion/overview
-        title: "Overview"
+        title: Overview
       - local: api/pipelines/stable_diffusion/text2img
-        title: "Text-to-Image"
+        title: Text-to-Image
       - local: api/pipelines/stable_diffusion/img2img
-        title: "Image-to-Image"
+        title: Image-to-Image
       - local: api/pipelines/stable_diffusion/inpaint
-        title: "Inpaint"
+        title: Inpaint
       - local: api/pipelines/stable_diffusion/depth2img
-        title: "Depth-to-Image"
+        title: Depth-to-Image
       - local: api/pipelines/stable_diffusion/image_variation
-        title: "Image-Variation"  
+        title: Image-Variation
       - local: api/pipelines/stable_diffusion/upscale
-        title: "Super-Resolution"  
-      title: "Stable Diffusion"
+        title: Super-Resolution
+      title: Stable Diffusion
     - local: api/pipelines/stable_diffusion_2
-      title: "Stable Diffusion 2"
-    - local: api/pipelines/stable_diffusion_safe
-      title: "Safe Stable Diffusion"
+      title: Stable Diffusion 2
     - local: api/pipelines/stochastic_karras_ve
-      title: "Stochastic Karras VE"
-    - local: api/pipelines/dance_diffusion
-      title: "Dance Diffusion"
+      title: Stochastic Karras VE
     - local: api/pipelines/unclip
-      title: "UnCLIP"
+      title: UnCLIP
+    - local: api/pipelines/latent_diffusion_uncond
+      title: Unconditional Latent Diffusion
     - local: api/pipelines/versatile_diffusion
-      title: "Versatile Diffusion"
+      title: Versatile Diffusion
     - local: api/pipelines/vq_diffusion
-      title: "VQ Diffusion"
-    - local: api/pipelines/repaint
-      title: "RePaint"
-    - local: api/pipelines/audio_diffusion
-      title: "Audio Diffusion"
-    title: "Pipelines"
+      title: VQ Diffusion
+    title: Pipelines
   - sections:
     - local: api/schedulers/overview
-      title: "Overview"
+      title: Overview
     - local: api/schedulers/ddim
-      title: "DDIM"
+      title: DDIM
     - local: api/schedulers/ddpm
-      title: "DDPM"
+      title: DDPM
     - local: api/schedulers/deis
-      title: "DEIS"
-    - local: api/schedulers/singlestep_dpm_solver
-      title: "Singlestep DPM-Solver"
-    - local: api/schedulers/multistep_dpm_solver
-      title: "Multistep DPM-Solver"
-    - local: api/schedulers/heun
-      title: "Heun Scheduler"
+      title: DEIS
     - local: api/schedulers/dpm_discrete
-      title: "DPM Discrete Scheduler"
+      title: DPM Discrete Scheduler
     - local: api/schedulers/dpm_discrete_ancestral
-      title: "DPM Discrete Scheduler with ancestral sampling"
-    - local: api/schedulers/stochastic_karras_ve
-      title: "Stochastic Kerras VE"
+      title: DPM Discrete Scheduler with ancestral sampling
+    - local: api/schedulers/euler_ancestral
+      title: Euler Ancestral Scheduler
+    - local: api/schedulers/euler
+      title: Euler scheduler
+    - local: api/schedulers/heun
+      title: Heun Scheduler
+    - local: api/schedulers/ipndm
+      title: IPNDM
     - local: api/schedulers/lms_discrete
-      title: "Linear Multistep"
+      title: Linear Multistep
+    - local: api/schedulers/multistep_dpm_solver
+      title: Multistep DPM-Solver
     - local: api/schedulers/pndm
-      title: "PNDM"
+      title: PNDM
+    - local: api/schedulers/repaint
+      title: RePaint Scheduler
+    - local: api/schedulers/singlestep_dpm_solver
+      title: Singlestep DPM-Solver
+    - local: api/schedulers/stochastic_karras_ve
+      title: Stochastic Kerras VE
     - local: api/schedulers/score_sde_ve
-      title: "VE-SDE"
-    - local: api/schedulers/ipndm
-      title: "IPNDM"
+      title: VE-SDE
     - local: api/schedulers/score_sde_vp
-      title: "VP-SDE"
-    - local: api/schedulers/euler
-      title: "Euler scheduler"
-    - local: api/schedulers/euler_ancestral
-      title: "Euler Ancestral Scheduler"
+      title: VP-SDE
     - local: api/schedulers/vq_diffusion
-      title: "VQDiffusionScheduler"
-    - local: api/schedulers/repaint
-      title: "RePaint Scheduler"      
-    title: "Schedulers"
+      title: VQDiffusionScheduler
+    title: Schedulers
   - sections:
     - local: api/experimental/rl
-      title: "RL Planning"
-    title: "Experimental Features"
-  title: "API"
+      title: RL Planning
+    title: Experimental Features
+  title: API