Aprendamos mediante el ejemplo.
\nA través de este tutorial le mostraremos cómo crear una aplicación de encuestas básica.
\nConsistirá de dos partes:
\nUn sitio público que le permite a las personas ver sondeos y votar en ellos.
Un sitio administrativo que le permite añadir, modificar y borrar sondeos.
Asumiremos que ya ha instalado Django. Puede ver si Django está instalado, así como su versión, ejecutando el siguiente comando (señalado por el prefijo $):
\nLinux / macOS
$ python -m django --version\nWindows
...\\> py -m django --version\nSi Django está instalado, debería ver la versión de su instalación. Si no es así, obtendrá un error indicando que «No existe el módulo llamado Django».
\nThis tutorial is written for Django 3.1, which supports Python 3.6 and\nlater. If the Django version doesn’t match, you can refer to the tutorial for\nyour version of Django by using the version switcher at the bottom right corner\nof this page, or update Django to the newest version. If you’re using an older\nversion of Python, check ¿Qué versión de Python puedo usar con Django? to find a compatible\nversion of Django.
\nConsulte Cómo instalar Django para obtener información sobre cómo desinstalar versiones anteriores de Django e instalar una versión más reciente.
\n\nSi esta es la primera vez que utiliza Django, tendrá que hacerse cargo de ciertas configuraciones iniciales. Concretamente, tendrá que autogenerar un código que establezca un Django project – un conjunto de ajustes para una instancia de Django, incluida la configuración de la base de datos, opciones específicas de Django y configuraciones específicas de la aplicación.
\nDesde la línea de comandos, cambie a un directorio donde le gustaría almacenar su código, luego, ejecute el siguiente comando:
\nLinux / macOS
$ django-admin startproject mysite\nWindows
...\\> django-admin startproject mysite\nEsto creará un directorio mysite en su directorio actual. Si no funcionó, consulte Problemas ejecutando django-admin.
Veamos lo que el comando startproject creó:
mysite/\n manage.py\n mysite/\n __init__.py\n settings.py\n urls.py\n asgi.py\n wsgi.py\nEstos archivos son:
\nThe outer mysite/ root directory is a container for your project. Its\nname doesn’t matter to Django; you can rename it to anything you like.
manage.py: Una utilidad de la línea de comandos que le permite interactuar con este proyecto Django de diferentes formas. Puede leer todos los detalles sobre :archivo:`manage.py` en el :doc: :/ref/django-admin.
En interior del directorio mysite/ es el propio paquete de Python para su proyecto. Su nombre es el nombre del paquete de Python que usted tendrá que utilizar para importar todo dentro de este (por ejemplo, mysite.urls).
mysite/__init__.py: Un archivo vacío que le indica a Python que este directorio debería ser considerado como un paquete Python. Si usted es un principiante lea más sobre los paquetes en la documentación oficial de Python.
mysite/settings.py: Ajustes/configuración para este proyecto Django. Django settings le indicará todo sobre cómo funciona la configuración.
mysite/urls.py: Las declaraciones URL para este proyecto Django; una «tabla de contenidos» de su sitio basado en Django. Puede leer más sobre las URLs en URL dispatcher.
mysite/asgi.py: An entry-point for ASGI-compatible web servers to\nserve your project. See How to deploy with ASGI for more details.
mysite/wsgi.py: Un punto de entrada para que los servidores web compatibles con WSGI puedan servir su proyecto. Consulte :doc:`/howto/deployment/wsgi/index`para más detalles.
Comprobemos que su proyecto Django funciona. Cambie al directorio externo mysite, si todavía no lo ha hecho, y ejecute los siguientes comandos:
Linux / macOS
$ python manage.py runserver\nWindows
...\\> py manage.py runserver\nVerá la siguiente salida en la línea de comandos:
\nPerforming system checks...\n\nSystem check identified no issues (0 silenced).\n\nYou have unapplied migrations; your app may not work properly until they are applied.\nRun 'python manage.py migrate' to apply them.\n\n09 de agosto de 2026 - 15:50:53\nDjango version 3.1, using settings 'mysite.settings'\nStarting development server at http://127.0.0.1:8000/\nQuit the server with CONTROL-C.\n\n
Usted ha iniciado el servidor en desarrollo de Django, un servidor web ligero escrito puramente en Python. Lo hemos incluido con Django para que pueda desarrollar cosas rápidamente sin tener que lidiar con la configuración de un servidor en producción, como Apache, hasta que esté listo para la producción.
\nAhora es un buen momento para tener en cuenta que: no debe utilizar este servidor en algo parecido a un entorno de producción. Está pensado sólo para usarse durante el desarrollo (nuestro trabajo es crear frameworks Web , no servidores web.)
\nAhora que el servidor está funcionando, visite http://127.0.0.1:8000/ con su navegador Web. Verá la página «Felicitaciones!», con un cohete despegando. ¡Funcionó!
\n\n\nAhora que su entorno (un «proyecto») se ha configurado, ya está listo para empezar a trabajar.
\nCada aplicación que usted escribe en Django consiste en un paquete de Python que sigue una determinada convención. Django tiene una utilidad que genera automáticamente la estructura básica de directorios de una aplicación, por lo que usted puede centrarse en la escritura de código en lugar de crear directorios.
\n\nYour apps can live anywhere on your Python path. In\nthis tutorial, we’ll create our poll app in the same directory as your\nmanage.py file so that it can be imported as its own top-level module,\nrather than a submodule of mysite.
Para crear su aplicación, asegúrese de que está en el mismo directorio que el archivo manage.py y escriba este comando:
Linux / macOS
$ python manage.py startapp polls\nWindows
...\\> py manage.py startapp polls\nEso va a crear un directorio polls que se presenta de la siguiente forma:
polls/\n __init__.py\n admin.py\n apps.py\n migrations/\n __init__.py\n models.py\n tests.py\n views.py\nEsta estructura de directorios almacenará la aplicación encuesta.
\nVamos a escribir la primera vista. Abra el archivo polls/views.py y ponga el siguiente código Python en ella:
from django.http import HttpResponse\n\n\ndef index(request):\n return HttpResponse("Hello, world. You're at the polls index.")\nEsta es la vista más simple posible en Django. Para llamar la vista, tenemos que asignarla a una URL y para ello necesitamos una URLconf.
\nPara crear una URLconf en el directorio encuestas, cree un archivo llamado urls.py. El directorio de su aplicación debe verse así:
polls/\n __init__.py\n admin.py\n apps.py\n migrations/\n __init__.py\n models.py\n tests.py\n urls.py\n views.py\nIncluya el siguiente código en el archivo polls/urls.py:
from django.urls import path\n\nfrom . import views\n\nurlpatterns = [\n path('', views.index, name='index'),\n]\nEl siguiente paso es señalar la URLconf raíz en el módulo polls.urls. En mysite/urls.py añada un import para django.urls.include e inserte una include() en la lista urlpatterns , para obtener:
from django.contrib import admin\nfrom django.urls import include, path\n\nurlpatterns = [\n path('polls/', include('polls.urls')),\n path('admin/', admin.site.urls),\n]\nLa función include() permite hacer referencia a otros URLconfs. Cada vez que Django encuentra include() corta cualquier parte de la URL que coincide hasta ese punto y envía la cadena restante a la URLconf incluida para seguir el proceso.
La idea detrás de include() es facilitar la conexión y ejecución inmediata de las URLs. Dado que las encuestas están en su propia URLconf (polls/urls.py) se pueden ubicar en «/polls/», «/fun_polls /», «/content/polls/» o en cualquier otra ruta raíz , y la aplicación todavía seguirá funcionando.
You have now wired an index view into the URLconf. Verify it’s working with\nthe following command:
Linux / macOS
$ python manage.py runserver\nWindows
...\\> py manage.py runserver\nVaya a http://localhost:8000/polls/ en su navegador, y usted debería ver el texto «Hello, world. You’re at the polls index.» el cual definió en la vista index.
La path() función recibe cuatro argumentos, dos requeridos route y view; y dos opcionales kwargs y name. Este es el momento de revisar para que sirven estos argumentos.
path(): routeLink to this heading#route es una cadena que contiene un patrón de URL. Cuando Django procesa una petición comienza por el primer patrón en urlpatterns y continua hacia abajo por la lista comparando la URL solicitada con cada patrón hasta encontrar aquel que calza.
Tenga en cuenta que estas expresiones regulares no buscan parámetros GET y POST o el nombre de dominio. Por ejemplo en una petición a la dirección URL https://www.example.com/myapp/, la URLconf buscará myapp/. En una petición a https://www.example.com/myapp/?page=3 la URLconf también buscará myapp/.
path(): viewLink to this heading#Cuando Django encuentra una coincidencia de expresiones regulares llama a la función de la vista especificada con un objeto HttpRequest como primer argumento y cualquiera de los valores «capturados» de la ruta como argumentos de palabra clave. Le daremos un ejemplo de esto en un momento.
path(): kwargsLink to this heading#Los argumentos arbitrarios de palabra clave se pueden pasar en un diccionario a la vista destino. No vamos a utilizar esta funcionalidad de Django en el tutorial.
\npath(): nameLink to this heading#Dar un nombre a su URL le permite referirse a ella de forma inequívoca desde otras partes de Django sobre todo desde las plantillas. Esta potente característica le permite realizar cambios globales en los patrones de URL de su proyecto modificando solo un único archivo.
\nCuando se familiarice con el flujo básico de solicitud y respuesta, lea la parte 2 del presente tutorial para empezar a trabajar con la base de datos.
\n