📱Linklint.

Linklint — это полезное расширение для Sphinx и консольный линтер, который очищает вашу Python-документацию от избыточных и отвлекающих ссылок.

Когда документация разрастается, в .rst файлах часто скапливается визуальный шум: ссылки, ведущие сами на себя, или десятки одинаковых ссылок в одном абзаце. Linklint решает эту проблему элегантно и без лишних усилий.

🔹Главные фичи (проверки):

🔘self: находит ссылки, которые ведут на свой же раздел. Например, если в описании класса вы используете :class: для ссылки на этот же класс, инструмент сделает её обычным текстом, так как она никуда вас не уведет.

🔘paradup: ищет дублирующиеся ссылки внутри одного абзаца. Первая ссылка остается активной, а все последующие отключаются, чтобы не отвлекать читателя.

⚙️Два режима работы:

🔘Расширение Sphinx: Идеальный вариант. Просто добавьте "linklint.ext" в ваш conf.py. Инструмент очистит лишние ссылки на этапе сборки документации, вообще не изменяя ваши исходные файлы.

🔘CLI-линтер: Можно запустить в терминале (например, linklint --fix files...), чтобы он нашел избыточные вызовы и жестко зафиксировал изменения прямо в коде, добавив восклицательный знак (превратив :func:foo в :func:!foo).

💡Интересный факт: Инструмент активно развивается (последняя версия 0.4.1 вышла в марте 2026 года и поддерживает Sphinx 8.x/9.x). При прогоне через документацию самого CPython, Linklint автоматически убрал более 3600 лишних ссылок!

#Python #Sphinx #Documentation #DevTools #OpenSource #Linklint

📱Ссылка на репозиторий:
https://github.com/nedbat/linklint