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 6.0, which supports Python 3.12 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.
\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.
\nFrom the command line, cd into a directory where you’d like to store your\ncode and run the following command to bootstrap a new Django project:
Linux / macOS
$ django-admin startproject mysite djangotutorial\nWindows
...\\> django-admin startproject mysite djangotutorial\nThis will create a directory djangotutorial with a project called\nmysite inside. The directory name doesn’t matter to Django; you can rename\nit to anything you like. If it didn’t work, see\nProblemas ejecutando django-admin.
Veamos lo que el comando startproject creó:
djangotutorial/\n manage.py\n mysite/\n __init__.py\n settings.py\n urls.py\n asgi.py\n wsgi.py\nEstos archivos son:
\nmanage.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 manage.py en django-admin and manage.py.
mysite/: A directory that is the actual Python package for your\nproject. Its name is the Python package name you’ll need to use to import\nanything inside it (e.g. 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: Settings/configuration for this Django\nproject. Django settings will tell you all about how settings\nwork.
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.
Let’s verify your Django project works. Change into the djangotutorial\ndirectory, if you haven’t already, and run the following commands:
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\napplied. Run 'python manage.py migrate' to apply them.\n\n09 de agosto de 2026 - 15:50:53\nDjango version 6.0, using settings 'mysite.settings'\nStarting development server at http://127.0.0.1:8000/\nQuit the server with CONTROL-C.\n\nWARNING: This is a development server. Do not use it in a production setting. Use a production WSGI or ASGI server instead.\nFor more information on production servers see: https://docs.djangoproject.com/en/6.0/howto/deployment/\n\n
Now that the server’s running, visit http://127.0.0.1:8000/ with your web\nbrowser. You’ll see a «Congratulations!» page, with a rocket taking off.\nIt worked!
\nYou’ve started the Django development server, a lightweight web server written\npurely in Python. We’ve included this with Django so you can develop things\nrapidly, without having to deal with configuring a production server – such as\nApache – until you’re ready for production.
\nNow’s a good time to note: don’t use this server in anything resembling a\nproduction environment. It’s intended only for use while developing. (We’re in\nthe business of making web frameworks, not web servers.)
\n(To serve the site on a different port, see the runserver\nreference.)
Ahora 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 in your Python path. In\nthis tutorial, we’ll create our poll app inside the djangotutorial folder.
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\nEsto creará un directorio polls, que se presenta de la siguiente manera:
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:
polls/views.pyfrom django.http import HttpResponse\n\n\ndef index(request):\n return HttpResponse("Hello, world. You're at the polls index.")\nThis is the most basic view possible in Django. To access it in a browser, we\nneed to map it to a URL - and for this we need to define a URL configuration,\nor «URLconf» for short. These URL configurations are defined inside each\nDjango app, and they are Python files named urls.py.
To define a URLconf for the polls app, create a file polls/urls.py\nwith the following content:
polls/urls.pyfrom django.urls import path\n\nfrom . import views\n\nurlpatterns = [\n path("", views.index, name="index"),\n]\nSu directorio de aplicaciones ahora debería verse asi:
\npolls/\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\nThe next step is to configure the root URLconf in the mysite project to\ninclude the URLconf defined in polls.urls. To do this, add an import for\ndjango.urls.include in mysite/urls.py and insert an\ninclude() in the urlpatterns list, so you have:
mysite/urls.pyfrom 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]\nThe path() function expects at least two arguments:\nroute and view.\nThe include() function allows referencing other URLconfs.\nWhenever Django encounters include(), it chops off whatever\npart of the URL matched up to that point and sends the remaining string to the\nincluded URLconf for further processing.
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.
Ahora tiene una vista index vinculada en los URLconf. Compruebe su funcionamiento con el siguiente comando:
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.
Cuando 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