Как внести вклад

Этот гид находится в активной разработке. Если вы хотите внести вклад, пожалуйста, ознакомьтесь с:

https://docs.python-guide.org/notes/contribute/

Как тестировать ваши изменения

Версия HTML этого гида создается с помощью sphinx. Вы можете локально протестировать ваши изменения, установив sphinx. Это можно сделать легко с помощью pip (как описано в ссылке).

pip install --user sphinx

Затем перейдите в директорию Makefile и выполните команды make build или make html. Sphinx сгенерирует HTML в папке _build/html/

После перехода в эту папку, вы можете использовать встроенный веб-сервер Python для просмотра ваших локальных изменений:

python3 -m http.server

По умолчанию, http.server прослушивает все IP-адреса, привязанные к вашему хосту, на порту 8000. Чтобы привязать к определенному IP-адресу, например, localhost на порту 8005:

python3 -m http.server 8005 --bind 127.0.0.1

Руководство по стилю

Для всех вкладов, пожалуйста, следуйте Руководству по стилю:

https://docs.python-guide.org/notes/styleguide/