Cài đặt môi trường python/sphinx trên windows?

Question

Chúng tôi sử dụng Sphinx cho tài liệu trong môi trường python Linux/OSX của chúng tôi, nhưng chúng tôi có ai đó trên Windows, những người muốn có thể nhận được môi trường mà họ có thể chỉnh sửa và xây dựng tài liệu Sphinx.

Có thể thiết lập Nhân sư trên cửa sổ không? Tôi đoán phần cứng là cài đặt một môi trường python và tất cả các phụ thuộc, nhưng tôi có 0 kinh nghiệm với python trên windows để ai đó có thể chỉ cho tôi một cách đơn giản để tiếp tục.

Answer 1

Bạn có thể sử dụng pip-win ngay bây giờ để thiết lập nhân sư trong cửa sổ ảo trên cửa sổ một cách dễ dàng.

Trước tiên, tải xuống và cài đặt Python. Nếu bạn muốn sử dụng trình xây dựng latexpdf, bạn cũng sẽ cần phải cài đặt TeX Live hoặc MiKTeX cho các cửa sổ.

Tiếp theo, chạy pip-win.exe. Nó sẽ tự động kéo các yêu cầu thiết lập yêu cầu và cài đặt pip và virtualenv trên hệ thống của bạn. Khi tải nó sẽ kéo lên Python bạn vừa cài đặt, nhưng nếu bạn cài đặt nó ở một vị trí khác với thư mục mặc định, bạn có thể dễ dàng nhập đường dẫn tuyệt đối hoặc duyệt qua nó.

Tiếp theo, trong Command: dòng bạn có thể tạo một virtualenv mới bằng cách inputing:

venv -c C:\foo\sphinx-venv 

này sẽ mở một dấu nhắc lệnh với bạn bên virtualenv của bạn. Tiếp theo, bạn có thể cài đặt nhân sư bằng lệnh pip:

<sphinx-venv> C:\foo\> pip install sphinx 

Bây giờ nhân sư được cài đặt trên máy tính trong môi trường ảo của bạn. Bạn có thể sử dụng hủy kích hoạt để thoát khỏi môi trường mới của mình.

Khi bao giờ bạn muốn nhập virtualenv của bạn một lần nữa để xây dựng các dự án Sphinx hơn bạn có thể mở pip bên cùng có lợi và chạy:

venv C:\foo\sphinx-venv 

Hoặc bạn có thể tạo một tập tin tùy chỉnh python để kích hoạt môi trường sư của bạn và xây dựng tệp sphinx của bạn chẳng hạn như:

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

Answer 2

Để cài đặt python trên cửa sổ tải xuống Python. Chạy tệp thực thi và bạn đã sẵn sàng.

Nếu bạn có pip cài đặt sau đó bạn có thể mở cửa sổ lệnh và chỉ cần gõ

pip install -U Sphinx 

Nếu bạn không có pip cài đặt thì trước tiên bạn cần phải cài đặt nó bằng cách sử dụng lệnh sau tại dấu nhắc lệnh

python -m pip install -U pip 

Answer 3

Cách đơn giản nhất để sử dụng Python trên Windows là WinPython, phân phối di động đơn giản để sử dụng như bất kỳ ứng dụng di động. Nó sẽ cung cấp cho bạn một biểu tượng cho một dấu nhắc lệnh WinPython mà từ đó bạn có thể sử dụng pip, vv, như trên bất kỳ hệ thống nào khác (ví dụ linux), hoặc bạn có thể tải xuống các gói và cài đặt chúng bằng bảng điều khiển của WinPython.