Ответ 1
Я обычно использую встроенный pydoc, если вы находитесь в окнах, он должен называться Document Docs, если вы используете Linux pydoc -p 8000
и подключиться через браузер.
Является ли это просто мной, или документация по стандартной библиотеке python чрезвычайно трудно просмотреть?
Java имеет свой блестящий Javadocs, Ruby имеет полезный Ruby-Docs, только в python. Я не могу найти хороший способ навигации по стандартной библиотечной документации.
Вот проект Epydoc, который выглядит красиво, но кто-нибудь знает, действительно ли он используется в стандартной библиотеке, поэтому мы все могут пройти через это? Если нет, то какие альтернативы люди используют для просмотра документации python.
Я обычно использую встроенный pydoc, если вы находитесь в окнах, он должен называться Document Docs, если вы используете Linux pydoc -p 8000
и подключиться через браузер.
pydoc
из командной строки, help()
из приглашения интерактивного интерпретатора.
pydoc -p 8080
Сообщество python является полу-враждебным к автоматически созданной документации, особенно если оно ориентировано на объект. Python не просто объектно ориентирован (это язык с несколькими парадигмами), поэтому разработчики Python обычно предпочитают документацию, написанную человеком. Иногда функции важны, иногда важна структура класса.
вы можете перейти к здесь и загрузить версию chm версии Python 3.1. При этом поиск в документах должен быть легким.
Раньше я использовал боковую панель python от Edgewall.
В эти дни я google для функции python (стандартные документы почти всегда отображаются как первая ссылка). Если я хочу просмотреть источник модуля (иногда полезно), я использую эту небольшую функцию оболочки, которую я написал.
epy () {
cmd="import $1 as a ; print a.__file__.endswith('.pyc') and a.__file__[:-1] or a.__file__"
file=$(/usr/bin/env python -c $cmd)
echo $file
emacsclient --no-wait $file
}
Наверное, я собираюсь получить downvoted, но я не вижу ничего плохого в документах Sphinx, и я нахожу их намного лучше, чем альтернатива java.