# Τεκμηρίωση του Django - 5.2.8

# How to manage static files (e.g. images, JavaScript, CSS)

Websites generally need to serve additional files such as images, JavaScript, or CSS. In Django, we refer to these files as «static files». Django provides `django.contrib.staticfiles` to help you manage them.

Η σελίδα αυτή περιγράφει πως μπορείτε να εξυπηρετήσετε τέτοιου είδους αρχεία, static files.

## Ρυθμίζοντας τα static files

1. Βεβαιωθείτε ότι η εφαρμογή `django.contrib.staticfiles` συμπεριλαμβάνεται στη ρύθμιση `INSTALLED_APPS`.

2. Στο γενικό αρχείο ρυθμίσεων σας, settings file, δώστε μια τιμή, string, στη μεταβλητή :STATIC_URL. Για παράδειγμα:

       STATIC_URL = "static/"

3. In your templates, use the `static` template tag to build the URL for the given relative path using the configured `staticfiles` `STORAGES` alias.

       {% load static %}
       <img src="{% static 'my_app/example.jpg' %}" alt="My image">

4. Αποθηκεύστε τα static files σας σε έναν φάκελο που ονομάζεται `static` μέσα στην εκάστοτε εφαρμογή σας. Για παράδειγμα `my_app/static/my_app/myimage.jpg`.

Εξυπηρετώντας τα αχεία

Πέρα από τις ανωτέρω ρυθμίσεις, θα χρειαστεί, επίσης, να εξυπηρετήσετε αυτά τα static files.

Κατά τη διάρκεια του development, αν χρησιμοποιείτε την εφαρμογή `django.contrib.staticfiles`, η εξυπηρέτηση των static files θα γίνει αυτόματα από το `runserver` όταν, φυσικά, το `DEBUG` είναι `True` (δείτε τη συνάρτηση `django.contrib.staticfiles.views.serve()`).

Αυτή η μέθοδος είναι εντελώς αναποτελεσματική και πιθανόν μη ασφαλής, κάτι που την καθιστά ακατάλληλη για την παραγωγή.

Δείτε στο άρθρο ανεβάζοντας τα static files για τις σωστές στρατηγικές εξυπηρέτησης των static files σε παραγωγικά περιβάλλοντα.

Το project σας θα έχει, πιθανόν και κάποια static files τα οποία δεν θα συνδέονται με κάποια συγκεκριμένη εφαρμογή. Αν θέλετε να εξυπηρετήσετε στατικά αρχεία τα οποία θα είναι καθολικά για όλο το project σας, εκτός της δημιουργίας του φακέλου `static/` μέσα σε κάθε εφαρμογή σας, μπορείτε να ορίσετε μια λίστα από φακέλους (`STATICFILES_DIRS`) μέσα στο γενικό αρχείο ρυθμίσεων σας, settings file, όπου το Django θα κοιτάξει, επίσης, για επιπρόσθετα static files. Για παράδειγμα:

    STATICFILES_DIRS = [
        BASE_DIR / "static",
        "/var/www/static/",
    ]

Δείτε το εγχειρίδιο για τη ρύθμιση `STATICFILES_FINDERS` για περισσότερες πληροφορίες σχετικά με το πως η εφαρμογή `staticfiles` βρίσκει τα αρχεία σας.

Static file namespacing

Now we might be able to get away with putting our static files directly in `my_app/static/` (rather than creating another `my_app` subdirectory), but it would actually be a bad idea. Django will use 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.

You can namespace static assets in `STATICFILES_DIRS` by specifying prefixes.

## Εξυπηρετώντας τα static files κατά τη διάρκεια του development

Αν χρησιμοποιείτε την εφαρμογή `django.contrib.staticfiles` όπως περιγράφηκε παραπάνω, η εντολή `runserver` θα εξυπηρετήσει τα static files αυτόματα αν το `DEBUG` είναι `True`. Αν δεν έχετε την εφαρμογή `django.contrib.staticfiles` μέσα στη ρύθμιση `INSTALLED_APPS`, μπορείτε ακόμη να τα εξυπηρετήσετε, χειροκίνητα, χρησιμοποιώντας το view `django.views.static.serve()`.

Αυτό, φυσικά, δεν είναι κατάλληλο για την παραγωγή (όταν δηλαδή το site σας είναι στον αέρα, διαθέσιμο για το ευρύ κοινό)! Για μερικές κοινές deployment στρατηγικές δείτε στο άρθρο ανεβάζοντας τα static files.

For example, if your `STATIC_URL` is defined as `static/`, you can do this by adding the following snippet to your `urls.py`:

    from django.conf import settings
    from django.conf.urls.static import static

    urlpatterns = [
        # ... the rest of your URLconf goes here ...
    ] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)

Σημείωση

This helper function works only in debug mode and only if the given prefix is local (e.g. `static/`) and not a URL (e.g. `http://static.example.com/`).

Επίσης, αυτή η βοηθητική συνάρτηση εξυπηρετεί μόνο το φάκελο `STATIC_ROOT`. Δεν πραγματοποιεί την πραγματική αναζήτηση των static files, όπως κάνει η εφαρμογή `django.contrib.staticfiles`.

Finally, static files are served via a wrapper at the WSGI application layer. As a consequence, static files requests do not pass through the normal middleware chain.

## Εξυπηρετώντας αρχεία τα οποία ανέβηκαν από έναν χρήστη κατά τη διάρκεια του development

Στο Django, τα αρχεία που ανεβαίνουν στον server σας από κάποιον χρήστη (ή από τον admin μέσω του `django.contrib.admin`) ονομάζονται media files ή media assets και γι” αυτό το λόγο υπάρχει ένας διαχωρισμός μεταξύ των μεταβλητών στις ρυθμίσεις, πχ `MEDIA_ROOT`, `MEDIA_URL`, `STATIC_ROOT` και `STATIC_URL`. Κατά τη διάρκεια του development, μπορείτε να εξυπηρετήσετε τα media files που ανέβηκαν από κάποιον χρήστη μέσω της ρύθμισης `MEDIA_ROOT` χρησιμοποιώντας το view `django.contrib.staticfiles.views.serve()`.

Αυτό, φυσικά, δεν είναι κατάλληλο για την παραγωγή (όταν δηλαδή το site σας είναι στον αέρα, διαθέσιμο για το ευρύ κοινό)! Για μερικές κοινές deployment στρατηγικές δείτε στο άρθρο ανεβάζοντας τα static files.

For example, if your `MEDIA_URL` is defined as `media/`, you can do this by adding the following snippet to your `ROOT_URLCONF`:

    from django.conf import settings
    from django.conf.urls.static import static

    urlpatterns = [
        # ... the rest of your URLconf goes here ...
    ] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

Σημείωση

This helper function works only in debug mode and only if the given prefix is local (e.g. `media/`) and not a URL (e.g. `http://media.example.com/`).

## Τεστ

Όταν τρέχετε τα τεστ τα οποία χρησιμοποιούν πραγματικά HTTP requests αντί του προεγκατεστημένου testing client (πχ όταν χρησιμοποιείτε την κλάση `LiveServerTestCase`), τα static files θα χρειαστεί να εξυπηρετηθούν μαζί με το υπόλοιπο περιεχόμενο, προκειμένου το περιβάλλον του τεστ σας να αναπαράγει το πραγματικό περιβάλλον όσο πιο πιστά γίνεται. Αλλά η κλάση `LiveServerTestCase` παρέχει μια πολύ βασική λειτουργία εξυπηρέτησης των static files: Δεν γνωρίζει τίποτα σχετικά με τη λειτουργία των finders της εφαρμογής `staticfiles` και προϋποθέτει ότι τα static files έχουν ήδη συγκεντρωθεί μέσα στο φάκελο `STATIC_ROOT`.

Εξαιτίας αυτού, η εφαρμογή `staticfiles` έρχεται με μια δική της κλάση `django.contrib.staticfiles.testing.StaticLiveServerTestCase`, μια subclass της προεγκατεστημένης, η οποία έχει τη δυνατότητα να εξυπηρετεί με έναν παρόμοιο τρόπο με αυτόν που τρέχουμε κατά τη διάρκεια του development όταν το `DEBUG = True`, διαφανώς, όλα τα assets κατά τη διάρκεια εκτέλεσης αυτών των τεστ, πχ χωρίς να χρειαστεί να τα συγκεντρώνουμε πρώτα, χρησιμοποιώντας την εντολή `collectstatic`.

## Deployment

Η εφαρμογή `django.contrib.staticfiles` παρέχει μια βολική διαχειριστική εντολή για να συγκεντρώσει (collect) όλα τα static files σε ένα μόνο φάκελο ούτως ώστε να τα εξυπηρετήσετε εύκολα.

1. Θέστε τη ρύθμιση `STATIC_ROOT` στον φάκελο από τον οποίο θα θέλετε να εξυπηρετήσετε αυτά τα αρχεία. Για παράδειγμα:

       STATIC_ROOT = "/var/www/example.com/static/"

2. Run the `collectstatic` management command:

       $ python manage.py collectstatic

   Η εντολή αυτή θα αντιγράψει όλα τα αρχεία από τους επιμέρους φακέλους με το όνομα `static` (αν υπάρχουν) κάθε εφαρμογής και όλα τα αρχεία στους φακέλους που περιέχονται στη ρύθμιση `STATICFILES_DIRS` στον έναν και μοναδικό φάκελο `STATIC_ROOT`.

3. Χρησιμοποιήστε έναν Web server της επιλογής σας για να εξυπηρετήσετε αυτά τα αρχεία. Το άρθρο ανεβάζοντας τα static files καλύπτει μερικές κοινές deployment στρατηγικές για τα static files.

## Μάθετε περισσότερα

Αυτό το άρθρο κάλυψε τα βασικά και μερικές συνηθισμένες πρακτικές. Για πλήρεις λεπτομέρειες πάνω σε όλες τις ρυθμίσεις, εντολές, template tags και άλλα κομμάτια που περιέχονται στο `django.contrib.staticfiles`, δείτε στο άρθρο αναφορά στα staticfiles.