Γράφοντας το πρώτο σας Django app, μέρος 6¶
Ο οδηγός αυτός ξεκινά εκεί που τελειώνει ο οδηγός 5. Έχουμε φτιάξει μια γεμάτη με τεστ εφαρμογή ψηφοφορίας (Web-poll) και τώρα θα βελτιώσουμε την εμφάνιση της προσθέτοντας ένα stylesheet (CSS) και μια εικόνα.
Πέρα από την HTML που παράγεται από τον server, τα web applications, σε γενικές γραμμές, χρειάζονται να κάνουν serve και πρόσθετα αρχεία — όπως εικόνες, γραμματοσειρές, JavaScript αρχεία, CSS κλπ — αρχεία απαραίτητα ούτως ώστε μια πλήρης ιστοσελίδα να γίνει render. Στο Django, αναφερόμαστε σε αυτά τα αρχεία ως «static files».
For small projects, this isn’t a big deal, because you can keep the static files somewhere your web server can find it. However, in bigger projects – especially those comprised of multiple apps – dealing with the multiple sets of static files provided by each application starts to get tricky.
Αυτό ακριβώς κάνει το django.contrib.staticfiles: συγκεντρώνει όλα τα static files από κάθε εφαρμογή σας (και οποιοδήποτε άλλο μέρος εσείς καθορίσετε) σε μια τοποθεσία (που εσείς πάλι καθορίζετε) από την οποία μπορούν εύκολα να γίνουν served σε παραγωγικό περιβάλλον (production).
Που να ψάξετε για βοήθεια
If you’re having trouble going through this tutorial, please head over to the Getting Help section of the FAQ.
Προσαρμογή της εμφάνισης της εφαρμογής σας¶
Πρώτα, δημιουργήστε ένα φάκελο με το όνομα static μέσα στο φάκελο polls (μέσα, δηλαδή, στην εφαρμογή σας). Το Django θα ψάξει για τυχόν static files μέσα εκεί, ομοίως όπως ψάχνει για templates μέσα στο φάκελο polls/templates/.
Η ρύθμιση του Django STATICFILES_FINDERS περιέχει μια λίστα από finders οι οποίοι γνωρίζουν πως να βρίσκουν τα static files από διάφορα μέρη. Μια από τις προεπιλογές είναι η AppDirectoriesFinder η οποία κοιτάζει να βρει έναν υπό-φάκελο με το όνομα «static» σε κάθε εφαρμογή η οποία συγκαταλέγεται στη λίστα της ρύθμισης INSTALLED_APPS (όπως ο υπό-φάκελος που μόλις δημιουργήσαμε μέσα στην εφαρμογή polls). Το admin site χρησιμοποιεί την ίδια αρχιτεκτονική φακέλων για τα δικά του static files.
Within the static directory you have just created, create another directory
called polls and within that create a file called style.css. In other
words, your stylesheet should be at polls/static/polls/style.css. Because
of how the AppDirectoriesFinder staticfile finder works, you can refer to
this static file in Django as polls/style.css, similar to how you reference
the path for templates.
Static file namespacing
Just like templates, we might be able to get away with putting our static
files directly in polls/static (rather than creating another polls
subdirectory), but it would actually be a bad idea. Django will choose the
first static file it finds whose name matches, and if you had a static file
with the same name in a different application, Django would be unable to
distinguish between them. We need to be able to point Django at the right
one, and the best way to ensure this is by namespacing them. That is, by
putting those static files inside another directory named for the
application itself.
Τοποθετήστε τον ακόλουθο κώδικα στο αρχείο CSS (polls/static/polls/style.css):
li a {
color: green;
}
Μετά, προσθέστε τα ακόλουθα στην αρχή του αρχείου polls/templates/polls/index.html:
{% load static %}
<link rel="stylesheet" type="text/css" href="{% static 'polls/style.css' %}">
Το template tag {% static %} παράγει το absolute URL των static files.
That’s all you need to do for development.
Start the server (or restart it if it’s already running):
$ python manage.py runserver
...\> py manage.py runserver
Reload http://localhost:8000/polls/ and you should see that the question
links are green (Django style!) which means that your stylesheet was properly
loaded.
Προσθέτοντας μια background-image¶
Επόμενο βήμα είναι να δημιουργήσουμε έναν υπό-φάκελο για τις εικόνες μας. Δημιουργήστε, λοιπόν, ένα φάκελο με το όνομα images στη διαδρομή polls/static/polls/. Μέσα σε αυτό το φάκελο αποθηκεύστε μια εικόνα με το όνομα background.gif. Με άλλα λόγια το full path της εικόνας θα είναι το polls/static/polls/images/background.gif.
Μετά προσθέστε στο CSS αρχείο σας τα παρακάτω (polls/static/polls/style.css):
body {
background: white url("images/background.gif") no-repeat;
}
Reload http://localhost:8000/polls/ and you should see the background
loaded in the top left of the screen.
Προειδοποίηση
Είναι προφανές ότι το template tag {% static %} δεν θα είναι διαθέσιμο για static files τα οποία δεν παράγονται από το Django. Θα πρέπει πάντα να χρησιμοποιείτε relative paths για να συνδέσετε μεταξύ τους τα static files. Αν το κάνετε αυτό θα μπορείτε, έπειτα, να αλλάζετε τη ρύθμιση STATIC_URL (η οποία χρησιμοποιείται από το static template tag για να δημιουργεί τα URLs) χωρίς να χρειαστεί να αλλάζετε ένα σωρό από μονοπάτια (paths) στα static files σας. Με άλλα λόγια μην χρησιμοποιείτε absolute paths για τα static files. Η δουλειά του {% static %} είναι να μετατρέπει τα relative paths σε absolute URLs.
Αυτά είναι τα βασικά. Για περισσότερες πληροφορίες σχετικά με τις ρυθμίσεις και άλλα εργαλεία τα οποία συμπεριλαμβάνονται στο Django δείτε στο άρθρο διαχείριση των static files και στο η εφαρμογή staticfiles. Το άρθρο production server και static files συζητά πως να χρησιμοποιήσετε τα static files σε ένα πραγματικό server.
Όταν είστε εξοικειωμένοι με τα static files, διαβάστε το έβδομο μέρος αυτού του οδηγού για να μάθετε περισσότερα με την παραμετροποίηση του διαχειριστικού site του Django (admin site) το οποίο δημιουργείται αυτόματα.
