¡Tu primer proyecto en Django!

Parte de este capítulo está basado en los tutoriales de Geek Girls Carrots (http://django.carrots.pl/).

Parte de este capítulo está basado en el tutorial django-marcador bajo licencia de Creative Commons Attribution-ShareAlike 4.0 internacional. El tutorial de django-marcador tiene derechos de autor de Markus Zapke-Gündemann et al.

¡Vamos a crear un blog sencillo!

El primer paso es iniciar un nuevo proyecto de Django. Básicamente, significa que vamos a lanzar unos scripts proporcionados por Django que nos crearán el esqueleto de un proyecto de Django. Son solo un montón de directorios y archivos que usaremos más tarde.

Los nombres de algunos archivos y directorios son muy importantes para Django. No deberías renombrar los archivos que estamos a punto de crear. Moverlos a un lugar diferente tampoco es buena idea. Django necesita mantener una cierta estructura para poder encontrar cosas importantes.

Recuerda ejecutar todo en el virtualenv. Si no ves un prefijo (myvenv) en tu consola necesitas activar tu virtualenv. Explicamos cómo hacerlo en el capítulo de Instalación de Django en la sección Trabajar con virtualenv. Basta con escribir myvenv\Scripts\activate en Windows o source myvenv/bin/activate en Mac OS X o Linux.

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

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

django-admin es un script que creará los archivos y directorios para ti. Ahora deberías tener una estructura de directorios parecida a esta:

djangogirls
├───manage.py
└───mysite
        settings.py
        urls.py
        wsgi.py
        __init__.py

Nota: en la estructura de tus directorios también verás un directorio llamado venv que creamos anteriormente.

manage.py es un script que ayuda con la administración del sitio. Con él podremos (entre otras cosas) iniciar un servidor web en nuestra computadora sin necesidad de instalar nada más.

El archivo settings.py contiene la configuración de tu sitio web.

¿Recuerdas cuando hablamos de una cartera que debía comprobar dónde entregar una carta? El archivo urls.py contiene una lista de los patrones utilizados por urlresolver.

Por ahora vamos a ignorar el resto de archivos porque no los vamos a cambiar. ¡Sólo acuérdate de no borrarlos accidentalmente!

Cambiar la configuración

Vamos a hacer algunos cambios en mysite/settings.py. Abre el archivo usando el editor de código que has instalado anteriormente.

Nota: ten en cuenta que settings.py es un archivo regular, como cualquier otro. Puedes abrirlo desde el editor de código, usando las acciones del menú "Archivo -> Abrir". Esto te debería mostrar una ventana en la que puedes navegar hacia tu archivo settings.py y seleccionarlo. Alternativamente, puedes abrir el archivo navegando a la carpeta de djangogirls en tu escritorio y haciendo botón derecho en él. Luego, debes seleccionar tu editor de código de la lista de opciones. Seleccionar el editor de código es importante debido a que puedes tener otros programas instalados que pueden abrir el archivo, pero no te dejarán editarlo.

Sería bueno tener el horario correcto en nuestro sitio web. Ve a la lista de husos horarios de Wikipedia y copia tu zona horaria (TZ). (por ejemplo, Europe/Berlin )

En settings.py, encuentra la línea que contiene TIME_ZONE y modifícala para elegir tu zona horaria. Por ejemplo:

mysite/settings.py

TIME_ZONE = 'Europe/Berlin'

Un código de lenguaje consiste en el lenguaje (por ejemplo en es para inglés or de para alemán) y en el código del país (por ejemplo, de para alemania o ch para suiza). Querrás agregar esto si quieres que los botones y las notificaciones de Django estén en tu idioma. Así tendrás el botón "Cancel" traducido al idioma definido aquí. Django viene con un montón de traducciones preparadas.

Cambia el código de lenguaje modificando la siguiente línea:

mysite/settings.py

LANGUAGE_CODE = 'de-ch'

También necesitaremos agregar una ruta para los archivos estáticos (aprenderemos todo sobre los archivos estáticos y CSS más tarde en este tutorial). Ve hacia abajo hasta el final del archivo, y justo por debajo de la línea de STATIC_URL, agrega una nueva línea con STATIC_ROOT:

mysite/settings.py

STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR, 'static')

Cuando DEBUG está en True y ALLOWED_HOSTS está vacío, el host es validado entre ['localhost', '127.0.0.1', '[::1]']. Esto no coincidirá con nuestro nombre de host en PythonAnywhere una vez que despleguemos nuestra aplicación, así cambiémoslo a lo siguiente:

mysite/settings.py

ALLOWED_HOSTS = ['127.0.0.1', '<tu-usuario>.pythonanywhere.com']

Nota: Si estás utilizando una Chromebook, agrega esta línea al final de tu archivo settings.py: MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'

Agrega también django-girls-<tu-usuario>.c9users.io a ALLOWED_HOSTS si estás utilizando cloud9

Configurar una base de datos

Hay una gran variedad de opciones de bases de datos para almacenar los datos de tu sitio. Utilizaremos la que viene por defecto, sqlite3.

Esta ya está configurado en esta parte de tu archivo mysite/settings.py:

mysite/settings.py

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
    }
}

Para crear una base de datos para nuestro blog, ejecutemos lo siguiente en la consola: python manage.py migrate (necesitamos estar en el directorio de djangogirls que contiene el archivo manage.py). Si eso va bien, deberías ver algo así:

Terminal

(myvenv) ~/djangogirls$ python manage.py migrate
Operations to perform:
  Apply all migrations: auth, admin, contenttypes, sessions
Running migrations:
  Rendering model states... DONE
  Applying contenttypes.0001_initial... OK
  Applying auth.0001_initial... OK
  Applying admin.0001_initial... OK
  Applying admin.0002_logentry_remove_auto_add... 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 sessions.0001_initial... OK

Y, ¡terminamos! Es hora de iniciar el servidor web y ver si está funcionando nuestro sitio web!

Iniciar el servidor web

Debes estar en el directorio que contiene el archivo manage.py (en la carpeta djangogirls). En la consola, podemos iniciar el servidor web ejecutando python manage.py runserver:

Terminal

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

Si estás en una Chromebook, usa este comando en cambio:

Cloud 9

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

Si estás en Windows y te falla con un error UnicodeDecodeError, utiliza en su lugar este comando:

Terminal

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

Ahora todo lo que necesitas hacer es comprobar que tu sitio se esté ejecutando. Abre el navegador (Firefox, Chrome, Safari, Internet Explorer o el que utilices) y escribe la dirección:

browser

http://127.0.0.1:8000/

Si estás en una Chromebook, siempre deberás visituar tu servidor de pruebas accediendo así:

browser

https://django-girls-<your cloud9 username>.c9users.io

¡Felicitaciones! ¡Has creado tu primer sitio web y lo has iniciado usando un servidor web! ¿No es genial?

Mientras el servidor web esté corriendo, no verás un nuevo prompt en la línea de comandos para ingresar más comandos. La terminal aceptará nuevo texto ingresado pero no ejecutará los comandos. Esto es porque el servidor web se ejecuta constantemente para escuchar nuevas las nuevas peticiones que ingresen.

Hemos visto como funcionan los servidor web en el capítulo ¿Cómo funciona internet?

Para escribir más comandos mientras el servidor web está funcionando, abre una nueva consola y activa el virtualenv. Para parar el servidor web, pasa a la ventana donde se esté ejecutando y pulsa Ctrl+C, las teclas Control y C a la vez (en Windows puede que tengas que pulsar Ctrl+Pausa).

¿Preparada para el próximo paso? ¡Es momento de crear algo de contenido!