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 admin que le permite añadir, modificar y borrar sondeos.
Asumiremos que ya ha :doc:` instalado Django </intro/install>`.Puede ver cuál Django está instalado, así como su versión ejecutando el siguiente comando:
\n$ python -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».
\nEste tutorial está escrito para Django 1.10 y Python 3.4 o versiones posteriores. Si la versión de Django no coincide, puede consultar el tutorial para su versión de Django usando el conmutador de versión que se encuentra en la esquina inferior derecha de esta página, o actualizar Django a la versión más reciente. Si todavía está utilizando Python 2.7, tendrá que ajustar las muestras de código un poco, como se describe en los comentarios.
\nConsulte :doc: Cómo instalar Django </topics/install> 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 :term: proyecto Django; 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:
\n$ django-admin startproject mysite\nEsto creará un directorio mysite en su directorio actual. Si no funcionó, consulte :ref: resolución de problemas del sitio administrativo Django.
Veamos lo que creó: djadmin:` startproject `:
\nmysite/\n manage.py\n mysite/\n __init__.py\n settings.py\n urls.py\n wsgi.py\nEstos archivos son:
\n: file: El directorio raíz externo `mysite/`solo es un contenedor de su proyecto. Su nombre no es relevante para Django; usted puede cambiarle el nombre a lo que quiera.
manage.py: A command-line utility that lets you interact with this\nDjango project in various ways. You can read all the details about\nmanage.py in django-admin and manage.py.
The inner mysite/ directory 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: An empty file that tells Python that this\ndirectory should be considered a Python package. If you’re a Python beginner,\nread more about packages in the official Python docs.
mysite/settings.py: Settings/configuration for this Django\nproject. Django settings will tell you all about how settings\nwork.
: file: 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: doc: /topics/http/urls.
: file: 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 : file: mysite, si todavía no lo ha hecho, y ejecute los siguientes comandos:
\n$ python 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 1.10, 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 «Bienvenido a Django», en un agradable color azul pastel, ¡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 right next to your manage.py\nfile so that it can be imported as its own top-level module, rather than a\nsubmodule of mysite.
Para crear su aplicación, asegúrese de que está en el mismo directorio que :file: manage.py y escriba este comando:
\n$ python manage.py startapp polls\nEso va a crear un directorio: file: polls que se presenta de la siguiente forma
\npolls/\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.")\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í
\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\nIn the polls/urls.py file include the following code:
polls/urls.pyfrom django.conf.urls import url\n\nfrom . import views\n\nurlpatterns = [\n url(r'^$', 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.conf.urls.include`` e inserte una: func: ~ django.conf.urls.include en la lista urlpatterns , así que tiene:
mysite/urls.pyfrom django.conf.urls import include, url\nfrom django.contrib import admin\n\nurlpatterns = [\n url(r'^polls/', include('polls.urls')),\n url(r'^admin/', admin.site.urls),\n]\nThe include() function allows referencing other\nURLconfs. Note that the regular expressions for the\ninclude() function doesn’t have a $ (end-of-string\nmatch character) but rather a trailing slash. Whenever Django encounters\ninclude(), it chops off whatever part of the URL\nmatched up to that point and sends the remaining string to the included URLconf\nfor 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/», en «/ fun_polls /», «/content/polls/» o en cualquier otra ruta raíz , y la aplicación todavía seguirá funcionando.
Usted ha enviado una vista “índex” al URLconf. Comprobemos si funciona, ejecute el siguiente comando:
\n$ python manage.py runserver\nVaya a http://localhost:8000/polls/ en su navegador, y usted debería ver el texto «* Hola, mundo. Usted está en el índice de encuestas*.” el cual definió en la vista índex.
La url() pasa cuatro argumentos, dos obligatorios: “regex” y “view”, y dos opcionales: kwargs y “name”. En este punto, vale la pena revisar para que sirven estos argumentos.
url(): expresión regularLink to this heading#El término “regex” es una abreviatura comúnmente usada que significa “expresión regular” y la cual es una sintaxis de búsqueda de patrones en cadenas, o en este caso, patrones de URL. Django comienza en la primera expresión regular y se abre camino en la lista, comparando la URL solicitada con cada expresión regular hasta que encuentra una que coincida.
\nTenga 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``https://www.example.com/myapp/, el URLconf buscará ``myapp/. En una petición a https://www.example.com/myapp/?page=3, el URLconf también buscará myapp/.
Si necesita ayuda con las expresiones regulares, consulte la entrada de Wikipedia y la documentación del módulo :mod: re. Además, el libro O’Reilly «Mastering Regular Expressions» por Jeffrey Friedl es fantástico. Sin embargo, en la práctica, no necesita ser un experto en expresiones regulares ya que tan solo necesita saber cómo capturar patrones simples. De hecho, las expresiones regulares complejas pueden tener un bajo rendimiento de búsqueda por lo que no debe depender por completo del poder de las expresiones regulares.
\nPor último, una nota de rendimiento: estas expresiones regulares se compilan la primera vez que se carga el módulo URLconf. Son súper rápidas (siempre y cuando las búsquedas no sean demasiado complejas como se señaló anteriormente).
\nurl(): vistaLink 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 el primer argumento y cualquiera de los valores «capturados» de la expresión regular como otros argumentos. Si la expresión regular utiliza capturas sencillas, los valores se pasan como argumentos posicionales; si utiliza capturas nombradas, los valores se pasan como argumentos de palabra clave. Le daremos un ejemplo de esto en un momento.
url(): 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.
\nurl(): nombreLink to this heading#Naming your URL lets you refer to it unambiguously from elsewhere in Django,\nespecially from within templates. This powerful feature allows you to make\nglobal changes to the URL patterns of your project while only touching a single\nfile.
\nCuando se familiarice con el flujo básico de solicitud y respuesta, lea :doc: la parte 2 del presente tutorial </intro/tutorial02> para empezar a trabajar con la base de datos.
\n