Guía de inicio de Django: Configura rápidamente tu primer sitio web

2/20/2026
6 min read

Guía de inicio de Django: Configura rápidamente tu primer sitio web

Django es un marco de desarrollo web de Python eficiente y potente, adecuado para construir aplicaciones web y sitios complejos. Este marco integra muchas funciones útiles, lo que permite a los desarrolladores construir aplicaciones robustas rápidamente. Ya seas un principiante o un desarrollador con cierta experiencia, Django puede ofrecerte muchas comodidades. En este artículo, te enseñaremos, a través de pasos concretos, cómo usar Django para configurar tu primer sitio web.

1. Preparación del entorno

Antes de comenzar, asegúrate de que tu entorno de desarrollo tenga instalado Python y pip (la herramienta de gestión de paquetes de Python). Django requiere Python 3.6 o superior.

Instalación de Python y pip

Puedes descargar e instalar la versión adecuada para tu sistema operativo desde la página oficial de Python. Después de la instalación, verifica la versión de Python y pip a través de la línea de comandos:

python --version
pip --version

Instalación de Django

Instalar Django a través de pip es muy sencillo. Escribe el siguiente comando en la línea de comandos:

pip install django

Una vez completada la instalación, asegúrate de que puedes encontrar la versión de Django en la línea de comandos:

django-admin --version

2. Crear un proyecto Django

Una vez que Django esté instalado, podemos comenzar a crear un nuevo proyecto. Un proyecto es la estructura básica de Django, que contiene tus aplicaciones y configuraciones.

Crear un proyecto

En el directorio donde deseas crear el proyecto, ejecuta el siguiente comando:

django-admin startproject myproject

Esto creará un nuevo directorio llamado myproject, que contiene algunos archivos y una estructura de directorios predeterminada.

Estructura del directorio

Verás la siguiente estructura de directorios:

myproject/
    manage.py
    myproject/
        __init__.py
        settings.py
        urls.py
        asgi.py
        wsgi.py
  • manage.py: Herramienta de gestión de Django, utilizada para administrar el proyecto.
  • settings.py: Archivo de configuración del proyecto, donde puedes configurar la base de datos, archivos estáticos, etc.
  • urls.py: Configuración de las rutas URL del proyecto.
  • asgi.py y wsgi.py: Configuraciones de interfaz para el despliegue.

3. Ejecutar el servidor de desarrollo

En el directorio del proyecto, utiliza el siguiente comando para iniciar el servidor de desarrollo de Django:

python manage.py runserver

Si todo está bien, deberías poder acceder a la página de bienvenida de Django en el navegador en http://127.0.0.1:8000/.

4. Crear la primera aplicación

Un proyecto de Django puede constar de múltiples aplicaciones. Cada aplicación es responsable de un módulo funcional específico.

Crear una aplicación

En el directorio myproject, ejecuta el siguiente comando para crear una aplicación llamada myapp:

python manage.py startapp myapp

Esto creará un nuevo directorio myapp en tu directorio de proyecto, con una estructura similar a:

myapp/
    migrations/
    __init__.py
    admin.py
    apps.py
    models.py
    tests.py
    views.py

Modificar settings.py

En settings.py, registra tu aplicación. Encuentra la lista INSTALLED_APPS y añade 'myapp',:

INSTALLED_APPS = [
    ...
    'myapp',
]

5. Crear vistas y plantillas

Django utiliza el patrón MVC, donde las vistas y las plantillas se complementan entre sí.

Crear vistas

Define una vista simple en myapp/views.py:

from django.http import HttpResponse

def home(request):
    return HttpResponse("Hello, Django!")

Configurar URL

Crea un archivo llamado urls.py en el directorio myapp y configura las rutas de URL:

from django.urls import path
from . import views

urlpatterns = [
    path('', views.home, name='home'),
]

Luego, importa la URL de myapp en el urls.py del proyecto:

from django.contrib import admin
from django.urls import include, path

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', include('myapp.urls')),
]

6. Accede a tu página

Ahora, puedes reiniciar el servidor de desarrollo y acceder a http://127.0.0.1:8000/. Deberías ver el mensaje "Hello, Django!".

7. Agregar soporte para bases de datos

Django utiliza SQLite como base de datos por defecto, pero también soporta otras bases de datos como MySQL y PostgreSQL. A continuación se muestra cómo configurar SQLite.

Configuración de la base de datos

En settings.py, encuentra la sección DATABASES, la configuración por defecto se ve así:

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

Puedes modificarla según sea necesario para usar otra base de datos. Por ejemplo, para usar PostgreSQL:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'yourdbname',
        'USER': 'yourusername',
        'PASSWORD': 'yourpassword',
        'HOST': 'localhost',
        'PORT': '5432',
    }
}

Asegúrate de instalar el controlador de base de datos correspondiente, por ejemplo, para PostgreSQL, necesitas instalar psycopg2.

pip install psycopg2

8. Crear modelos y migrar la base de datos

A continuación, definiremos un modelo simple y lo migramos a la base de datos.

Crear modelo

Agrega el siguiente código en myapp/models.py para definir un modelo simple:```python from django.db import models

class Item(models.Model): name = models.CharField(max_length=100) description = models.TextField()

def __str__(self):
    return self.name

### Generar migraciones

Ejecuta el siguiente comando para generar archivos de migración de la base de datos:

```bash
python manage.py makemigrations

Luego, aplica estas migraciones:

python manage.py migrate

9. Crear interfaz de administrador

Django viene con una poderosa interfaz de administrador que facilita la gestión de datos.

Crear superusuario

Crea una cuenta de administrador con el siguiente comando:

python manage.py createsuperuser

Agregar modelo a la interfaz de administrador

Registra tu modelo en myapp/admin.py:

from django.contrib import admin
from .models import Item

admin.site.register(Item)

Ahora vuelve a ejecutar el servidor de desarrollo, visita http://127.0.0.1:8000/admin, inicia sesión con el superusuario creado y podrás ver el modelo que acabas de registrar.

Conclusión

Django es un potente marco de desarrollo web que puede ayudarte a construir aplicaciones web rápidamente. A través de los métodos descritos en este artículo, puedes configurar fácilmente un sitio web simple de Django y expandir sus funcionalidades. A medida que profundices en Django, podrás explorar características más avanzadas, como la autenticación de usuarios, API RESTful, pruebas, etc. ¡Espero que esta guía para principiantes te ayude a dar el primer paso y comiences tu viaje con Django!

Published in Technology

You Might Also Like