dm.zdoc

dm.zdoc là một wrapper Python nhỏ xung quanh pydoc để làm cho nó có thể sử dụng cho Zope.
Lưu ý: phiên bản Python dưới 2.6 không hỗ trợ tốt cho các gói không gian tên trong pydoc. Trong khi Zope tự nó không sử dụng các gói namespace trước khi phiên bản 2.12 (trong đó sử dụng Python 2.6), các ứng dụng Zope quan trọng (như Plone) không sử dụng gói namespace. Trong những trường hợp này, các tài liệu hướng dẫn sản xuất bởi pydoc (và mở rộng zdoc) là không đầy đủ.
Cách sử dụng
zdoc hoặc có thể được sử dụng thông qua dmzdoc kịch bản, thông qua nhập khẩu phân hoặc tích hợp trong một Zope dụ chạy.
Trong hai trường hợp đầu tiên nó có thể là cần thiết để thiết lập các biến môi trường Zope INSTANCE_HOME và SOFTWARE_HOME nói zdoc nơi các nguồn Zope có thể được tìm thấy.
Sử dụng thông qua dmzdoc
Các dmzdoc kịch bản được cài đặt khi bạn có setuptools cài đặt.
Nếu không, bạn phải cài đặt nó. Nó có các nội dung sau đây:
dm.zdoc nhập khẩu; dm.zdoc.cli ()
dmzdoc có các lựa chọn chính xác và các thông số như pydoc, tài liệu trong pydoc.
Sử dụng mô-đun thông qua nhập khẩu
Các mô-đun dm.zdoc xác định các đối tượng giống như pydoc, tài liệu trong pydoc.
Tích hợp trong một Zope dụ chạy
Đối với việc sử dụng này, bạn phải cài đặt các module cài đặt Zope và kích hoạt configure.zcml tại Zope khởi động. Điều này sẽ cung cấp cho các "Zope thư mục gốc" quan điểm@@zdoc đó trình bày các tài liệu trong cùng một cách như các máy chủ pydoc http.
Chú ý: Phơi bày các tài liệu của một trường Zope theo cách này cung cấp những hiểu biết hợp lý và có thể cung cấp cho tin tặc manh mối có giá trị cho các cuộc tấn công. Khả năng, bạn sẽ cài đặt này chỉ trong trường hợp phát triển với giới hạn truy cập

là gì mới trong phiên bản này:.

• Hỗ trợ các & quot; tích hợp trong một runnging Zope dụ & quot; trường hợp sử dụng

Yêu cầu :

• Python