2010-04-05 35 views
26

Trong nhiều dự án django, trong thư mục tài liệu, tôi có thể xem các tệp * .rst:Làm thế nào để duyệt (không có trình soạn thảo văn bản) .rst tệp?

Cách tốt nhất để duyệt qua chúng (không sử dụng trình soạn thảo văn bản)?

Có thể tạo HTML không?

+1

Bạn có thể vui lòng chỉnh sửa mô tả để mở rộng trên "không sử dụng trình chỉnh sửa văn bản của khóa học" không? Điều đó có vẻ là một cách tốt, và lý do của bạn để từ chối nó không rõ ràng. – bignose

Trả lời

25

.rst tệp có định dạng ReStructuredText. Chúng trông giống như các tệp văn bản, nhưng có thể được kết xuất thành HTML với gói Python docutils.

1

This page mô tả cách xây dựng tài liệu riêng của Django thành HTML, qua thư viện Sphinx. Các dự án khác có thể sẽ hoạt động theo cùng một cách.

+0

https://docs.djangoproject.com/en/1.8/internals/contributing/writing-documentation/ –

5

Hãy thử restview

+10

Trong khi điều này về mặt lý thuyết có thể trả lời câu hỏi, [nó sẽ là thích hợp hơn] (http://meta.stackexchange.com/q/8259) để bao gồm các phần thiết yếu của câu trả lời ở đây và cung cấp liên kết để tham khảo. –

11

Như Zjk nói, bạn có thể sử dụng restview:

restview có sẵn từ Python Package Index: http://pypi.python.org/pypi/restview. Bạn cũng có thể cài đặt pip restview.

Dưới đây là những gì tôi đã làm để kiểm tra nó bằng cách sử dụng một môi trường ảo:

mkdir restview 
cd restview/ 
virtualenv-2.7 venv # The second system I used just used 'virtualenv venv' 
./venv/bin/pip install restview 
./venv/bin/restview ~/path/MANUAL.rst 

này tung ra một máy chủ web và mở trang tài liệu trong trình duyệt của mình.

Lưu ý: Tôi chỉ sử dụng virtualenv vì tôi không thích cài đặt mọi thứ trên toàn cầu. Nó có thể là quá mức cần thiết cho nhiều người khác, nhưng tôi cũng có may mắn hơn với những môi trường một lần này. Khi tôi đã thử pip install restview trên một máy ảo Ubuntu 14.04 nó không thành công, trong khi cách tiếp cận trên làm việc như một say mê cho tôi trên hệ thống đó cũng như điều này.

-3

chỉ cần đổi tên phần mở rộng tệp thành .txt và sau đó bạn mở tệp bằng bất kỳ trình chỉnh sửa văn bản nào.

Mọi người có xu hướng đặt đường viền và chướng ngại vật để che giấu kiến ​​thức của họ - một khoảng thời gian.

Các vấn đề liên quan