@app.command()
def generate_readme() -> None:
    """
    Generate README.md content from main index.md
    """
    readme_path = Path("README.md")
    old_content = readme_path.read_text("utf-8")
    new_content = generate_readme_content()
    if new_content != old_content:
        print("README.md outdated from the latest index.md")
        print("Updating README.md")
        readme_path.write_text(new_content, encoding="utf-8")

     * @param docId the document ID
     * @param queryId the query ID from the search
     * @param requestedTime the requested time from the search
     * @param order the order index of the document
     * @return the go URL, or null if docId or queryId is null
     */
    protected String buildGoUrl(final String contextPath, final String docId, final String queryId, final long requestedTime,

            task.getJavadocUrl().convention("../javadoc");
            task.getWebsiteUrl().convention("https://gradle.org");

            task.getDestFile().convention(dslReference.getStagingRoot().file("index.xml"));
        });

        Configuration userGuideTask = project.getConfigurations().create("userGuideTask");
        Configuration userGuideStyleSheetConf = project.getConfigurations().create("userGuideStyleSheets");

///

### 什么是“挂载”（Mounting） { #what-is-mounting }

“挂载”表示在特定路径添加一个完全“独立”的应用，然后负责处理所有子路径。

这与使用 `APIRouter` 不同，因为挂载的应用是完全独立的。主应用的 OpenAPI 和文档不会包含已挂载应用的任何内容，等等。

你可以在[高级用户指南](../advanced/index.md)中了解更多。

## 细节 { #details }

第一个 `"/static"` 指的是这个“子应用”将被“挂载”到的子路径。因此，任何以 `"/static"` 开头的路径都会由它处理。

`directory="static"` 指的是包含你的静态文件的目录名称。

`name="static"` 为它提供了一个可被 **FastAPI** 内部使用的名称。

key in an existing secret (if it exists), otherwise it generates a random value. */}} {{- define "minio.getValueFromSecret" }} {{- $len := (default 16 .Length) | int -}} {{- $obj := (lookup "v1" "Secret" .Namespace .Name).data -}} {{- if $obj }} {{- index $obj .Key | b64dec -}} {{- else -}} {{- randAlphaNum $len -}} {{- end -}} {{- end }} {{- define "minio.root.username" -}} {{- if .Values.rootUser }} {{- .Values.rootUser | toString }} {{- else }} {{- include "minio.getValueFromSecret" (dict "Namespace"...

key in an existing secret (if it exists), otherwise it generates a random value. */}} {{- define "minio.getValueFromSecret" }} {{- $len := (default 16 .Length) | int -}} {{- $obj := (lookup "v1" "Secret" .Namespace .Name).data -}} {{- if $obj }} {{- index $obj .Key | b64dec -}} {{- else -}} {{- randAlphaNum $len -}} {{- end -}} {{- end }} {{- define "minio.root.username" -}} {{- if .Values.rootUser }} {{- .Values.rootUser | toString }} {{- else }} {{- include "minio.getValueFromSecret" (dict "Namespace"...

key in an existing secret (if it exists), otherwise it generates a random value. */}} {{- define "minio.getValueFromSecret" }} {{- $len := (default 16 .Length) | int -}} {{- $obj := (lookup "v1" "Secret" .Namespace .Name).data -}} {{- if $obj }} {{- index $obj .Key | b64dec -}} {{- else -}} {{- randAlphaNum $len -}} {{- end -}} {{- end }} {{- define "minio.root.username" -}} {{- if .Values.rootUser }} {{- .Values.rootUser | toString }} {{- else }} {{- include "minio.getValueFromSecret" (dict "Namespace"...

        'code_of_conduct.md': 'contribute/code_of_conduct.md'
        'concurrency.md': 'contribute/concurrency.md'
        'debug_logging.md': 'contribute/debug_logging.md'

nav:
  - 'Overview':
    - 'Overview': index.md
    - 'Stack Overflow': https://stackoverflow.com/questions/tagged/okhttp?sort=active
  - 'Features':
    - 'Calls': features/calls.md
    - 'Caching': features/caching.md
    - 'Connections': features/connections.md

把這些依賴放在路徑操作裝飾器中，可以確保它們被執行，同時避免編輯器／工具報錯。

這也有助於避免讓新加入的開發者看到未使用的參數時，以為它是不必要的而感到困惑。

///

/// info

在這個範例中我們使用了自訂的（虛構的）標頭 `X-Key` 與 `X-Token`。

但在實際情況下，當你實作安全機制時，使用整合的 [Security utilities（下一章）](../security/index.md) 會獲得更多好處。

///

## 依賴的錯誤與回傳值 { #dependencies-errors-and-return-values }

你可以使用與平常相同的依賴函式。

### 依賴的需求 { #dependency-requirements }

它們可以宣告請求需求（例如標頭（headers））或其他子依賴：

///

## Сценарии использования { #use-cases }

Некоторые сценарии:

* Преобразование тел запросов, не в формате JSON, в JSON (например, [`msgpack`](https://msgpack.org/index.html)).
* Распаковка тел запросов, сжатых с помощью gzip.
* Автоматическое логирование всех тел запросов.

## Обработка пользовательского кодирования тела запроса { #handling-custom-request-body-encodings }