De modo que usted ha leído todo el material introductorio y ha decidido que le gustaría seguir usando Django. Sólo hemos arañado la superficie con esta introducción (de hecho, si usted ha leído cada palabra, usted ha leído un 5% de la totalidad de la documentación).
\nAhora, ¿qué sigue?
\nBueno, siempre hemos sido grandes fans de aprender haciendo. En este punto, usted debe saber lo suficiente como para iniciar un proyecto por su cuenta y empezar a divertirse. Conforme necesite aprender nuevos trucos, vuelva a la documentación.
\nWe’ve put a lot of effort into making Django’s documentation useful, clear and\nas complete as possible. The rest of this document explains more about how the\ndocumentation works so that you can get the most out of it.
\n(Sí, se trata de documentación sobre la documentación. Tenga la seguridad de que no tenemos planes de escribir un documento de cómo leer el documento sobre la documentación.)
\nDjango’s got a lot of documentation – almost 450,000 words and counting –\nso finding what you need can sometimes be tricky. A good place to start\nis the Índice. We also recommend using the builtin search feature.
\nO ¡simplemente usted puede echar un vistazo!
\nLa documentación principal de Django se divide en «trozos» diseñados para atender los diferentes requerimientos:
\nThe introductory material is designed for people new\nto Django – or to web development in general. It doesn’t cover anything\nin depth, but instead gives a high-level overview of how developing in\nDjango «feels».
Por otro lado, las guías temáticas profundizan en las secciones individuales de Django. Hay guías completas para el sistema de modelos de Django, motor de plantillas, framework de formularios y mucho más.
\nAquí es probablemente donde usted querrá pasar la mayor parte de su tiempo; si usted avanza en el estudio de estas guías debe salir sabiendo casi todo lo que hay que saber acerca de Django.
\nEl desarrollo web suele ser amplio, pero no profundo; los problemas abarcan muchos ámbitos. Hemos escrito un conjunto de guías paso a paso que responden las preguntas comúnes tipo «¿Cómo puedo…?». Aquí encontrará información sobre cómo Crear PDFs con Django, escribir etiquetas de plantilla personalizadas y más.
\nTambién se pueden encontrar respuestas a preguntas muy comunes en el FAQ.
\nLas guías y tutoriales paso a paso no abarcan cada clase, función y método disponible en Django, eso sería abrumador cuando usted está tratando de aprender. En su lugar, la información sobre las clases, funciones, métodos y módulos individuales se guardan en la referencia. Aquí es donde buscará la información sobre una función en particular o lo que usted necesite.
Si usted está interesado en la implementación de un proyecto para el uso público, nuestra documentación tienen varias guías para diversas configuraciones de implementación, así como una lista de implementación para algunas cosas que usted tendrá que considerar.
Finally, there’s some «specialized» documentation not usually relevant to\nmost developers. This includes the release notes and\ninternals documentation for those who want to add\ncode to Django itself, and a few other things that don’t fit elsewhere.
Así como el código base de Django se desarrolla y mejora día a día, nuestra documentación está mejorando constantemente. Mejoramos la documentación por varias razones:
\nPara hacer correcciones de contenido tales como correcciones gramaticales y de errores tipográficos.
Para añadir información y/o ejemplos a las secciones existentes que necesitan ser ampliadas.
Para documentar las funcionalidades de Django que aún no están documentadas. (La lista de dichas funcionalidades se reduce, sin embargo, existe a pesar de ello.)
Para agregar la documentación de las nuevas características a medida que estas se añaden o cuando cambian las APIs de Django o los comportamientos.
Django’s documentation is kept in the same source control system as its code. It\nlives in the docs directory of our Git repository. Each document\nonline is a separate text file in the repository.
\nUsted puede leer la documentación de Django de varias maneras. Las formas de leer la documentación están en orden de preferencia:
\nThe most recent version of the Django documentation lives at\nhttps://docs.djangoproject.com/en/dev/. These HTML pages are generated\nautomatically from the text files in source control. That means they reflect the\n«latest and greatest» in Django – they include the very latest corrections and\nadditions, and they discuss the latest Django features, which may only be\navailable to users of the Django development version. (See\nDiferencias entre versiones below.)
\nLe animamos a ayudar a mejorar la documentación mediante la presentación de cambios, correcciones y sugerencias en el ticket system. Los desarrolladores de Django monitorean activamente el sistema de tickets y utilizan sus comentarios y sugerencias para mejorar la documentación para todo el mundo.
\nSin embargo, tenga en cuenta que las tickets deberían estar relacionadas expresamente con la documentación, en lugar de hacer preguntas generales de soporte técnico. Si usted necesita ayuda con su configuración particular de Django, pruebe en su lugar la lista de correos de los django-users o en el canal de chat #django IRC.
\nUsted puede leer la documentación de Django en texto plano, para su lectura sin conexión a la red o simplemente por comodidad.
\nIf you’re using an official release of Django, the zipped package (tarball) of\nthe code includes a docs/ directory, which contains all the documentation\nfor that release.
If you’re using the development version of Django (aka the main branch), the\ndocs/ directory contains all of the documentation. You can update your\nGit checkout to get the latest changes.
Una forma de baja tecnología de aprovechar la documentación de textos es mediante el uso de la utilidad grep de Unix para buscar una expresión en toda la documentación. Por ejemplo, esta le mostrará cada referencia de la expresión «max_length» en cualquier documento de Django:
Linux / macOS
$ grep -r max_length /path/to/django/docs/\nWindows
...\\> grep -r max_length \\path\\to\\django\\docs\\\nYou can get a local copy of the HTML documentation following a few steps:
\nLa documentación de Django utiliza un sistema llamado Sphinx para convertir el texto plano en HTML. Usted tendrá que instalar Sphinx bien sea descargando e instalando el paquete desde el sitio web de Sphinx o con pip:
Linux / macOS
$ python -m pip install Sphinx\nWindows
...\\> py -m pip install Sphinx\nThen, use the included Makefile to turn the documentation into HTML:
$ cd path/to/django/docs\n$ make html\nUsted tendrá que instalar GNU Make para esto.
\nSi está en Windows puede utilizar alternativamente el archivo batch incluido:
\ncd path\\to\\django\\docs\nmake.bat html\nLa documentación HTML se ubicará en docs/_build/html.
The text documentation in the main branch of the Git repository contains the\n«latest and greatest» changes and additions. These changes include\ndocumentation of new features targeted for Django’s next feature\nrelease. For that reason, it’s worth pointing out our policy\nto highlight recent changes and additions to Django.
\nSeguimos esta política:
\nThe development documentation at https://docs.djangoproject.com/en/dev/ is\nfrom the main branch. These docs correspond to the latest feature release,\nplus whatever features have been added/changed in the framework since then.
As we add features to Django’s development version, we update the\ndocumentation in the same Git commit transaction.
To distinguish feature changes/additions in the docs, we use the phrase:\n«New in Django Development version» for the version of Django that hasn’t\nbeen released yet, or «New in version X.Y» for released versions.
Documentation fixes and improvements may be backported to the last release\nbranch, at the discretion of the merger, however, once a version of Django is\nno longer supported, that version of the\ndocs won’t get any further updates.
The main documentation web page includes links to documentation for\nprevious versions. Be sure you are using the version of the docs\ncorresponding to the version of Django you are using!