Skip to content

README.md

Latest commit

 

History

History
266 lines (176 loc) · 16.9 KB

README.md

File metadata and controls

266 lines (176 loc) · 16.9 KB

Вашият първи проект с Django!

Част от тази глава е базирана на ръководства от Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).

Части от тази глава са базирани на django-marcador ръководство, лицензирано съгласно лиценза Creative Commons Attribution-ShareAlike 4.0 International. Ръководството на django-marcador е защитено с авторско право от Markus Zapke-Gründemann et al.

Ще създадем малък блог!

Първата стъпка е да започнете нов проект на Django. По принцип това означава, че ще изпълним някои скриптове, предоставени от Django, които ще създадат скелета на проект на Django за нас. Това е само куп директории и файлове, които ще използваме по-късно.

Имената на някои файлове и директории са много важни за Django. Не трябва да преименувате файловете, които предстои да създадем. Преместването им на друго място също не е добра идея. Django трябва да поддържа определена структура, за да може да намери важни неща.

Не забравяйте да стартирате всичко във virtualenv (виртуалната среда). Ако не видите префикс (myvenv) в конзолата си, трябва да активирате своята virtualenv. Обяснихме как да направим това в главата Инсталация на Django в частта Работа с virtualenv. Въвеждането myvenv\Scripts\activate`` в Windows или <0>source myvenv/bin/activate в Mac OS X или Linux ще направи това вместо вас.

Във вашата Mac OS X или Linux конзола трябва да изпълните следната команда. ** Не забравяйте да добавите точка . в края!**

{% filename %}command-line{% endfilename %}

(myvenv) ~/djangogirls$ django-admin startproject mysite .

Точката . е от решаващо значение, тъй като казва на скрипта да инсталира Django във вашата текуща директория (за която точката . е препратка).

Забележка Когато пишете командата по-горе, не забравяйте, че въвеждате само частта, която започва от django-admin. Частта (myvenv) ~/djangogirls$, показана тук, е само пример за подкана, която ще покани твоето въвеждане във твоя команден ред.

В Windows трябва да изпълните следната команда. (Не забравяйте да добавите точка . в края):

{% filename %}command-line{% endfilename %}

(myvenv) C:\Users\Name\djangogirls> django-admin.exe startproject mysite .

Точката . е от решаващо значение, тъй като казва на скрипта да инсталира Django във вашата текуща директория (за която точката . е препратка).

Забележка Когато пишете командата по-горе, не забравяйте, че въвеждате само частта, която започва от django-admin.exe. Частта (myvenv) C:\Users\Name\djangogirls>, показана тук, е само пример за подкана, която ще покани твоето въвеждане във твоя команден ред.

django-admin.py е скрипт, който ще създаде директории и файлове за вас. Сега трябва да имате структура на директория, която изглежда така:

djangogirls
├── manage.py
├── mysite
│   ├── asgi.py
│   ├── __init__.py
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
├── myvenv
│   └── ...
└── requirements.txt

Забележка: в структурата на вашата директория ще видите и вашата myvenv директория, която създадохме преди.

manage.py е скрипт, който помага при управлението на сайта. С него ще можем (освен всичко друго) да стартираме уеб сървър на нашия компютър, без да инсталираме нищо друго.

Файлът settings.py съдържа конфигурацията на вашия уебсайт.

Спомняте ли си, когато говорихме за пощенски превозвач, проверяващ къде да достави писмо? urls.py файлът съдържа списък от модели, използвани от urlresolver.

За сега игнорираме останалите файлове, тъй като няма да ги променяме. Единственото нещо, което трябва да запомните, е да не ги изтриете случайно!

Промяна на настройките

Нека направим някои промени в mysite/settings.py. Отворете файла с помощта на редактора на кода, който сте инсталирали по-рано.

Забележка: Имайте предвид, че settings.py е обикновен файл, като всеки друг. Можете да го отворите от редактора на кода, като използвате "file -> open" от менюто. Това трябва да ви изведе обичайния прозорец, в който можете да се придвижите до вашия файл settings.py и да го изберете. Освен това можете да отворите файла, като отворите папката djangogirls на вашия работен плот и щракнете с десния бутон върху него. След това изберете редактора на кода от списъка. Изборът на редактора е важен, тъй като може да имате инсталирани други програми, които могат да отворят файла, но няма да ви позволят да го редактирате.

Би било хубаво да имаме точното време на нашия уебсайт. Отидете в списъка на часовите зони на Wikipedia и копирайте съответната часова зона (ЧЗ) (напр. Европа/Берлин).

В settings.py намерете реда, който съдържа TIME_ZONE и го модифицирайте, за да изберете своя собствена часова зона. Например:

{% filename %}mysite/settings.py{% endfilename %}

TIME_ZONE = 'Europe/Berlin'

Езиков код се състои от езика, напр. en за английски или de за немски, и кодът на държавата, напр. de за Германия или ch за Швейцария. Ако английският не е вашият роден език, можете да добавите това, за да промените бутоните по подразбиране и известията от Django, за да бъдат на вашия език. Така че ще имате бутон „Отказ“, преведен на езика, който сте дефинирали тук. Django comes with a lot of prepared translations.

Ако искате друг език, променете езиковия код, като промените следния ред:

{% filename %}mysite/settings.py{% endfilename %}

LANGUAGE_CODE = 'de-ch'

Ще трябва също да добавим път за статични файлове. (Ще разберем всичко за статичните файлове и CSS по-късно в ръководството.) Слезте до края на файла и точно под надписа STATIC_URL добавете нов, наречен STATIC_ROOT:

{% filename %}mysite/settings.py{% endfilename %}

STATIC_URL = '/static/'
STATIC_ROOT = BASE_DIR / 'static'

Когато DEBUG е True и ALLOWED_HOSTS е празен, хостът е валидиран срещу ['localhost', '127.0.0.1', '[::1]']. Това няма да съвпада с името на хоста ни в PythonAnywhere, след като разширим нашето приложение, така че ще променим следната настройка:

{% filename %}mysite/settings.py{% endfilename %}

ALLOWED_HOSTS = ['127.0.0.1', '.pythonanywhere.com']

Забележка: Ако използвате Chromebook, добавете този ред в долната част на вашия settings.py файл:    MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'

Също така добавете .amazonaws.com към ALLOWED_HOSTS, ако използвате cloud9

If you are hosting your project on Glitch.com, let us protect the Django secret key that needs to remain confidential (otherwise, anyone remixing your project could see it):

  • First, we are going to create a random secret key. Open the Glitch terminal again, and type the following command:

    {% filename %}command-line{% endfilename %}

    python -c 'from django.core.management.utils import get_random_secret_key; \
      print(get_random_secret_key())'

    This should display a long random string, perfect to use as a secret key for your brand new Django web site. We will now paste this key into a .env file that Glitch will only show you if you are the owner of the web site.

  • Create a file .env at the root of your project and add the following property in it:

    {% filename %}.env{% endfilename %}

    # Here, inside the single quotes, you can cut and paste the random key generated above
SECRET='3!0k#7ds5mp^-x$lqs2%le6v97h#@xopab&oj5y7d=hxe511jl'

  • Then update the Django settings file to inject this secret value and set the Django web site name:

    {% filename %}mysite/settings.py{% endfilename %}

    import os

SECRET_KEY = os.getenv('SECRET')

  • And a little further down in the same file, we inject the name of your new Glitch website:

    {% filename %}mysite/settings.py{% endfilename %}

    ALLOWED_HOSTS = [os.getenv('PROJECT_DOMAIN') + ".glitch.me"]

    The PROJECT_DOMAIN value is automatically generated by Glitch. It will correspond to the name of your project.

Създаване на база данни

Има много различни софтуерни бази данни, които могат да съхраняват данни за вашия сайт. Ще използваме тази по подразбиране sqlite3.

Това вече е настроено в тази част на вашия mysite/settings.py файл:

{% filename %}mysite/settings.py{% endfilename %}

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': BASE_DIR / 'db.sqlite3',
    }
}

За да създадем база данни за нашия блог, нека пуснем следното в конзолата: python manage.py migrate (трябва да бъдем в директорията djangogirls, която съдържа manage.py файл). Ако това върви добре, трябва да видите нещо подобно:

{% filename %}command-line{% endfilename %}

(myvenv) ~/djangogirls$ python manage.py migrate
Operations to perform:
  Apply all migrations: admin, auth, contenttypes, sessions
Running migrations:
  Applying contenttypes.0001_initial... OK
  Applying auth.0001_initial... OK
  Applying admin.0001_initial... OK
  Applying admin.0002_logentry_remove_auto_add... OK
  Applying admin.0003_logentry_add_action_flag_choices... OK
  Applying contenttypes.0002_remove_content_type_name... OK
  Applying auth.0002_alter_permission_name_max_length... OK
  Applying auth.0003_alter_user_email_max_length... OK
  Applying auth.0004_alter_user_username_opts... OK
  Applying auth.0005_alter_user_last_login_null... OK
  Applying auth.0006_require_contenttypes_0002... OK
  Applying auth.0007_alter_validators_add_error_messages... OK
  Applying auth.0008_alter_user_username_max_length... OK
  Applying auth.0009_alter_user_last_name_max_length... OK
  Applying auth.0010_alter_group_name_max_length... OK
  Applying auth.0011_update_proxy_permissions... OK
  Applying auth.0012_alter_user_first_name_max_length... OK
  Applying sessions.0001_initial... OK

И ние сме готови! Време е да стартирате уеб сървъра и да видите дали уебсайтът ни работи!

Стартиране на уеб сървъра

Трябва да сте в директорията, която съдържа файла manage.py (директорията djangogirls). В конзолата можем да стартираме уеб сървъра, като пуснем python manage.py runserver:

{% filename %}command-line{% endfilename %}

(myvenv) ~/djangogirls$ python manage.py runserver

Ако сте на Chromebook, използвайте вместо това тази команда:

{% filename %}Cloud 9{% endfilename %}

(myvenv) ~/djangogirls$ python manage.py runserver 0.0.0.0:8080

or this one if you are using Glitch:

{% filename %}Glitch.com terminal{% endfilename %}

$ refresh

If you are on Windows and this fails with UnicodeDecodeError, use this command instead:

{% filename %}command-line{% endfilename %}

(myvenv) ~/djangogirls$ python manage.py runserver 0:8000

Now you need to check that your website is running. Open your browser (Firefox, Chrome, Safari, Internet Explorer or whatever you use) and enter this address:

{% filename %}browser{% endfilename %}

http://127.0.0.1:8000/

If you're using a Chromebook and Cloud9, instead click the URL in the pop-up window that should have appeared in the upper right corner of the command window where the web server is running. The URL will look something like:

{% filename %}browser{% endfilename %}

https://<a bunch of letters and numbers>.vfs.cloud9.us-west-2.amazonaws.com

or on Glitch:

https://name-of-your-glitch-project.glitch.me

Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?

Install worked!

Note that a command window can only run one thing at a time, and the command window you opened earlier is running the web server. As long as the web server is running and waiting for additional incoming requests, the terminal will accept new text but will not execute new commands.

Прегледахме как работят уеб сървърите в главата Как работи Интернет.

To type additional commands while the web server is running, open a new terminal window and activate your virtualenv -- to review instructions on how to open a second terminal window, see Introduction to the command line. To stop the web server, switch back to the window in which it's running and press CTRL+C - Control and C keys together (on Windows, you might have to press Ctrl+Break).

Ready for the next step? It's time to create some content!