Мы используем Sphinx для документации в нашей среде Python / Linux / OSX, но у нас есть кто-то в Windows, кто хотел бы могут получить среду, в которой они могут редактировать и создавать документацию Sphinx.
Можно ли настроить Sphinx на windows? Я предполагаю, что самая сложная часть - это установка среды python и всех зависимостей, но у меня нет опыта работы с python в Windows, поэтому кто-то может указать мне простой способ продолжить.
Для установки Python в Windows загрузите Python. Запустите исполняемый файл, и все готово.
Если у вас установлен pip, вы можете открыть командную строку и просто ввести
pip install -U Sphinx
Если у вас не установлен pip, вам сначала необходимо установить его, используя следующую команду в командной строке
python -m pip install -U pip
Теперь вы можете использовать pip-win, чтобы настроить sphinx в virtualenv на окнах легко.
Сначала загрузите и установите Python. Если вы хотите использовать конструктор latexpdf, вам также потребуется установить TeX Live или MiKTeX для Windows.
Затем запустите pip-win.exe. Он автоматически загрузит необходимые инструменты установки и установит pip и virtualenv в вашей системе. При загрузке он вытащит только что установленный Python, но если вы установили его не в каталог по умолчанию, вы можете легко ввести абсолютный путь или найти его.
Затем в строке Command: вы можете создать новый virtualenv, введя:
venv -c C:\foo\sphinx-venv
Это откроет командную строку с вами внутри вашего virtualenv. После этого вы можете установить sphinx с помощью команды pip:
<sphinx-venv> C:\foo\> pip install sphinx
Теперь sphinx установлен на вашем компьютере с Windows в виртуальной среде. Вы можете использовать деактивировать, чтобы выйти из новой среды.
Когда вы когда-нибудь захотите снова войти в свой virtualenv, чтобы создать больше проектов sphinx, вы можете открыть pip-win и запустить:
venv C:\foo\sphinx-venv
Или вы можете создать собственный файл python, чтобы активировать среду sphinx и создать файл sphinx, например:
import os
os.system("cmd /c \"CALL C:\\foo\\sphinx-venv\\Scripts\\activate.bat && make html\"")
Самым простым способом использования Python в Windows является WinPython, переносимый дистрибутив, который так же просто использовать как любое другое портативное приложение. Он даст вам значок для командной строки WinPython, из которой вы можете использовать pip и т. Д., Как если бы в любой другой системе (например, Linux), или вы можете загружать пакеты и устанавливать их с помощью панели управления WinPython.
