Έχετε, λοιπόν, διαβάσει όλο το εισαγωγικό κομμάτι (Ξεκινώντας) και αποφασίσατε ότι θέλετε να χρησιμοποιήσετε το Django. Το μόνο που κάναμε στην εισαγωγή ήταν να ξύσουμε την επιφάνεια (στην πραγματικότητα, αν διαβάσατε κάθε λέξη, έχετε καλύψει μόλις το 5% του συνόλου του εγχειριδίου του Django).
\nΕπόμενα βήματα;
\nΑνέκαθεν ήμασταν φαν της λογικής ‘μαθαίνω μέσα από πράξεις’. Μέχρι αυτό το σημείο γνωρίζετε αρκετά για να ξεκινήσετε ένα project μόνοι σας και να παίξετε λίγο μαζί του. Όταν θελήσετε να μάθετε νέες τεχνικές-κόλπα δεν έχετε παρά να επισκεφτείτε το documentation του Django.
\nWe’ve put a lot of effort into making Django’s documentation useful, clear and\nas complete as possible. The rest of this document explains more about how the\ndocumentation works so that you can get the most out of it.
\n(Ναι! Αυτό είναι ένα documentation για το documentation. Μείνετε ήσυχοι όμως, δεν σκοπεύουμε να αφιερώσουμε ολόκληρο άρθρο στο πως να διαβάσετε ένα documentation.)
\nDjango’s got a lot of documentation – almost 450,000 words and counting –\nso finding what you need can sometimes be tricky. A good place to start\nis the Ευρετήριο. We also recommend using the builtin search feature.
\nΉ, απλά, μπορείτε να περιηγηθείτε σε ολόκληρο το site!
\nΤο βασικό documentation του Django είναι χωρισμένο σε «chunks» (κομμάτια) τα οποία έχουν σχεδιαστεί να εξυπηρετούν διαφορετικούς σκοπούς:
\nThe introductory material is designed for people new\nto Django – or to web development in general. It doesn’t cover anything\nin depth, but instead gives a high-level overview of how developing in\nDjango «feels».
Από την άλλη, το άρθρο Χρησιμοποιώντας το Django, βουτάει βαθιά στις επιμέρους οντότητες του Django. Υπάρχουν πλήρης οδηγοί (guides) στα σύστημα μοντέλων, template engine, framework για φόρμες και πολλά άλλα.
\nΤον περισσότερο χρόνο σας θα τον περάσετε διαβάζοντας και ξαναδιαβάζοντας τους παραπάνω οδηγούς. Όταν τους κατανοήσετε τότε θα ξέρετε (σχεδόν τα πάντα για) το πως λειτουργεί το Django.
\nΤο Web development είναι συχνά αχανές και όχι βαθύ – τα προβλήματα που προκύπτουν αφορούν διάφορους τομείς. Έχουμε γράψει ένα σετ από οδηγούς how-to οι οποίοι απαντούν κοινές ερωτήσεις του τύπου «Πως να …?». Εδώ θα βρείτε πληροφορίες σχετικά με τη δημιουργία PDFs με το Django, σύνταξη δικών σας template tags και πολλά άλλα.
\nΑπαντήσεις σε πραγματικά συχνές ερωτήσεις μπορείτε να βρείτε (που αλλού) στις Συχνές ερωτήσεις (FAQ).
\nΟι οδηγοί και τα how-to δεν καλύπτουν κάθε κλάση, συνάρτηση και μέθοδο διαθέσιμη στο Django – αυτό μπορεί να γίνει εκνευριστικό όταν προσπαθείτε να μάθετε κάτι καινούργιο. Αντιθέτως, οι λεπτομέρειες σχετικά με κλάσεις, συναρτήσεις, μεθόδους και modules κρατούνται στο άρθρο αναφορά. Εκεί θα βρείτε το οτιδήποτε αφορά μια συγκεκριμένη συνάρτηση ή οτιδήποτε άλλο σχετικό.
Αν ενδιαφέρεστε να κάνετε deploy ένα project για δημόσια χρήση (με άλλα λόγια να ανεβάσετε το project σας σε κάποιον πραγματικό server), παρέχουμε αρκετούς οδηγούς για διάφορα deployment περιβάλλοντα, όπως επίσης και μια deployment checklist για μερικά πράγματα που πρέπει να λάβετε υπόψιν σας προτού “ανεβάσετε” το project σας.
Finally, there’s some «specialized» documentation not usually relevant to\nmost developers. This includes the release notes and\ninternals documentation for those who want to add\ncode to Django itself, and a few other things that don’t fit elsewhere.
Όπως ακριβώς ο πηγαίος κώδικας του Django αναπτύσσεται και βελτιώνεται καθημερινώς, έτσι και το documentation μας συνεχώς βελτιώνεται. Βελτιώνουμε το documentation για πολλούς λόγους:
\nΔιορθώνουμε το περιεχόμενο, όπως γραμματικά/τυπογραφικά λάθη.
Προσθέτουμε πληροφορίες και/ή παραδείγματα σε κάποια κομμάτια τα οποία χρειάζονται επέκταση.
Συμπεριλαμβάνουμε στο εγχειρίδιο τα Django features τα οποία λείπουν. (Η λίστα αυτών των features μειώνεται αλλά δεν παύει να υπάρχει.)
Εμπλουτίζουμε το εγχειρίδιο για να συμπεριληφθούν τα νέα features που προστίθενται ή όταν αλλάζουν τα Django APIs ή κάποιες συμπεριφορές.
Django’s documentation is kept in the same source control system as its code. It\nlives in the docs directory of our Git repository. Each document\nonline is a separate text file in the repository.
\nΜπορείτε να διαβάσετε το Django documentation με αρκετούς τρόπους. Με σειρά προτίμησης, είναι οι εξής:
\nThe most recent version of the Django documentation lives at\nhttps://docs.djangoproject.com/en/dev/. These HTML pages are generated\nautomatically from the text files in source control. That means they reflect the\n«latest and greatest» in Django – they include the very latest corrections and\nadditions, and they discuss the latest Django features, which may only be\navailable to users of the Django development version. (See\nΔιαφορές μεταξύ εκδόσεων below.)
\nΠαρακαλούμε αν έχετε τυχόν αλλαγές, διορθώσεις ή προτάσεις που αφορούν το documentation να τις καταθέσετε στο ticket system προκειμένου να συμβάλλετε στην βελτίωση του. Οι Django developers παρακολουθούν το ticket system και χρησιμοποιούν το δικό σας feedback για να βελτιώσουν το documentation προς όφελος όλων.
\nΩστόσο, σημειώστε, ότι τα tickets θα πρέπει να συσχετίζονται με το documentation και όχι με κάποια τεχνική υποστήριξη. Αν χρειάζεστε βοήθεια με τη δική σας Django εγκατάσταση, δοκιμάστε τη mailing list των django-users ή το κανάλι #django IRC channel.
\nΓια ανάγνωση χωρίς να είστε συνδεδεμένοι στο internet ή απλά για δική σας διευκόλυνση, μπορείτε να διαβάσετε το documentation του Django σε απλό κείμενο.
\nIf you’re using an official release of Django, the zipped package (tarball) of\nthe code includes a docs/ directory, which contains all the documentation\nfor that release.
If you’re using the development version of Django (aka the main branch), the\ndocs/ directory contains all of the documentation. You can update your\nGit checkout to get the latest changes.
Ένας low-level τρόπος να επωφεληθείτε από το documentation σε μορφή κειμένου είναι χρησιμοποιώντας την εντολή του Unix grep. Η εντολή αυτή σας επιτρέπει να ψάξετε κάποια φράση σε ολόκληρο το documentation. Για παράδειγμα, η παρακάτω εντολή θα ψάξει σε κάθε άρθρο του documentation και θα σας δείξει όλες τις αναφορές σχετικά με τη λέξη «max_length»:
Linux / macOS
$ grep -r max_length /path/to/django/docs/\nWindows
...\\> grep -r max_length \\path\\to\\django\\docs\\\nYou can get a local copy of the HTML documentation following a few steps:
\nΤο documentation του Django χρησιμοποιεί ένα σύστημα που ονομάζεται Sphinx προκειμένου να μετατρέψει το απλό κείμενο σε HTML. Θα χρειαστεί να εγκαταστήσετε το Sphinx είτε κατεβάζοντας το απ’ την επίσημη ιστοσελίδα και έπειτα εγκαθιστώντας το ή χρησιμοποιώντας το pip:
Linux / macOS
$ python -m pip install Sphinx\nWindows
...\\> py -m pip install Sphinx\nThen, use the included Makefile to turn the documentation into HTML:
$ cd path/to/django/docs\n$ make html\nΘα χρειαστεί να έχετε εγκατεστημένο το GNU Make για να δουλέψει.
\nΑν χρησιμοποιείτε Windows μπορείτε, εναλλακτικά, να χρησιμοποιήσετε το συμπεριλαμβανόμενο batch αρχείο:
\ncd path\\to\\django\\docs\nmake.bat html\nΗ όλη διαδικασία με το Sphinx θα δουλέψει για εκδόσεις μεγαλύτερες ή ίσης της 0.6, αλλά προτείνουμε να χρησιμοποιήσετε το Sphinx 1.0.2 ή νεώτερο.
The text documentation in the main branch of the Git repository contains the\n«latest and greatest» changes and additions. These changes include\ndocumentation of new features targeted for Django’s next feature\nrelease. For that reason, it’s worth pointing out our policy\nto highlight recent changes and additions to Django.
\nΑκολουθούμε την παρακάτω πολιτική:
\nThe development documentation at https://docs.djangoproject.com/en/dev/ is\nfrom the main branch. These docs correspond to the latest feature release,\nplus whatever features have been added/changed in the framework since then.
As we add features to Django’s development version, we update the\ndocumentation in the same Git commit transaction.
To distinguish feature changes/additions in the docs, we use the phrase:\n«New in Django Development version» for the version of Django that hasn’t\nbeen released yet, or «New in version X.Y» for released versions.
Documentation fixes and improvements may be backported to the last release\nbranch, at the discretion of the merger, however, once a version of Django is\nno longer supported, that version of the\ndocs won’t get any further updates.
The main documentation web page includes links to documentation for\nprevious versions. Be sure you are using the version of the docs\ncorresponding to the version of Django you are using!