🔨 Add MkDocs hook that renames sections based on the first index file (#9737)

This commit is contained in:
Sebastián Ramírez 2023-06-24 16:47:15 +02:00 committed by GitHub
parent 3aea9acc68
commit 51d3a8ff12
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
58 changed files with 145 additions and 32 deletions

View File

@ -23,6 +23,7 @@ theme:
- search.suggest - search.suggest
- search.highlight - search.highlight
- content.tabs.link - content.tabs.link
- navigation.indexes
icon: icon:
repo: fontawesome/brands/github-alt repo: fontawesome/brands/github-alt
logo: https://fastapi.tiangolo.com/img/icon-white.svg logo: https://fastapi.tiangolo.com/img/icon-white.svg
@ -158,3 +159,5 @@ extra_css:
extra_javascript: extra_javascript:
- https://fastapi.tiangolo.com/js/termynal.js - https://fastapi.tiangolo.com/js/termynal.js
- https://fastapi.tiangolo.com/js/custom.js - https://fastapi.tiangolo.com/js/custom.js
hooks:
- ../../scripts/mkdocs_hooks.py

View File

@ -23,6 +23,7 @@ theme:
- search.suggest - search.suggest
- search.highlight - search.highlight
- content.tabs.link - content.tabs.link
- navigation.indexes
icon: icon:
repo: fontawesome/brands/github-alt repo: fontawesome/brands/github-alt
logo: https://fastapi.tiangolo.com/img/icon-white.svg logo: https://fastapi.tiangolo.com/img/icon-white.svg
@ -158,3 +159,5 @@ extra_css:
extra_javascript: extra_javascript:
- https://fastapi.tiangolo.com/js/termynal.js - https://fastapi.tiangolo.com/js/termynal.js
- https://fastapi.tiangolo.com/js/custom.js - https://fastapi.tiangolo.com/js/custom.js
hooks:
- ../../scripts/mkdocs_hooks.py

View File

@ -23,6 +23,7 @@ theme:
- search.suggest - search.suggest
- search.highlight - search.highlight
- content.tabs.link - content.tabs.link
- navigation.indexes
icon: icon:
repo: fontawesome/brands/github-alt repo: fontawesome/brands/github-alt
logo: https://fastapi.tiangolo.com/img/icon-white.svg logo: https://fastapi.tiangolo.com/img/icon-white.svg
@ -159,3 +160,5 @@ extra_css:
extra_javascript: extra_javascript:
- https://fastapi.tiangolo.com/js/termynal.js - https://fastapi.tiangolo.com/js/termynal.js
- https://fastapi.tiangolo.com/js/custom.js - https://fastapi.tiangolo.com/js/custom.js
hooks:
- ../../scripts/mkdocs_hooks.py

View File

@ -1,4 +1,4 @@
# 🏧 👩‍💻 🦮 - 🎶 # 🏧 👩‍💻 🦮
## 🌖 ⚒ ## 🌖 ⚒

View File

@ -1,4 +1,4 @@
# 🏧 💂‍♂ - 🎶 # 🏧 💂‍♂
## 🌖 ⚒ ## 🌖 ⚒

View File

@ -1,4 +1,4 @@
# 🛠️ - 🎶 # 🛠️
🛠️ **FastAPI** 🈸 📶 ⏩. 🛠️ **FastAPI** 🈸 📶 ⏩.

View File

@ -1,4 +1,4 @@
# 🔗 - 🥇 🔁 # 🔗
**FastAPI** ✔️ 📶 🏋️ ✋️ 🏋️ **<abbr title="also known as components, resources, providers, services, injectables">🔗 💉</abbr>** ⚙️. **FastAPI** ✔️ 📶 🏋️ ✋️ 🏋️ **<abbr title="also known as components, resources, providers, services, injectables">🔗 💉</abbr>** ⚙️.

View File

@ -1,4 +1,4 @@
# 🔰 - 👩‍💻 🦮 - 🎶 # 🔰 - 👩‍💻 🦮
👉 🔰 🎦 👆 ❔ ⚙️ **FastAPI** ⏮️ 🌅 🚮 ⚒, 🔁 🔁. 👉 🔰 🎦 👆 ❔ ⚙️ **FastAPI** ⏮️ 🌅 🚮 ⚒, 🔁 🔁.

View File

@ -1,4 +1,4 @@
# 💂‍♂ 🎶 # 💂‍♂
📤 📚 🌌 🍵 💂‍♂, 🤝 &amp; ✔. 📤 📚 🌌 🍵 💂‍♂, 🤝 &amp; ✔.

View File

@ -23,6 +23,7 @@ theme:
- search.suggest - search.suggest
- search.highlight - search.highlight
- content.tabs.link - content.tabs.link
- navigation.indexes
icon: icon:
repo: fontawesome/brands/github-alt repo: fontawesome/brands/github-alt
logo: https://fastapi.tiangolo.com/img/icon-white.svg logo: https://fastapi.tiangolo.com/img/icon-white.svg
@ -265,3 +266,5 @@ extra_css:
extra_javascript: extra_javascript:
- https://fastapi.tiangolo.com/js/termynal.js - https://fastapi.tiangolo.com/js/termynal.js
- https://fastapi.tiangolo.com/js/custom.js - https://fastapi.tiangolo.com/js/custom.js
hooks:
- ../../scripts/mkdocs_hooks.py

View File

@ -1,4 +1,4 @@
# Advanced User Guide - Intro # Advanced User Guide
## Additional Features ## Additional Features

View File

@ -1,4 +1,4 @@
# Advanced Security - Intro # Advanced Security
## Additional Features ## Additional Features

View File

@ -1,4 +1,4 @@
# Deployment - Intro # Deployment
Deploying a **FastAPI** application is relatively easy. Deploying a **FastAPI** application is relatively easy.

View File

@ -1,4 +1,4 @@
# Dependencies - First Steps # Dependencies
**FastAPI** has a very powerful but intuitive **<abbr title="also known as components, resources, providers, services, injectables">Dependency Injection</abbr>** system. **FastAPI** has a very powerful but intuitive **<abbr title="also known as components, resources, providers, services, injectables">Dependency Injection</abbr>** system.

View File

@ -1,4 +1,4 @@
# Tutorial - User Guide - Intro # Tutorial - User Guide
This tutorial shows you how to use **FastAPI** with most of its features, step by step. This tutorial shows you how to use **FastAPI** with most of its features, step by step.

View File

@ -1,4 +1,4 @@
# Security Intro # Security
There are many ways to handle security, authentication and authorization. There are many ways to handle security, authentication and authorization.

View File

@ -23,6 +23,7 @@ theme:
- search.suggest - search.suggest
- search.highlight - search.highlight
- content.tabs.link - content.tabs.link
- navigation.indexes
icon: icon:
repo: fontawesome/brands/github-alt repo: fontawesome/brands/github-alt
logo: img/icon-white.svg logo: img/icon-white.svg
@ -265,3 +266,5 @@ extra_css:
extra_javascript: extra_javascript:
- js/termynal.js - js/termynal.js
- js/custom.js - js/custom.js
hooks:
- ../../scripts/mkdocs_hooks.py

View File

@ -1,4 +1,4 @@
# Guía de Usuario Avanzada - Introducción # Guía de Usuario Avanzada
## Características Adicionales ## Características Adicionales

View File

@ -1,4 +1,4 @@
# Tutorial - Guía de Usuario - Introducción # Tutorial - Guía de Usuario
Este tutorial te muestra cómo usar **FastAPI** con la mayoría de sus características paso a paso. Este tutorial te muestra cómo usar **FastAPI** con la mayoría de sus características paso a paso.

View File

@ -23,6 +23,7 @@ theme:
- search.suggest - search.suggest
- search.highlight - search.highlight
- content.tabs.link - content.tabs.link
- navigation.indexes
icon: icon:
repo: fontawesome/brands/github-alt repo: fontawesome/brands/github-alt
logo: https://fastapi.tiangolo.com/img/icon-white.svg logo: https://fastapi.tiangolo.com/img/icon-white.svg
@ -168,3 +169,5 @@ extra_css:
extra_javascript: extra_javascript:
- https://fastapi.tiangolo.com/js/termynal.js - https://fastapi.tiangolo.com/js/termynal.js
- https://fastapi.tiangolo.com/js/custom.js - https://fastapi.tiangolo.com/js/custom.js
hooks:
- ../../scripts/mkdocs_hooks.py

View File

@ -23,6 +23,7 @@ theme:
- search.suggest - search.suggest
- search.highlight - search.highlight
- content.tabs.link - content.tabs.link
- navigation.indexes
icon: icon:
repo: fontawesome/brands/github-alt repo: fontawesome/brands/github-alt
logo: https://fastapi.tiangolo.com/img/icon-white.svg logo: https://fastapi.tiangolo.com/img/icon-white.svg
@ -158,3 +159,5 @@ extra_css:
extra_javascript: extra_javascript:
- https://fastapi.tiangolo.com/js/termynal.js - https://fastapi.tiangolo.com/js/termynal.js
- https://fastapi.tiangolo.com/js/custom.js - https://fastapi.tiangolo.com/js/custom.js
hooks:
- ../../scripts/mkdocs_hooks.py

View File

@ -1,4 +1,4 @@
# Guide de l'utilisateur avancé - Introduction # Guide de l'utilisateur avancé
## Caractéristiques supplémentaires ## Caractéristiques supplémentaires

View File

@ -1,4 +1,4 @@
# Déploiement - Intro # Déploiement
Le déploiement d'une application **FastAPI** est relativement simple. Le déploiement d'une application **FastAPI** est relativement simple.

View File

@ -23,6 +23,7 @@ theme:
- search.suggest - search.suggest
- search.highlight - search.highlight
- content.tabs.link - content.tabs.link
- navigation.indexes
icon: icon:
repo: fontawesome/brands/github-alt repo: fontawesome/brands/github-alt
logo: https://fastapi.tiangolo.com/img/icon-white.svg logo: https://fastapi.tiangolo.com/img/icon-white.svg
@ -187,3 +188,5 @@ extra_css:
extra_javascript: extra_javascript:
- https://fastapi.tiangolo.com/js/termynal.js - https://fastapi.tiangolo.com/js/termynal.js
- https://fastapi.tiangolo.com/js/custom.js - https://fastapi.tiangolo.com/js/custom.js
hooks:
- ../../scripts/mkdocs_hooks.py

View File

@ -23,6 +23,7 @@ theme:
- search.suggest - search.suggest
- search.highlight - search.highlight
- content.tabs.link - content.tabs.link
- navigation.indexes
icon: icon:
repo: fontawesome/brands/github-alt repo: fontawesome/brands/github-alt
logo: https://fastapi.tiangolo.com/img/icon-white.svg logo: https://fastapi.tiangolo.com/img/icon-white.svg
@ -158,3 +159,5 @@ extra_css:
extra_javascript: extra_javascript:
- https://fastapi.tiangolo.com/js/termynal.js - https://fastapi.tiangolo.com/js/termynal.js
- https://fastapi.tiangolo.com/js/custom.js - https://fastapi.tiangolo.com/js/custom.js
hooks:
- ../../scripts/mkdocs_hooks.py

View File

@ -23,6 +23,7 @@ theme:
- search.suggest - search.suggest
- search.highlight - search.highlight
- content.tabs.link - content.tabs.link
- navigation.indexes
icon: icon:
repo: fontawesome/brands/github-alt repo: fontawesome/brands/github-alt
logo: https://fastapi.tiangolo.com/img/icon-white.svg logo: https://fastapi.tiangolo.com/img/icon-white.svg
@ -158,3 +159,5 @@ extra_css:
extra_javascript: extra_javascript:
- https://fastapi.tiangolo.com/js/termynal.js - https://fastapi.tiangolo.com/js/termynal.js
- https://fastapi.tiangolo.com/js/custom.js - https://fastapi.tiangolo.com/js/custom.js
hooks:
- ../../scripts/mkdocs_hooks.py

View File

@ -23,6 +23,7 @@ theme:
- search.suggest - search.suggest
- search.highlight - search.highlight
- content.tabs.link - content.tabs.link
- navigation.indexes
icon: icon:
repo: fontawesome/brands/github-alt repo: fontawesome/brands/github-alt
logo: https://fastapi.tiangolo.com/img/icon-white.svg logo: https://fastapi.tiangolo.com/img/icon-white.svg
@ -158,3 +159,5 @@ extra_css:
extra_javascript: extra_javascript:
- https://fastapi.tiangolo.com/js/termynal.js - https://fastapi.tiangolo.com/js/termynal.js
- https://fastapi.tiangolo.com/js/custom.js - https://fastapi.tiangolo.com/js/custom.js
hooks:
- ../../scripts/mkdocs_hooks.py

View File

@ -23,6 +23,7 @@ theme:
- search.suggest - search.suggest
- search.highlight - search.highlight
- content.tabs.link - content.tabs.link
- navigation.indexes
icon: icon:
repo: fontawesome/brands/github-alt repo: fontawesome/brands/github-alt
logo: https://fastapi.tiangolo.com/img/icon-white.svg logo: https://fastapi.tiangolo.com/img/icon-white.svg
@ -158,3 +159,5 @@ extra_css:
extra_javascript: extra_javascript:
- https://fastapi.tiangolo.com/js/termynal.js - https://fastapi.tiangolo.com/js/termynal.js
- https://fastapi.tiangolo.com/js/custom.js - https://fastapi.tiangolo.com/js/custom.js
hooks:
- ../../scripts/mkdocs_hooks.py

View File

@ -1,4 +1,4 @@
# ユーザーガイド 応用編 # 高度なユーザーガイド
## さらなる機能 ## さらなる機能

View File

@ -1,4 +1,4 @@
# デプロイ - イントロ # デプロイ
**FastAPI** 製のアプリケーションは比較的容易にデプロイできます。 **FastAPI** 製のアプリケーションは比較的容易にデプロイできます。

View File

@ -1,4 +1,4 @@
# チュートリアル - ユーザーガイド - はじめに # チュートリアル - ユーザーガイド
このチュートリアルは**FastAPI**のほぼすべての機能の使い方を段階的に紹介します。 このチュートリアルは**FastAPI**のほぼすべての機能の使い方を段階的に紹介します。

View File

@ -23,6 +23,7 @@ theme:
- search.suggest - search.suggest
- search.highlight - search.highlight
- content.tabs.link - content.tabs.link
- navigation.indexes
icon: icon:
repo: fontawesome/brands/github-alt repo: fontawesome/brands/github-alt
logo: https://fastapi.tiangolo.com/img/icon-white.svg logo: https://fastapi.tiangolo.com/img/icon-white.svg
@ -202,3 +203,5 @@ extra_css:
extra_javascript: extra_javascript:
- https://fastapi.tiangolo.com/js/termynal.js - https://fastapi.tiangolo.com/js/termynal.js
- https://fastapi.tiangolo.com/js/custom.js - https://fastapi.tiangolo.com/js/custom.js
hooks:
- ../../scripts/mkdocs_hooks.py

View File

@ -1,4 +1,4 @@
# 자습서 - 사용자 안내서 - 도입부 # 자습서 - 사용자 안내서
이 자습서는 **FastAPI**의 대부분의 기능을 단계별로 사용하는 방법을 보여줍니다. 이 자습서는 **FastAPI**의 대부분의 기능을 단계별로 사용하는 방법을 보여줍니다.

View File

@ -23,6 +23,7 @@ theme:
- search.suggest - search.suggest
- search.highlight - search.highlight
- content.tabs.link - content.tabs.link
- navigation.indexes
icon: icon:
repo: fontawesome/brands/github-alt repo: fontawesome/brands/github-alt
logo: https://fastapi.tiangolo.com/img/icon-white.svg logo: https://fastapi.tiangolo.com/img/icon-white.svg
@ -172,3 +173,5 @@ extra_css:
extra_javascript: extra_javascript:
- https://fastapi.tiangolo.com/js/termynal.js - https://fastapi.tiangolo.com/js/termynal.js
- https://fastapi.tiangolo.com/js/custom.js - https://fastapi.tiangolo.com/js/custom.js
hooks:
- ../../scripts/mkdocs_hooks.py

View File

@ -23,6 +23,7 @@ theme:
- search.suggest - search.suggest
- search.highlight - search.highlight
- content.tabs.link - content.tabs.link
- navigation.indexes
icon: icon:
repo: fontawesome/brands/github-alt repo: fontawesome/brands/github-alt
logo: https://fastapi.tiangolo.com/img/icon-white.svg logo: https://fastapi.tiangolo.com/img/icon-white.svg
@ -158,3 +159,5 @@ extra_css:
extra_javascript: extra_javascript:
- https://fastapi.tiangolo.com/js/termynal.js - https://fastapi.tiangolo.com/js/termynal.js
- https://fastapi.tiangolo.com/js/custom.js - https://fastapi.tiangolo.com/js/custom.js
hooks:
- ../../scripts/mkdocs_hooks.py

View File

@ -23,6 +23,7 @@ theme:
- search.suggest - search.suggest
- search.highlight - search.highlight
- content.tabs.link - content.tabs.link
- navigation.indexes
icon: icon:
repo: fontawesome/brands/github-alt repo: fontawesome/brands/github-alt
logo: https://fastapi.tiangolo.com/img/icon-white.svg logo: https://fastapi.tiangolo.com/img/icon-white.svg
@ -158,3 +159,5 @@ extra_css:
extra_javascript: extra_javascript:
- https://fastapi.tiangolo.com/js/termynal.js - https://fastapi.tiangolo.com/js/termynal.js
- https://fastapi.tiangolo.com/js/custom.js - https://fastapi.tiangolo.com/js/custom.js
hooks:
- ../../scripts/mkdocs_hooks.py

View File

@ -1,4 +1,4 @@
# Samouczek - Wprowadzenie # Samouczek
Ten samouczek pokaże Ci, krok po kroku, jak używać większości funkcji **FastAPI**. Ten samouczek pokaże Ci, krok po kroku, jak używać większości funkcji **FastAPI**.

View File

@ -23,6 +23,7 @@ theme:
- search.suggest - search.suggest
- search.highlight - search.highlight
- content.tabs.link - content.tabs.link
- navigation.indexes
icon: icon:
repo: fontawesome/brands/github-alt repo: fontawesome/brands/github-alt
logo: https://fastapi.tiangolo.com/img/icon-white.svg logo: https://fastapi.tiangolo.com/img/icon-white.svg
@ -162,3 +163,5 @@ extra_css:
extra_javascript: extra_javascript:
- https://fastapi.tiangolo.com/js/termynal.js - https://fastapi.tiangolo.com/js/termynal.js
- https://fastapi.tiangolo.com/js/custom.js - https://fastapi.tiangolo.com/js/custom.js
hooks:
- ../../scripts/mkdocs_hooks.py

View File

@ -1,4 +1,4 @@
# Guia de Usuário Avançado - Introdução # Guia de Usuário Avançado
## Recursos Adicionais ## Recursos Adicionais

View File

@ -1,4 +1,4 @@
# Implantação - Introdução # Implantação
A implantação de uma aplicação **FastAPI** é relativamente simples. A implantação de uma aplicação **FastAPI** é relativamente simples.

View File

@ -1,4 +1,4 @@
# Tutorial - Guia de Usuário - Introdução # Tutorial - Guia de Usuário
Esse tutorial mostra como usar o **FastAPI** com a maior parte de seus recursos, passo a passo. Esse tutorial mostra como usar o **FastAPI** com a maior parte de seus recursos, passo a passo.

View File

@ -1,4 +1,4 @@
# Introdução à segurança # Segurança
Há várias formas de lidar segurança, autenticação e autorização. Há várias formas de lidar segurança, autenticação e autorização.

View File

@ -23,6 +23,7 @@ theme:
- search.suggest - search.suggest
- search.highlight - search.highlight
- content.tabs.link - content.tabs.link
- navigation.indexes
icon: icon:
repo: fontawesome/brands/github-alt repo: fontawesome/brands/github-alt
logo: https://fastapi.tiangolo.com/img/icon-white.svg logo: https://fastapi.tiangolo.com/img/icon-white.svg
@ -199,3 +200,5 @@ extra_css:
extra_javascript: extra_javascript:
- https://fastapi.tiangolo.com/js/termynal.js - https://fastapi.tiangolo.com/js/termynal.js
- https://fastapi.tiangolo.com/js/custom.js - https://fastapi.tiangolo.com/js/custom.js
hooks:
- ../../scripts/mkdocs_hooks.py

View File

@ -1,4 +1,4 @@
# Развёртывание - Введение # Развёртывание
Развернуть приложение **FastAPI** довольно просто. Развернуть приложение **FastAPI** довольно просто.

View File

@ -1,4 +1,4 @@
# Учебник - Руководство пользователя - Введение # Учебник - Руководство пользователя
В этом руководстве шаг за шагом показано, как использовать **FastApi** с большинством его функций. В этом руководстве шаг за шагом показано, как использовать **FastApi** с большинством его функций.

View File

@ -23,6 +23,7 @@ theme:
- search.suggest - search.suggest
- search.highlight - search.highlight
- content.tabs.link - content.tabs.link
- navigation.indexes
icon: icon:
repo: fontawesome/brands/github-alt repo: fontawesome/brands/github-alt
logo: https://fastapi.tiangolo.com/img/icon-white.svg logo: https://fastapi.tiangolo.com/img/icon-white.svg
@ -197,3 +198,5 @@ extra_css:
extra_javascript: extra_javascript:
- https://fastapi.tiangolo.com/js/termynal.js - https://fastapi.tiangolo.com/js/termynal.js
- https://fastapi.tiangolo.com/js/custom.js - https://fastapi.tiangolo.com/js/custom.js
hooks:
- ../../scripts/mkdocs_hooks.py

View File

@ -23,6 +23,7 @@ theme:
- search.suggest - search.suggest
- search.highlight - search.highlight
- content.tabs.link - content.tabs.link
- navigation.indexes
icon: icon:
repo: fontawesome/brands/github-alt repo: fontawesome/brands/github-alt
logo: https://fastapi.tiangolo.com/img/icon-white.svg logo: https://fastapi.tiangolo.com/img/icon-white.svg
@ -158,3 +159,5 @@ extra_css:
extra_javascript: extra_javascript:
- https://fastapi.tiangolo.com/js/termynal.js - https://fastapi.tiangolo.com/js/termynal.js
- https://fastapi.tiangolo.com/js/custom.js - https://fastapi.tiangolo.com/js/custom.js
hooks:
- ../../scripts/mkdocs_hooks.py

View File

@ -23,6 +23,7 @@ theme:
- search.suggest - search.suggest
- search.highlight - search.highlight
- content.tabs.link - content.tabs.link
- navigation.indexes
icon: icon:
repo: fontawesome/brands/github-alt repo: fontawesome/brands/github-alt
logo: https://fastapi.tiangolo.com/img/icon-white.svg logo: https://fastapi.tiangolo.com/img/icon-white.svg
@ -158,3 +159,5 @@ extra_css:
extra_javascript: extra_javascript:
- https://fastapi.tiangolo.com/js/termynal.js - https://fastapi.tiangolo.com/js/termynal.js
- https://fastapi.tiangolo.com/js/custom.js - https://fastapi.tiangolo.com/js/custom.js
hooks:
- ../../scripts/mkdocs_hooks.py

View File

@ -23,6 +23,7 @@ theme:
- search.suggest - search.suggest
- search.highlight - search.highlight
- content.tabs.link - content.tabs.link
- navigation.indexes
icon: icon:
repo: fontawesome/brands/github-alt repo: fontawesome/brands/github-alt
logo: https://fastapi.tiangolo.com/img/icon-white.svg logo: https://fastapi.tiangolo.com/img/icon-white.svg
@ -158,3 +159,5 @@ extra_css:
extra_javascript: extra_javascript:
- https://fastapi.tiangolo.com/js/termynal.js - https://fastapi.tiangolo.com/js/termynal.js
- https://fastapi.tiangolo.com/js/custom.js - https://fastapi.tiangolo.com/js/custom.js
hooks:
- ../../scripts/mkdocs_hooks.py

View File

@ -23,6 +23,7 @@ theme:
- search.suggest - search.suggest
- search.highlight - search.highlight
- content.tabs.link - content.tabs.link
- navigation.indexes
icon: icon:
repo: fontawesome/brands/github-alt repo: fontawesome/brands/github-alt
logo: https://fastapi.tiangolo.com/img/icon-white.svg logo: https://fastapi.tiangolo.com/img/icon-white.svg
@ -163,3 +164,5 @@ extra_css:
extra_javascript: extra_javascript:
- https://fastapi.tiangolo.com/js/termynal.js - https://fastapi.tiangolo.com/js/termynal.js
- https://fastapi.tiangolo.com/js/custom.js - https://fastapi.tiangolo.com/js/custom.js
hooks:
- ../../scripts/mkdocs_hooks.py

View File

@ -23,6 +23,7 @@ theme:
- search.suggest - search.suggest
- search.highlight - search.highlight
- content.tabs.link - content.tabs.link
- navigation.indexes
icon: icon:
repo: fontawesome/brands/github-alt repo: fontawesome/brands/github-alt
logo: https://fastapi.tiangolo.com/img/icon-white.svg logo: https://fastapi.tiangolo.com/img/icon-white.svg
@ -158,3 +159,5 @@ extra_css:
extra_javascript: extra_javascript:
- https://fastapi.tiangolo.com/js/termynal.js - https://fastapi.tiangolo.com/js/termynal.js
- https://fastapi.tiangolo.com/js/custom.js - https://fastapi.tiangolo.com/js/custom.js
hooks:
- ../../scripts/mkdocs_hooks.py

View File

@ -1,4 +1,4 @@
# 高级用户指南 - 简介 # 高级用户指南
## 额外特性 ## 额外特性

View File

@ -1,4 +1,4 @@
# 高级安全 - 介绍 # 高级安全
## 附加特性 ## 附加特性

View File

@ -1,4 +1,4 @@
# 依赖项 - 第一步 # 依赖项
FastAPI 提供了简单易用,但功能强大的**<abbr title="也称为组件、资源、提供者、服务、可注入项">依赖注入</abbr>**系统。 FastAPI 提供了简单易用,但功能强大的**<abbr title="也称为组件、资源、提供者、服务、可注入项">依赖注入</abbr>**系统。

View File

@ -1,4 +1,4 @@
# 教程 - 用户指南 - 简介 # 教程 - 用户指南
本教程将一步步向你展示如何使用 **FastAPI** 的绝大部分特性。 本教程将一步步向你展示如何使用 **FastAPI** 的绝大部分特性。

View File

@ -1,4 +1,4 @@
# 安全性简介 # 安全性
有许多方法可以处理安全性、身份认证和授权等问题。 有许多方法可以处理安全性、身份认证和授权等问题。

View File

@ -23,6 +23,7 @@ theme:
- search.suggest - search.suggest
- search.highlight - search.highlight
- content.tabs.link - content.tabs.link
- navigation.indexes
icon: icon:
repo: fontawesome/brands/github-alt repo: fontawesome/brands/github-alt
logo: https://fastapi.tiangolo.com/img/icon-white.svg logo: https://fastapi.tiangolo.com/img/icon-white.svg
@ -223,3 +224,5 @@ extra_css:
extra_javascript: extra_javascript:
- https://fastapi.tiangolo.com/js/termynal.js - https://fastapi.tiangolo.com/js/termynal.js
- https://fastapi.tiangolo.com/js/custom.js - https://fastapi.tiangolo.com/js/custom.js
hooks:
- ../../scripts/mkdocs_hooks.py

38
scripts/mkdocs_hooks.py Normal file
View File

@ -0,0 +1,38 @@
from typing import Any, List, Union
from mkdocs.config.defaults import MkDocsConfig
from mkdocs.structure.files import Files
from mkdocs.structure.nav import Link, Navigation, Section
from mkdocs.structure.pages import Page
def generate_renamed_section_items(
items: List[Union[Page, Section, Link]], *, config: MkDocsConfig
) -> List[Union[Page, Section, Link]]:
new_items: List[Union[Page, Section, Link]] = []
for item in items:
if isinstance(item, Section):
new_title = item.title
new_children = generate_renamed_section_items(item.children, config=config)
first_child = new_children[0]
if isinstance(first_child, Page):
if first_child.file.src_path.endswith("index.md"):
# Read the source so that the title is parsed and available
first_child.read_source(config=config)
new_title = first_child.title or new_title
# Creating a new section makes it render it collapsed by default
# no idea why, so, let's just modify the existing one
# new_section = Section(title=new_title, children=new_children)
item.title = new_title
item.children = new_children
new_items.append(item)
else:
new_items.append(item)
return new_items
def on_nav(
nav: Navigation, *, config: MkDocsConfig, files: Files, **kwargs: Any
) -> Navigation:
new_items = generate_renamed_section_items(nav.items, config=config)
return Navigation(items=new_items, pages=nav.pages)