Escribiendo su primera aplicación en Django, parte 1Link to this heading#

Creando un proyectoLink to this heading#

Si 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.

Desde la línea de comandos, cambie a un directorio donde le gustaría almacenar su código, luego, ejecute el siguiente comando:

$ django-admin startproject mysite

Esto 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 `:

mysite/
    manage.py
    mysite/
        __init__.py
        settings.py
        urls.py
        wsgi.py

Estos archivos son:

• : 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 Django project in various ways. You can read all the details about manage.py in django-admin and manage.py.

• The inner mysite/ directory is the actual Python package for your project. Its name is the Python package name you’ll need to use to import anything inside it (e.g. mysite.urls).

• mysite/__init__.py: An empty file that tells Python that this directory should be considered a Python package. If you’re a Python beginner, read more about packages in the official Python docs.

• mysite/settings.py: Settings/configuration for this Django project. Django settings will tell you all about how settings work.

• : 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.

El servidor de desarrolloLink to this heading#

Comprobemos que su proyecto Django funciona. Cambie al directorio externo : file: mysite, si todavía no lo ha hecho, y ejecute los siguientes comandos:

$ python manage.py runserver

Verá la siguiente salida en la línea de comandos:

Performing system checks...

System check identified no issues (0 silenced).

You have unapplied migrations; your app may not work properly until they are applied.
Run 'python manage.py migrate' to apply them.

09 de agosto de 2026 - 15:50:53
Django version 1.10, using settings 'mysite.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

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.

Ahora 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.)

Ahora 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ó!

Creando la aplicación encuestasLink to this heading#

Ahora que su entorno, un «proyecto», se ha configurado, ya está listo para empezar a trabajar.

Cada 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.

Your apps can live anywhere on your Python path. In this tutorial, we’ll create our poll app right next to your manage.py file so that it can be imported as its own top-level module, rather than a submodule of mysite.

Para crear su aplicación, asegúrese de que está en el mismo directorio que :file: manage.py y escriba este comando:

$ python manage.py startapp polls

Eso va a crear un directorio: file: polls que se presenta de la siguiente forma

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

Esta estructura de directorios almacenará la aplicación encuesta.

Escriba su primera vistaLink to this heading#

Vamos 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


def index(request):
    return HttpResponse("Hello, world. You're at the polls index.")

Esta 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.

Para crear una URLconf en el directorio encuestas, cree un archivo llamado `` urls.py``. El directorio de su aplicación debe verse así

polls/
    __init__.py
    admin.py
    apps.py
    migrations/
        __init__.py
    models.py
    tests.py
    urls.py
    views.py

In the polls/urls.py file include the following code:

from django.conf.urls import url

from . import views

urlpatterns = [
    url(r'^$', views.index, name='index'),
]

El 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:

from django.conf.urls import include, url
from django.contrib import admin

urlpatterns = [
    url(r'^polls/', include('polls.urls')),
    url(r'^admin/', admin.site.urls),
]

The include() function allows referencing other URLconfs. Note that the regular expressions for the include() function doesn’t have a $ (end-of-string match character) but rather a trailing slash. Whenever Django encounters include(), it chops off whatever part of the URL matched up to that point and sends the remaining string to the included 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/», 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:

$ python manage.py runserver

Vaya 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.