dm.zdoc

dm.zdoc είναι ένα μικρό Python περιτύλιγμα γύρω pydoc να μπορεί να χρησιμοποιηθεί για Zope.
Σημείωση: Python εκδόσεις κάτω από 2.6 δεν έχουν καλή υποστήριξη για τα πακέτα ονομάτων σε pydoc. Ενώ η ίδια Zope δεν χρησιμοποιεί πακέτα ονομάτων πριν από την έκδοση 2.12 (που χρησιμοποιεί Python 2.6), σημαντικές εφαρμογές Zope (όπως το Plone), χρησιμοποιούν συσκευασίες ονομάτων. Σε αυτές τις περιπτώσεις, η τεκμηρίωση που παράγεται από pydoc (και κατ 'επέκταση zdoc) είναι ατελής.
Χρήση
zdoc μπορεί να χρησιμοποιηθεί είτε μέσω του dmzdoc σενάριο, μέσω της μονάδας εισαγωγής ή ενσωματώνονται σε ένα τρέξιμο Zope παράδειγμα.
Στις δύο πρώτες περιπτώσεις, μπορεί να χρειαστεί να ρυθμίσετε το Zope μεταβλητές περιβάλλοντος INSTANCE_HOME και SOFTWARE_HOME να πει zdoc όπου μπορούν να βρεθούν οι πηγές Zope.
Χρήση μέσω dmzdoc
Η dmzdoc σενάριο εγκαθίσταται όταν έχετε εγκαταστήσει setuptools.
Διαφορετικά, θα πρέπει να το εγκαταστήσετε μόνοι σας. Έχει το ακόλουθο περιεχόμενο:
dm.zdoc εισαγωγής? dm.zdoc.cli ()
dmzdoc έχει τις ίδιες ακριβώς επιλογές και παραμέτρους όπως pydoc, τεκμηριώνεται pydoc.
Χρήση μέσω της μονάδας εισαγωγής
Η μονάδα dm.zdoc καθορίζει τα ίδια αντικείμενα όπως pydoc, τεκμηριώνεται pydoc.
Ενσωματώνονται σε ένα τρέξιμο Zope παράδειγμα
Για αυτή τη χρήση, θα πρέπει να εγκαταστήσετε τη μονάδα στην εγκατάσταση σας Zope και ενεργοποιήστε configure.zcml του στο Zope εκκίνηση. Αυτό θα δώσει το "Zope Root Folder" The View@@zdoc που παρουσιάζει τα έγγραφα με τον ίδιο τρόπο όπως το διακομιστή pydoc http.
ΠΡΟΣΟΧΗ: Εκθέτοντας την τεκμηρίωση μιας παράδειγμα Zope με αυτόν τον τρόπο παρέχει λογικές ιδέες και θα μπορούσε να δώσει χάκερ πολύτιμες ενδείξεις για τις επιθέσεις. Πιθανόν, θα εγκαταστήσετε αυτό μόνο σε περιπτώσεις ανάπτυξης με περιορισμένη πρόσβαση

Τι είναι καινούργιο σε αυτή την έκδοση:.

• Υποστήριξη για & quot? ενσωματωθεί σε ένα runnging Zope παράδειγμα & quot? περίπτωση χρήσης

Απαιτήσεις :

• Python