Docutils là một gói tuyệt vời. Nếu bạn đang sử dụng Django, gói admindocs cần docutils. Hướng dẫn có sẵn để cài đặt với trình duyệt web, nhưng nếu bạn ở xa và đăng nhập bằng thiết bị đầu cuối qua SSH thì sao? Làm thế nào để cài đặt trong trường hợp đó? Điều gì nếu bạn chỉ muốn một công thức nhanh chóng để làm công việc với các thiết bị đầu cuối?Làm thế nào để bạn cài đặt Docutils từ Terminal để Django admindocs sẽ hoạt động?
Tôi biết mình khá muộn với câu hỏi này, nhưng câu trả lời được chấp nhận không thực sự phản ánh phổ biến best practices từ các thành viên cộng đồng Python (và thậm chí ít hơn so với các thành viên cộng đồng Django). công việc, đau đớn hơn nhiều và dễ bị lỗi hơn những điều sau đây:
Bạn thực sự nên sử dụng Pip. Với Pip lắp đặt hệ thống docutils rộng cũng đơn giản như:
$ sudo pip install docutils
Điều này không chỉ làm việc cho docutils nhưng gần như bất kỳ gói vào 'Cheese Shop' cũng như nhiều kho mã khác (Github, Bitbucket, vv)
Bạn cũng có thể muốn xem xét các công cụ thực hành Python phổ biến khác như virtualenv và virtualenvwrapper để bạn có thể tránh cài đặt gói toàn cầu.
Để cài đặt Pip trên Ubuntu/Debain Tôi thường làm như sau:
$ sudo apt-get install python-pip
BTW: cho virtualenv 'sudo apt-get install python-virtualenv' và cho virtualenvwrapper 'sudo apt-get install virtualenvwrapper' .
Chìa khóa để cài đặt là sử dụng tiện ích curl. Sau đây sẽ cài đặt docutils:
mkdir docutilsetup
cd docutilsetup
curl -o docutils-docutils.tar.gz http://docutils.svn.sourceforge.net/viewvc/docutils/trunk/docutils/?view=tar
gunzip docutils-docutils.tar.gz
tar -xf docutils-docutils.tar
cd docutils
sudo python setup.py install
Thực hiện các bước sau: Tạo thư mục để tải xuống tài liệu. cd vào thư mục vừa tạo và sử dụng curl để tải xuống phiên bản đã được nén của docutils. Giải nén tệp tạo thư mục con docutils. cd vào thư mục đó và cài đặt với quyền root.
Nếu bạn đang sử dụng Django, bạn sẽ phải khởi động lại Django để admindocs bắt đầu hoạt động.
Mặc dù điều này có hiệu quả, việc sử dụng pip hợp lý hơn nhiều của Beau sẽ sạch hơn và nhanh hơn nhiều. và theo quy ước python và django gần gũi hơn nhiều so với phương pháp này. –
Mặc dù không phải là thực hành tốt nhất, cộng với một cho nỗ lực. –
Cảm ơn rất nhiều vì đã giải thích các quy ước hợp lý trong phát triển Python và Django. Tôi đang chạy OS X Server 10.6.8. Python đã di chuyển một chút với bản nâng cấp lên 2.7. Tôi đã nhận thấy rằng các vị trí thư mục khác nhau không được đề cập trong các hướng dẫn tuyệt vời khác được tìm thấy trên web. Tuy nhiên với PIP là một tiêu chuẩn tôi sẽ bắt đầu sử dụng nó và di chuyển hoặc các thư mục liên kết tượng trưng khi cần thiết. Bump 1 cho trả lời tốt đẹp. – kd4ttc