EvoBGP/docs/OPENAPI-GITEA.md

Как смотреть API-документацию (Gitea без встроенного OpenAPI)

В веб-интерфейсе Gitea файлы из репозитория показываются как исходный текст (в т.ч. HTML) — это нормально: страница в браузере не выполняется из просмотра кода.

Самый простой способ

1. Откройте в репозитории файл docs/openapi.html.
2. Нажмите Скачать (или откройте ссылку Raw и сохраните файл как openapi.html).
3. Откройте сохранённый файл двойным щелчком в браузере.

В openapi.html уже встроен движок Redoc (отдельный интернет для скрипта не нужен).

Если хотите открывать по ссылке Raw в браузере

Нужно, чтобы Gitea отдавал HTML с типом text/html, а не text/plain. Администратор может добавить в app.ini:

[download.mimetype.mapping]
.html=text/html

После перезапуска Gitea ссылка Raw на docs/openapi.html может открываться как обычная страница (зависит от версии и политики nosniff).

Пересборка после правок openapi.yaml

Из корня репозитория:

.\scripts\build-openapi-html.ps1

Или вручную: npx @redocly/cli@1 build-docs docs/openapi.yaml -o docs/openapi.html, затем встроить redoc.standalone.js по аналогии со скриптом.

Источник правды по контракту API — docs/openapi.yaml (OpenAPI 3.1).