testmu.png...

greptile.png...

image01.png...

greptile-banner.png...

app = FastAPI()


@app.get(
    "/items/{item_id}",
    response_model=Item,
    responses={**responses, 200: {"content": {"image/png": {}}}},
)
async def read_item(item_id: str, img: bool | None = None):
    if img:
        return FileResponse("image.png", media_type="image/png")
    else:

    exit 1
  fi
  tmp_png_prefix=/tmp/thumbnail.png.$$
  pdftoppm -png -singlefile ${tmp_pdf_file} ${tmp_png_prefix}
  tmp_png_file="${tmp_png_prefix}.png"
  rm -f ${tmp_pdf_file}
  if [[ ! -f ${tmp_png_file} ]] ; then
    echo "pdftoppm does not work."
    exit 1
  fi
  ${im_cmd} -thumbnail ${image_size} ${tmp_png_file} "${output_file}"
  rm -f ${tmp_png_prefix}*png
elif [[ x"${cmd_type}" = "xpdf" ]] ; then

설정을 변경하지 않으면, 기본적으로 구문 강조 기능이 활성화되어 있습니다:

<img src="/img/tutorial/extending-openapi/image02.png">

그러나 `syntaxHighlight`를 `False`로 설정하여 구문 강조 기능을 비활성화할 수 있습니다:

{* ../../docs_src/configure_swagger_ui/tutorial001_py310.py hl[3] *}

...그럼 Swagger UI에서 더 이상 구문 강조 기능이 표시되지 않습니다:

<img src="/img/tutorial/extending-openapi/image03.png">

## 테마 변경 { #change-the-theme }

<img src="/img/tutorial/generate-clients/image02.png">

보낼 페이로드에 대해서도 자동 완성이 제공됩니다:

<img src="/img/tutorial/generate-clients/image03.png">

/// tip | 팁

`name`과 `price`에 대한 자동 완성은 FastAPI 애플리케이션에서 `Item` 모델에 정의된 내용입니다.

///

전송하는 데이터에 대해 인라인 오류도 표시됩니다:

<img src="/img/tutorial/generate-clients/image04.png">

응답 객체도 자동 완성을 제공합니다:

The JSON Schemas of your models will be part of your OpenAPI generated schema, and will be shown in the interactive API docs:

<img src="/img/tutorial/body/image01.png">

And will also be used in the API docs inside each *path operation* that needs them:

<img src="/img/tutorial/body/image02.png">

## Editor support { #editor-support }

例如，你可以在 Swagger UI 中停用語法醒目提示（syntax highlighting）。

不更動設定時，語法醒目提示預設為啟用：

<img src="/img/tutorial/extending-openapi/image02.png">

但你可以將 `syntaxHighlight` 設為 `False` 來停用它：

{* ../../docs_src/configure_swagger_ui/tutorial001_py310.py hl[3] *}

...然後 Swagger UI 就不會再顯示語法醒目提示：

<img src="/img/tutorial/extending-openapi/image03.png">

## 更換主題 { #change-the-theme }

同樣地，你可以用鍵 `"syntaxHighlight.theme"` 設定語法醒目提示主題（注意中間有一個點）：