Traducido por Miguel A. Ponce

documentación de Django - 5.2.15.dev20260527181452

Home | Table of contents | Index | Modules

up | next »

Contenido de la documentación de Django

• Empezando
  • Django en una ojeada
    • Diseña tu modelo
    • Instálalo
    • Disfruta de la API gratuita
    • Una interfaz administrativa dinámica: no es solo un armazón – es toda la casa
    • Diseña tus URLs
    • Escribe tus vistas
    • Diseña tus plantillas
    • Esta es solo la superficie
  • Guía rápida de instalación
    • Instalar Python
    • Configura una base de datos
    • Instala Django
    • Verificación
    • ¡Eso es todo!
  • Escribiendo tu primera aplicación Django, parte 1
    • Crear un proyecto
    • El servidor de desarrollo
    • Creación de la aplicación Polls
    • Escribe tu primera vista
  • Escribiendo tu primera aplicación Django, parte 2
    • Configuración de la base de datos
    • Creación de modelos
    • Activar modelos
    • Jugar con la API
    • Introduciendo la interfaz administrativa de Django
  • Escribiendo tu primera aplicación Django, parte 3
    • Resumen
    • Escribir más vistas
    • Escribe vistas que realmente hagan algo
    • Elevando una excepción 404
    • Utiliza el sistema de plantillas
    • Removing hardcoded URLs en plantillas
    • Nombrespaciado de nombres de URL
  • Escribir tu primera aplicación Django, parte 4
    • Escribe un formulario mínimo
    • Utiliza vistas genéricas: menos código es mejor
  • Escribiendo tu primera aplicación Django, parte 5
    • Introducción a las pruebas automatizadas
    • Estrategias de testing básicas
    • Escribir nuestro primer test
    • Prueba de una vista
    • Cuando estés probando, más es mejor
    • Pruebas adicionales
    • ¿Qué sigue?
  • Writing your first Django app, part 6
    • Personaliza la apariencia y el comportamiento de tu aplicación
    • Añadiendo una imagen de fondo
  • Escribiendo tu primera aplicación de Django, parte 7
    • Personaliza la forma del administrador
    • Está agregando objetos relacionados
    • Personaliza la lista de cambio del administrador
    • Personaliza la apariencia del administrador
    • Personaliza la página de inicio del administrador
  • Escribiendo tu primera aplicación Django, parte 8
    • Instalación de Django Debug Toolbar
    • Obtener ayuda de otros
    • Instalación de otros paquetes terceros
    • ¿Qué sigue?
  • Tutoriales avanzados: Cómo escribir aplicaciones reutilizables
    • La reutilización importa
    • Tu proyecto y tu aplicación reutilizable
    • Instalando algunas dependencias
    • Empaquetando tu aplicación
    • Utilizando tu propio paquete
    • Publicación de tu aplicación
    • Instalando paquetes de Python con un entorno virtual
  • Qué leer a continuación
    • Buscar documentación
    • Cómo está organizada la documentación
    • Cómo se actualiza la documentación
    • ¿Dónde obtenerla?
    • Diferencias entre versiones
  • Escribiendo tu primera contribución para Django
    • Introducción
    • Código de Conducta
    • Instalando Git
    • Obtener una copia de la versión de desarrollo de Django
    • Ejecutar el conjunto de pruebas de Django por primera vez
    • Trabajando en una nueva característica aprobada
    • Crear una rama
    • Escribir algunos tests para tu ticket
    • Escribiendo el código para tu ticket
    • Ejecutando el conjunto de pruebas de Django por segunda vez
    • Escribiendo Documentación
    • Revisando tus cambios
    • Realizando el commit de los cambios
    • Haciendo push del commit y creando una solicitud de extracción
    • Pasos siguientes
• Usando Django
  • Cómo instalar Django
    • Instala Python
    • Instala Apache y mod_wsgi
    • Haz funcionar tu base de datos
    • Instalar el código de Django
  • Modelos y bases de datos
    • Modelos
    • Haciendo consultas
    • Agregación
    • Búsqueda
    • Administradores
    • Ejecutando consultas SQL crudas
    • Transacciones de base de datos
    • Bases de datos múltiples
    • Espacios de tablas
    • Optimización del acceso a la base de datos
    • Instrumentación de bases de datos
    • Ficheros de pruebas
    • Ejemplos de uso de la API de relación de modelos
  • Gestión de solicitudes HTTP
    • Dispatcher de URL
    • Escribiendo vistas
    • Decoradores de vistas
    • Subidas de archivos
    • Funciones y clases de corte
    • Vistas genéricas
    • Middleware
    • Cómo usar sesiones
  • Trabajando con formas
    • Formularios HTML
    • El papel de Django en los formularios
    • Formularios en Django
    • Crear un formulario
    • Más sobre las clases Form de Django
    • Trabajando con plantillas de formularios
    • Temas adicionales
  • Templates
    • El lenguaje de plantillas de Django
    • Soporte para motores de plantillas
  • Vistas basadas en clases
    • Introducción a las vistas basadas en clases
    • Vistas genéricas basadas en clases
    • Procesamiento de formularios con vistas basadas en clases
    • Usando mezclas con vistas basadas en clases
    • Ejemplos básicos
    • Uso en tu archivo URLconf
    • Clases heredadas de vistas genericas
    • Vistas basadas en clase asíncronas
  • Migraciones
    • Los Comandos
    • Backend Support
    • Flujo de trabajo
    • Transacciones
    • Dependencias
    • Archivos de migración
    • Agregar migraciones a aplicaciones
    • Reversión de migraciones
    • Modelos históricos
    • Consideraciones al eliminar campos de modelo
    • Migraciones de datos
    • Squashing Migraciones
    • Serializando valores
    • Soportando múltiples versiones de Django
  • Gestión de archivos
    • Uso de archivos en modelos
    • El objeto File
    • Almacenamiento de archivos
  • Pruebas en Django
    • Escribir y ejecutar pruebas
    • Herramientas de prueba
    • Temas avanzados de pruebas
  • Autenticación de usuarios en Django
    • Resumen
    • Instalación
    • Uso
  • Marco de caché de Django
    • Configuración del cache
    • La caché por sitio
    • La caché por vista
    • Caché de fragmentos de plantilla
    • La API de caché de bajo nivel
    • Soporte asíncrono
    • Cachés downstream
    • Utilizando encabezados Vary
    • Controlando la caché: Utilizando otros encabezados
    • Orden de MIDDLEWARE
  • Procesamiento condicional de vistas
    • El decorador condition
    • Atajos para calcular solo un valor
    • Usando los decoradores con otros métodos HTTP
    • Comparación con el procesamiento condicional mediante middleware
  • Claves primarias compuestas
    • Migrar a una clave primaria compuesta
    • Claves primarias compuestas y relaciones
    • Claves primarias compuestas y funciones de la base de datos
    • Claves primarias compuestas en formularios
    • Claves primarias compuestas en la validación del modelo
    • Creando aplicaciones listas para usar con claves primarias compuestas
  • La firma criptográfica
    • Protegiendo SECRET_KEY y SECRET_KEY_FALLBACKS
    • Utilizando la API de bajo nivel
  • Enviando correo electrónico
    • Ejemplos rápidos
    • send_mail()
    • send_mass_mail()
    • mail_admins()
    • mail_managers()
    • Ejemplos
    • Prevención de inyección de encabezados
    • La clase EmailMessage
    • Los backends de correo electrónico
    • Configurando el correo electrónico para desarrollo
  • Internacionalización y localización
    • Resumen
    • Definiciones
  • Registro
    • Resumen
    • Implicaciones de seguridad
    • Configuración del registro
  • Paginación
    • La clase Paginator
    • Ejemplo
    • Paginando en ListView
    • Usando Paginator en una función de vista
  • Seguridad en Django
    • Siempre sanitiza la entrada del usuario
    • Protección contra ataques de Cross Site Scripting (XSS)
    • Protección contra ataques de forja de solicitudes cruzadas (CSRF)
    • Protección contra inyección SQL
    • Protección contra clickjacking
    • SSL/HTTPS
    • Validación del encabezado de host
    • Política del referente
    • Política de apertura entre origen
    • Seguridad de sesión
    • Contenido cargado por el usuario
    • Temas adicionales de seguridad
  • Rendimiento y optimización
    • Introduction
    • Enfoques generales
    • Caché
    • La comprensión de la pereza
    • Bases de datos
    • Rendimiento HTTP
    • Rendimiento de plantillas
    • Usando diferentes versiones del software disponible
  • Serializando objetos Django
    • Serializando datos
    • Deserializando datos
    • Formatos de serialización
    • Claves naturales
  • Configuración de Django
    • La base fundamental
    • Designando las configuraciones
    • Configuraciones predeterminadas
    • Utilizando configuraciones en código Python
    • Modificando configuraciones en tiempo de ejecución
    • Seguridad
    • Configuraciones disponibles
    • Creando tu propia configuración
    • Uso de configuraciones sin establecer DJANGO_SETTINGS_MODULE
  • Señales
    • Escuchar señales
    • Definir y enviar señales
    • Desconectar señales
  • Marco de sistema de comprobación
    • Escribiendo tus propios controles
  • Paquetes externos
    • Localflavor
    • Comentarios
    • Formtools
  • Soporte asíncrono
    • Vistas asíncronas
    • Seguridad asíncrona
    • Adaptadores de funciones asíncronas
• Guías paso a paso
  • Modelos, datos y bases de datos
    • Cómo proporcionar datos iniciales para modelos.
    • Cómo integrar Django con una base de datos legada
    • Cómo crear campos de modelo personalizados
    • Cómo crear migraciones de base de datos
    • Cómo escribir consultas personalizadas
  • Plantillas y salida
    • Cómo crear salida CSV
    • Cómo crear archivos PDF
    • Cómo sobreescribir plantillas
    • Cómo implementar un backend de plantillas personalizado
    • Cómo crear etiquetas y filtros de plantilla personalizados
  • Configuración y gestión del proyecto
    • Cómo gestionar archivos estáticos (por ejemplo, imágenes, JavaScript, CSS)
    • Cómo configurar y utilizar el registro
    • How to manage error reporting Cómo gestionar el informe de errores.
    • Cómo eliminar una aplicación Django
  • Instalando, desplegando y actualizando
    • Cómo actualizar Django a una versión más reciente
    • Cómo instalar Django en Windows
    • Cómo desplegar Django
    • Cómo desplegar archivos estáticos
  • Otras guías
    • Cómo autenticarse utilizando REMOTE_USER
    • Cómo utilizar la protección contra ataques CSRF de Django
    • Cómo escribir una clase de almacenamiento personalizada
    • Cómo crear comandos personalizados de django-admin
    • Cómo personalizar la orden shell
• Preguntas Frecuentes de Django
  • FAQ: General
    • ¿Por qué existe este proyecto?
    • ¿Qué significa «Django» y cómo se pronuncia?
    • ¿Es Django estable?
    • ¿Django se escala?
    • ¿Quién está detrás de esto?
    • ¿Cómo está licenciado Django?
    • ¿Por qué incluye Django el archivo de licencia de Python?
    • ¿Qué sitios utilizan Django?
    • Django parece ser un marco de trabajo MVC, pero tú llamas al Controlador el «vista» y la Vista el «plantilla». ¿Por qué no utilizáis los nombres estándar?
    • ¡Claro! Aquí tienes la traducción exacta del texto original, manteniendo todas las etiquetas y formatos originales:
    • ¿Por qué escribiste todo Django desde cero en lugar de utilizar otras bibliotecas de Python?
    • ¿Es Django un sistema de gestión de contenido (SGC)?
    • ¿Cómo puedo descargar la documentación de Django para leerla en modo offline?
    • ¿Cómo citar Django?
    • ¿Dónde puedo encontrar más recursos de Django?
  • Preguntas Frecuentes: Instalación
    • ¿Cómo me inicio?
    • ¿Cuáles son las prerequisitos de Django?
    • ¿Qué versión de Python puedo usar con Django?
    • ¿Qué versión de Python debería usar con Django?
    • ¿Debería utilizar la versión estable o la versión de desarrollo?
  • Preguntas frecuentes: Uso de Django
    • ¿Por qué obtengo un error al importar DJANGO_SETTINGS_MODULE?
    • No puedo soportar tu lenguaje de plantillas. ¿Tengo que usarlo?
    • ¿Tengo que usar tu capa de modelo/bases de datos?
    • ¿Cómo utilizo campos de imagen y archivo?
    • ¿Cómo hago que una variable esté disponible para todos mis templates?
  • Preguntas Frecuentes: Obtener Ayuda
    • ¿Cómo hago X? ¿Por qué no funciona Y? ¿Dónde puedo ir para obtener ayuda?
    • Nadie respondió a mi pregunta. ¿Qué debo hacer?
    • Creo haber encontrado un error. ¿Qué debo hacer?
    • Creo haber encontrado un problema de seguridad. ¿Qué debo hacer?
  • Preguntas Frecuentes: Bases de datos y modelos
    • ¿Cómo puedo ver las consultas SQL brutas que está ejecutando Django?
    • ¿Puedo usar Django con una base de datos existente?
    • ¿Cómo actualizo la base de datos si hago cambios en un modelo?
    • ¿Los modelos de Django admiten claves primarias en varias columnas?
    • ¿Django admite bases de datos NoSQL?
    • ¿Cómo puedo agregar opciones específicas de base de datos a mis sentencias CREATE TABLE, como especificar que el tipo de tabla sea MyISAM?
  • FAQ: El administrador
    • No puedo acceder al sistema. Cuando introduzco un nombre de usuario y contraseña válidos, simplemente me devuelve la página de inicio de sesión nuevamente, sin mensajes de error.
    • No puedo acceder al sistema. Cuando ingreso un nombre de usuario y contraseña válidos, me devuelve la página de inicio de sesión nuevamente, con el mensaje de error «Por favor, ingrese un nombre de usuario y contraseña correctos».
    • ¿Cómo puedo establecer automáticamente el valor de un campo al usuario que editó por última vez el objeto en la interfaz administrativa?
    • ¿Cómo puedo limitar el acceso al panel de administración para que solo los usuarios que crearon un objeto puedan editarlo?
    • Mi sitio administrativo CSS y imágenes se mostraban correctamente utilizando el servidor de desarrollo, pero no se están mostrando cuando se utiliza mod_wsgi.
    • Mi «list_filter» contiene un ManyToManyField, pero el filtro no se muestra.
    • Algunos objetos no aparecen en la interfaz administrativa.
    • ¿Cómo puedo personalizar la funcionalidad de la interfaz administrativa?
    • La página administrativa generada dinámicamente es fea. ¿Cómo puedo cambiarla?
    • ¿Qué navegadores se admiten para usar la interfaz de administración?
    • ¿Qué tecnologías asistentes se admiten para usar la interfaz de administración?
  • FAQ: Contribuyendo código
    • ¿Cómo puedo empezar a contribuir con código en Django?
    • Me presenté una corrección de errores varias semanas atrás. ¿Por qué estás ignorando mi contribución?
    • ¿Cuándo y cómo puedo recordar al equipo de un cambio en el que me intereso?
    • Pero te he recordado varias veces y sigues ignorando mi contribución!
    • Estoy seguro de que mi boleto está absolutamente 100% perfecto, ¿puedo marcarlo como «Listo para revisión» yo mismo?
  • Solución de problemas
    • Problemas al ejecutar django-admin
    • Otros temas
• Referencia de la API
  • Los aplicativos
    • Proyectos y aplicaciones
    • Configuración de aplicaciones
    • Configuración de la aplicación
    • Registro de aplicaciones
    • Proceso de inicialización
  • Marco del sistema de comprobaciones
    • Referencia de la API
    • Etiquetas integradas
    • Core sistema de comprobaciones
    • La aplicación contrib realiza comprobaciones
  • API de vistas basadas en clases
    • Vistas base
    • Vistas de visualización genéricas
    • Los textos editores genericos
    • Vistas de fechas genéricas
    • Class-based views mixins
    • Vistas basadas en clases - índice plano
    • Especificación
    • Base vs Generic views
  • Protección contra Clickjacking
    • Ejemplo de clickjacking
    • Prevención de clickjacking
    • Cómo usarlo
    • Limitaciones
  • Los paquetes contrib
    • El sitio de administración de Django
    • django.contrib.auth
    • El framework de contenttypes
    • La aplicación flatpages
    • GeoDjango
    • django.contrib.humanize
    • El framework de mensajes
    • django.contrib.postgres
    • La aplicación de redirecciones
    • El marco de trabajo del mapa del sitio
    • El «framework de sitios»
    • La aplicación staticfiles
    • El marco de generación de feeds de syndication
    • admin
    • auth
    • contenttypes
    • flatpages
    • gis
    • humanize
    • mensajes
    • postgres
    • redirecciones
    • sesiones
    • sites
    • sitemaps
    • syndication
  • Protección contra ataques de Cross Site Request Forgery
    • Cómo funciona
    • Limitaciones
    • Herramientas
    • Configuración
    • Preguntas Frecuentes
  • Bases de datos
    • Notas generales
    • Notas de PostgreSQL
    • Notas sobre MariaDB
    • Notas sobre MySQL
    • Notas sobre SQLite
    • Notas sobre Oracle
    • Herencia de los backends de bases de datos integrados
    • Uso de un backend de base de datos de terceros
  • django-admin y manage.py
    • Uso
    • Comandos disponibles
    • Comandos proporcionados por aplicaciones
    • Opciones por defecto
    • Niceteadas adicionales
  • Ejecutando comandos de gestión desde tu código
    • Redirección de salida
  • Excepciones Django
    • Excepciones del núcleo de Django
    • Excepciones de resolución de URL
    • Excepciones de base de datos
    • Excepciones HTTP
    • Excepciones de Sesiones
    • Excepciones de Transacción
    • Testing Framework Excepciones
    • Excepciones de Python
  • Gestión de archivos
    • El objeto File
    • API de almacenamiento de archivos
    • Archivos subidos y Manejadores de carga
  • Formularios
    • La API de Formularios
    • Campos del formulario
    • Modelo de formulario
    • Funciones de conjunto de formularios
    • La API de renderizado de formularios
    • Widgets
    • Validación de formularios y campos
  • Registro
    • Configuración de registro predeterminada de Django
    • Extensiones de registro de Django
  • Middleware
    • Los middleware disponibles
    • Orden de middleware
  • Operaciones de Migración
    • Operaciones de Esquema
    • Operaciones Especiales
    • Categoría de operación
    • Escribiendo tus propias operaciones
  • Modelos
    • Referencia del campo del modelo
    • Field attribute reference
    • Referencia del índice del modelo
    • Referencia a restricciones
    • API de Model _meta
    • Referencia a objetos relacionados
    • Referencia del modelo
    • Opciones de Meta para modelos
    • Referencia de instancia del modelo
    • Referencia de la API de QuerySet
    • Referencia de la API de búsqueda
    • Query Expressions
    • Expresiones condicionales
    • Funciones del Base de Datos
  • Paginador
    • Paginador clase
    • Clase Page
    • Excepciones
  • Objetos de solicitud y respuesta
    • Quick overview
    • HttpRequest objects
    • Los objetos QueryDict
    • Los objetos HttpResponse
    • Objetos JsonResponse
    • Los objetos StreamingHttpResponse
    • Objetos FileResponse
    • Clase HttpResponseBase
  • SchemaEditor
    • Métodos
    • A continuación, te proporciono las traducciones de los textos originales manteniendo todas sus etiquetas intactas.
  • Configuración
    • Configuración básica
    • Autenticación
    • Mensajes
    • Sesiones
    • Sitios
    • Archivos Estáticos
    • Configuración Centralizada Índice Temático
  • Señales
    • Señales de modelo
    • Señales de gestión
    • Señales de solicitud/respuesta
    • Pruebas de señales
    • Database Wrappers
  • Plantillas
    • El lenguaje de plantillas de Django
    • Referencia a etiquetas y filtros de plantillas integradas
    • El lenguaje de plantillas Django: para programadores de Python
  • TemplateResponse y SimpleTemplateResponse
    • SimpleTemplateResponse objetos
    • Objetos TemplateResponse
    • El proceso de renderizado
    • Utilizando TemplateResponse y SimpleTemplateResponse
  • Datos Unicode
    • Creando la base de datos
    • General manejo de cadenas
    • Modelos
    • Plantillas
    • Archivos
    • Envío de formulario
  • Funciones utilitarias django.urls
    • reverse()
    • reverse_lazy()
    • resolve()
    • get_script_prefix()
  • Funciones de django.urls para uso en URLconfs
    • path()
    • re_path()
    • include()
    • register_converter()
  • Funciones de django.conf.urls para su uso en URLconfs
    • static()
    • handler400
    • handler403
    • handler404
    • handler500
  • Django Utils
    • django.utils.cache
    • django.utils.dateparse
    • django.utils.decorators
    • django.utils.encoding
    • django.utils.feedgenerator
    • django.utils.functional
    • django.utils.html
    • django.utils.http
    • django.utils.module_loading
    • django.utils.safestring
    • django.utils.text
    • django.utils.timezone
    • django.utils.translation
  • Validadores
    • Escribiendo validadores
    • Cómo se ejecutan los validadores
    • Validadores integrados
  • Vistas integradas
    • Servir archivos en desarrollo
    • Vistas de errores
• Documentación de metadatos y otros menesteres
  • La estabilidad de la API
    • ¿Qué significa «estable»?
    • Las APIs estable
    • Excepciones
  • Los textos traducidos son:
    • En general
    • Modelos
    • API de base de datos
    • Diseño de URL
    • Sistema de plantillas
    • Views
    • Marco de Caché
  • Distribuciones terceras de Django
    • Para distribuidores
• Glosario
• Notas de lanzamiento
  • Final releases
    • Lanzamiento 5.2
    • Lanzamiento 5.1
    • Lanzamiento 5.0
    • Lanzamiento 4.2
    • Lanzamiento 4.1
    • Lanzamiento 4.0
    • Lanzamiento 3.2
    • Lanzamiento 3.1
    • 3.0 liberación
    • 2.2 liberación
    • 2.1 liberación
    • 2.0 liberación
    • 1.11 liberación
    • 1.10 liberación
    • 1.9 liberación
    • 1.8 liberación
    • 1.7 liberación
    • 1.6 liberación
    • 1.5 liberación
    • 1.4 liberación
    • 1.3 liberación
    • 1.2 liberación
    • 1.1 liberación
    • 1.0 liberación
    • Liberaciones pre-1.0
  • Liberaciones de seguridad
• Internos de Django
  • Contribuir a Django
    • Canales de comunicación
    • Empezar
    • Trabajar en el marco de Django
    • Otras formas de contribuir
  • Listas de correo y Foro
    • Foro de Django
    • django-announce
    • django-updates
    • Listas de correo electrónico archivadas
  • Organización del Proyecto Django
    • Principios
    • Fusión
    • Releasers
    • Consejo de dirección
    • Cambiando la organización
  • Políticas de seguridad de Django
    • Denuncia de problemas de seguridad
    • Cómo evalúa Django un informe
    • Versiones soportadas
    • Niveles de gravedad de problemas de seguridad
    • Cómo Django divulga problemas de seguridad
    • ¿Quién recibe notificación anticipada
    • Solicitar notificaciones
  • Proceso de liberación de Django
    • Liberaciones oficiales
    • Release cadence
    • Política de deprecación
    • Versiones soportadas
    • Proceso de liberación
  • Cronología de Deprecación de Django
    • No hay texto proporcionado para traducir. ¿Podrías proporcionar el texto completo o la sección específica de la documentación que deseas traducir? Estoy listo para ayudarte con la traducción manteniendo todas las etiquetas intactas.
    • 6.0
    • 5.1
    • 5.0
    • 4.1
    • 4.0
    • 3.1
    • 3.0
    • 2.1
    • 2.0
    • 1.10
    • 1.9
    • 1.8
    • 1.7
    • 1.6
    • 1.5
    • 1.4
    • 1.3
  • El repositorio del código fuente de Django
    • Visión general a nivel alto
    • La rama principal
    • Ramas estables
    • Etiquetas
  • Cómo liberar Django
    • Resumen
    • Requisitos previos
    • Tareas previas al lanzamiento
    • Tareas de congelamiento de características
    • De hecho, realizar el lanzamiento
    • Hacer las liberaciones disponibles para el público
    • Post-liberación
    • Notas sobre la configuración de la tupla VERSION

Índices, glosario y tablas

• índice general

• Índice de Módulos

• :glosario

Last update:

may 31, 2026

up | next »