Merge pull request #1892 from jacebrowning/use-django-5.2

das-g · web-flow · commit 451f983299d0 · 2026-04-07T14:37:40.000+02:00
Use Django 5.2 to support both latest Python and PythonAnywhere
diff --git a/book.json b/book.json
@@ -1,12 +1,13 @@
 {
     "gitbook": ">=3.2.0",
     "variables": {
-      "py_version": "3.12",
-      "py_release": "3.12.3",
+      "py_version": "3.14",
+      "py_release": "3.14.3",
       "py_min_version": "3.10",
       "py_min_release": "3.10.13",
       "pa_py_version": "3.10",
-      "django_version": "5.1.2"
+      "django_version": "5.2.12",
+      "docs_version": "5.2"
     },
     "links": {
     },
diff --git a/en/deploy/pythonanywhere.md b/en/deploy/pythonanywhere.md
@@ -68,7 +68,7 @@ You can also go to the "Files" page and navigate around using PythonAnywhere's b
 Your site should now be live on the public Internet!  Click through to the PythonAnywhere "Web" page to get a link to it. You can share this with anyone you want. :)
 
 
-> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view.  If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/5.1/howto/deployment/checklist/) for some tips on securing your site.
+> **Note** This is a beginners' tutorial, and in deploying this site we've taken a few shortcuts which aren't ideal from a security point of view.  If and when you decide to build on this project, or start a new project, you should review the [Django deployment checklist](https://docs.djangoproject.com/en/{{ book.docs_version }}/howto/deployment/checklist/) for some tips on securing your site.
 
 ## Debugging tips
 
diff --git a/en/django_admin/README.md b/en/django_admin/README.md
@@ -52,6 +52,6 @@ Make sure that at least two or three posts (but not all) have the publish date s
 
 ![Django admin](images/edit_post3.png)
 
-If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/5.1/ref/contrib/admin/
+If you want to know more about Django admin, you should check Django's documentation: https://docs.djangoproject.com/en/{{ book.docs_version }}/ref/contrib/admin/
 
 This is probably a good moment to grab a coffee (or tea) or something to eat to re-energize yourself. You created your first Django model – you deserve a little break!
diff --git a/en/django_forms/README.md b/en/django_forms/README.md
@@ -374,7 +374,7 @@ Feel free to change the title or the text and save the changes!
 
 Congratulations! Your application is getting more and more complete!
 
-If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/5.1/topics/forms/
+If you need more information about Django forms, you should read the documentation: https://docs.djangoproject.com/en/{{ book.docs_version }}/topics/forms/
 
 ## Security
 
diff --git a/en/django_models/README.md b/en/django_models/README.md
@@ -164,7 +164,7 @@ Now we define the properties we were talking about: `title`, `text`, `created_da
 - `models.DateTimeField` – this is a date and time.
 - `models.ForeignKey` – this is a link to another model.
 
-We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/5.1/ref/models/fields/#field-types).
+We will not explain every bit of code here since it would take too much time. You should take a look at Django's documentation if you want to know more about Model fields and how to define things other than those described above (https://docs.djangoproject.com/en/{{ book.docs_version }}/ref/models/fields/#field-types).
 
 What about `def publish(self):`? This is exactly the `publish` method we were talking about before. `def` means that this is a function/method and `publish` is the name of the method. You can change the name of the method if you want. The naming rule is that we use lowercase and underscores instead of spaces. For example,  a method that calculates average price could be called `calculate_average_price`.
 
diff --git a/en/django_start_project/README.md b/en/django_start_project/README.md
@@ -95,7 +95,7 @@ TIME_ZONE = 'Europe/Berlin'
 
 #### Changing the Language
 
-A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/5.1/ref/settings/#language-code).
+A language code consist of the language, e.g. `en` for English or `de` for German, and the country code, e.g. `de` for Germany or `ch` for Switzerland. If English is not your native language, you can add this to change the default buttons and notifications from Django to be in your language. So you would have "Cancel" button translated into the language you defined here. [Django comes with a lot of prepared translations](https://docs.djangoproject.com/en/{{ book.docs_version }}/ref/settings/#language-code).
 
 If you want a different language, change the language code by changing the following line:
 
diff --git a/en/django_urls/README.md b/en/django_urls/README.md
@@ -112,4 +112,4 @@ Your console is showing an error, but don't worry – it's actually pretty usefu
 If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
 
 
-> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/5.1/topics/http/urls/
+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/{{ book.docs_version }}/topics/http/urls/
diff --git a/en/django_views/README.md b/en/django_views/README.md
@@ -45,4 +45,4 @@ Another error! Read what's going on now:
 
 This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the *TemplateDoesNotExist*. Let's fix this bug and create a template in the next chapter!
 
-> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/5.1/topics/http/views/
+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/{{ book.docs_version }}/topics/http/views/
diff --git a/en/dynamic_data_in_templates/README.md b/en/dynamic_data_in_templates/README.md
@@ -75,4 +75,4 @@ def post_list(request):
 
 That's it! Time to go back to our template and display this QuerySet!
 
-Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/5.1/ref/models/querysets/
+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/{{ book.docs_version }}/ref/models/querysets/
diff --git a/en/whats_next/README.md b/en/whats_next/README.md
@@ -14,7 +14,7 @@ Yes! There are a _lot_ of resources online for learning all kinds of programming
 
 #### Django
 - Our other book, [Django Girls Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
-- [Django's official tutorial](https://docs.djangoproject.com/en/5.1/intro/tutorial01/)
+- [Django's official tutorial](https://docs.djangoproject.com/en/{{ book.docs_version }}/intro/tutorial01/)
 - [Getting Started With Django video lessons](https://thekennethlove.com/videos/)
 - [Django for Everybody Specialization](https://www.coursera.org/specializations/django) – some video lectures can be audited for free and you can earn a Coursera Certificate by taking these courses
 

Original file line number	Diff line number	Diff line change
`@@ -112,4 +112,4 @@ Your console is showing an error, but don't worry – it's actually pretty usefu`
`112`	`112`	If you see a different error message, try restarting your web server. To do that, in the console window that is running the web server, stop it by pressing Ctrl+C (the Control and C keys together). On Windows, you might have to press Ctrl+Break. Then you need to restart the web server by running a `python manage.py runserver` command.
`113`	`113`
`114`	`114`
`115`		`-> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/5.1/topics/http/urls/`
	`115`	`+> If you want to know more about Django URLconfs, look at the official documentation: https://docs.djangoproject.com/en/{{ book.docs_version }}/topics/http/urls/`
Original file line number	Diff line number	Diff line change
`@@ -45,4 +45,4 @@ Another error! Read what's going on now:`
`45`	`45`
`46`	`46`	`This shows that the server is running again, at least, but it still doesn't look right, does it? Don't worry, it's just an error page, nothing to be scared of! Just like the error messages in the console, these are actually pretty useful. You can read that the TemplateDoesNotExist. Let's fix this bug and create a template in the next chapter!`
`47`	`47`
`48`		`-> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/5.1/topics/http/views/`
	`48`	`+> Learn more about Django views by reading the official documentation: https://docs.djangoproject.com/en/{{ book.docs_version }}/topics/http/views/`
Original file line number	Diff line number	Diff line change
`@@ -75,4 +75,4 @@ def post_list(request):`
`75`	`75`
`76`	`76`	`That's it! Time to go back to our template and display this QuerySet!`
`77`	`77`
`78`		`-Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/5.1/ref/models/querysets/`
	`78`	`+Want to read a little bit more about QuerySets in Django? You should look here: https://docs.djangoproject.com/en/{{ book.docs_version }}/ref/models/querysets/`