Установка среды python / sphinx на Windows?

Question

Мы используем Sphinx для документации в нашей среде Python для Linux / OSX, но у нас есть кто-то в Windows, кто хотел бы иметь возможность получить среду, в которой он может редактировать и создавать документацию Sphinx.

Возможно ли настроить Sphinx на windows? Я предполагаю, что самая сложная часть - это установка среды Python и всех зависимостей, но у меня 0 опыта работы с Python на Windows, так что кто-то может указать мне простой способ продолжения.

Answer 1

Для установки python на windows скачайте Python . Запустите исполняемый файл, и все готово.

Если у вас установлено pip , вы можете открыть командную строку и просто набрать

pip install -U Sphinx

Если у вас не установлен pip , сначала необходимо установить его, используя следующую команду в командной строке

python -m pip install -U pip

Answer 2

Самым простым способом использования Python в Windows является WinPython , который является переносимым дистрибутивом, который так же прост в использовании, как и любое другое переносимое приложение. Он выдаст вам значок для командной строки WinPython, из которого вы можете использовать pip и т. Д., Как в любой другой системе (например, linux), или вы можете скачать пакеты и установить их с помощью панели управления WinPython.

Answer 3

Вы можете использовать pip-win сейчас, чтобы легко настроить sphinx в virtualenv для Windows.

Сначала загрузите и установите 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 и запустить:Вы можете создать собственный файл Python для активации вашей среды sphinx и создать свой файл sphinx, например:

import os
os.system("cmd /c \"CALL C:\\foo\\sphinx-venv\\Scripts\\activate.bat && make html\"")