Skip to content

Commit ed09eb6

Browse files
committed
UPD Footer Links
1 parent 84442cd commit ed09eb6

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

56 files changed

+235
-217
lines changed

docs/content/tutorials/django-authentication-system.mdx

Lines changed: 17 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,29 @@
11
---
2-
sidebar_position: 5
3-
description: Learn how to manage users in Django with ease - tutorial for beginners.
2+
title : Django Auth System
3+
sidebar_label : Django Auth
44
---
55

66
# Django Auth System
77

88
<SubHeading>Learn how to manage users in Django with ease - tutorial for beginners.</SubHeading>
99

10-
Being a "batteries-included" framework, Django comes with a powerful authentication/authorization system that we can use and extend in our projects with ease. For those that start from nothing, feel free to access the resources mentioned below and come back here once the content is understood:
10+
Being a "batteries-included" framework, Django comes with a powerful authentication/authorization system that we can use and extend in our projects with ease.
11+
For those that start from nothing, feel free to access the resources mentioned below and come back here once the content is understood:
1112

1213
- [How to install Django](django-how-to-install.mdx) - simple, tested steps to install Django
1314
- [Django for beginners](django-for-beginners.mdx) - a comprehensive tutorial that covers the basics
1415

15-
> Topics covered in this tutorial
16+
![Django Auth System - Tutorial provided by AppSeed.](https://user-images.githubusercontent.com/51070104/268675023-54ea4ace-a8ad-442b-9b43-2ba12a6403ba.jpg)
17+
18+
> **Topics covered in this tutorial**
1619
1720
- `User` the table where the information is saved
1821
- How to create a new user using the Django CLI
1922
- How to create a `superuser`
2023
- How to `update the password` - Django CLI
2124
- Create a user using forms
2225

23-
### User Model
26+
## User Model
2427

2528
As mentioned in the official Django documentation, the **User** model represents the core entity used to save and manage authentication. The fields managed by the User model can be found below:
2629

@@ -59,7 +62,7 @@ $ .\env\Scripts\activate
5962
$ pip install django
6063
```
6164

62-
### Create Users - Django CLI
65+
## Create Users - Django CLI
6366

6467
The user creation process using the terminal is usually related to the `superuser` that allows us to access the `admin` section. For newcomers, the admin section manages the registered users, groups defined in our project.
6568

@@ -111,9 +114,7 @@ As we can see, new users can be created with ease using the `create-user` helper
111114
<QuerySet [<User: admin>, <User: test>]>
112115
```
113116

114-
115-
116-
### Create Users via UI
117+
## ✅ Create Users via UI
117118

118119
Using the console to create and manage users might be fun but might be also useful in our projects to allow users to register themselves using a public web page. To do this, we need a simple page where the form is exposed and a backend to handle the information sent to the user.
119120

@@ -257,7 +258,7 @@ def register_user(request):
257258
return render(request, "accounts/register.html", {"form": form, "msg" : msg })
258259
```
259260

260-
### Authenticated User
261+
## Authenticated User
261262

262263
Django hooks the authenticated in the `request` object and we can check if a request is done by an authenticated user or not by calling a helper. The same check is available in views.
263264

@@ -290,7 +291,7 @@ def testme(path):
290291
{% endraw %}
291292
```
292293

293-
### Logout Users
294+
## Logout Users
294295

295296
The `logout` helper is provided by `Django.contrib.auth` middleware package:
296297

@@ -306,7 +307,9 @@ If the user is authenticated all session information will be deleted. If the use
306307

307308
> Thanks for reading! For more topics, feel free to [contact](https://appseed.us/support) Appseed.
308309
309-
### Resources
310+
## Resources
310311

311-
- Read more about [Django](https://www.djangoproject.com/) (official docs)
312-
- Start fast a new project using _development-ready_ [Django Starters](https://appseed.us/admin-dashboards/django)
312+
- 👉 Access [AppSeed](https://appseed.us/) and start your next project
313+
- 👉 [Deploy Projects on Aws, Azure, and DO](https://www.docs.deploypro.dev/) via **DeployPRO**
314+
- 👉 Create landing pages with [Simpllo, an open-source site builder](https://www.simpllo.com/)
315+
- 👉 [Django App Generator](https://app-generator.dev/django/) - A 2nd generation App Builder

docs/content/tutorials/django-for-beginners.mdx

Lines changed: 25 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,19 @@
11
---
2-
sidebar_position: 2
3-
description: A comprehensive introduction to Django for beginners
2+
title : Django For Beginners
3+
sidebar_label : Django For Beginners
44
---
55

66
# Django For Beginners
77

88
<SubHeading>A comprehensive introduction to Django for beginners</SubHeading>
99

10-
This tutorial aims to help beginners getting started with Django, a popular Web Framework written in Python. To get maximum from this content, the audience should be familiar with a terminal and have a minimal set of tools already installed. [Python3](https://www.python.org/), a modern code editor ([VsCode](https://code.visualstudio.com/), [Atom](https://atom.io/)), and [GIT](https://git-scm.com/) versioning command-line tool should be enough to experiment with all the code.
10+
This tutorial aims to help beginners getting started with Django, a popular Web Framework written in Python.
11+
To get maximum from this content, the audience should be familiar with a terminal and have a minimal set of tools already installed.
12+
[Python3](https://www.python.org/), a modern code editor ([VsCode](https://code.visualstudio.com/), [Atom](https://atom.io/)), and [GIT](https://git-scm.com/) versioning command-line tool should be enough to experiment with all the code.
1113

12-
### Install Python
14+
![Django For Beginners - Tutorial provided by AppSeed.](https://user-images.githubusercontent.com/51070104/268675023-54ea4ace-a8ad-442b-9b43-2ba12a6403ba.jpg)
15+
16+
## ✅ Install Python
1317

1418
The core of dependency for Django is Python and we should install the interpreter first. Most of the systems come with Python already installed and we can easily check in the terminal:
1519

@@ -18,9 +22,12 @@ $ python --version
1822
Python 3.8.4 <-- All Good
1923
```
2024

21-
If the version displayed in the terminal is Python2, please note that this version [has been discontinued](https://www.python.org/doc/sunset-python-2/) for versioning and development since Jan.2020. To download and install Python access the [official page](https://www.python.org/downloads/), select the installer that matches the operating system, and follow the installation setup. Once the process is finished, recheck the Python version in the terminal.
25+
If the version displayed in the terminal is Python2, please note that this version [has been discontinued](https://www.python.org/doc/sunset-python-2/) for versioning and development since Jan.2020.
26+
To download and install Python access the [official page](https://www.python.org/downloads/), select the installer that matches the operating system, and follow the installation setup.
27+
28+
Once the process is finished, recheck the Python version in the terminal.
2229

23-
### Manage Dependencies
30+
## Manage Dependencies
2431

2532
With **Python** up and running, we can install Django and other modules required by our development. The recommended way to install and manage the dependencies for a Python project is to use a virtual environment, a safe way to isolate the dependencies across multiple projects.
2633

@@ -45,7 +52,7 @@ $ pip install django
4552

4653
The above command will install the latest stable version of Django. From this point, we can use all tools provided by Django to create a new project, apps and manage the project via Django CLI.
4754

48-
### Install a Code Editor
55+
## Install a Code Editor
4956

5057
This section has plenty of options from the old-school (yet modern) [Vim](https://www.vim.org/download.php) to [VsCode](https://code.visualstudio.com/) and [Atom](https://atom.io/). For those unfamiliar with any of these tools, VsCode might be a good choice to get started fast.
5158

@@ -54,7 +61,7 @@ This section has plenty of options from the old-school (yet modern) [Vim](https:
5461

5562
![Programming Kit - VSCode editor.](../../../static/assets/programming-kit-vscode.jpg)
5663

57-
### Build a Django Project
64+
## Build a Django Project
5865

5966
A new project can be generated with ease in Django by using _django-admin_ that provides a collection of settings for the database, Django, and security layer.
6067

@@ -92,7 +99,7 @@ At this point we should see the default Django page in the browser:
9299

93100
![Django - Default Project Page.](../../../static/assets/django-framework-cover-xs.png)
94101

95-
### Create New Application
102+
## Create New Application
96103

97104
In the previous section, we've generated the core of the project that handles the configuration and now we will create the first Django application to serve a simple page to the users.
98105

@@ -149,9 +156,10 @@ After saving all changes we should no longer see the Django default page (the on
149156

150157
![Django For Beginners - The first page.](<../../../static/assets/image (9).png>)
151158

152-
### Create New Model
159+
## Create New Model
153160

154-
Even simple applications require minimal storage for persistent data. Django provides _out-of-the-box_ an SQLite database, just to help us start fast. During this section, we will create and interact with a new table (model).
161+
Even simple applications require minimal storage for persistent data. Django provides _out-of-the-box_ an SQLite database, just to help us start fast.
162+
During this section, we will create and interact with a new table (model).
155163

156164
> Visualize the default SQL settings - `config/settings.py`
157165
@@ -265,9 +273,7 @@ $ python manage.py shell
265273

266274
```
267275

268-
###
269-
270-
### Using Admin Section
276+
## ✅ Using Admin Section
271277

272278
**Django** comes by default with a usable admin dashboard that allows us to manage all app models and users with ease. In order to access the module, a `superuser` should be created using the Django CLI:
273279

@@ -308,7 +314,9 @@ admin.site.register(Book) # <- NEW
308314

309315
> Thanks for reading! For more topics, feel free to [contact](https://appseed.us/support) Appseed.
310316
311-
### Resources
317+
## Resources
312318

313-
- Read more about [Django](https://www.djangoproject.com/) (official docs)
314-
- Start fast a new project using _development-ready_ [Django Starters](https://appseed.us/admin-dashboards/django)
319+
- 👉 Access [AppSeed](https://appseed.us/) and start your next project
320+
- 👉 [Deploy Projects on Aws, Azure, and DO](https://www.docs.deploypro.dev/) via **DeployPRO**
321+
- 👉 Create landing pages with [Simpllo, an open-source site builder](https://www.simpllo.com/)
322+
- 👉 [Django App Generator](https://app-generator.dev/django/) - A 2nd generation App Builder

docs/content/tutorials/django-forms.mdx

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,22 @@
11
---
2-
sidebar_position: 4
3-
description: Learn how to manage forms in Django - For beginners
2+
title : Django Forms
3+
sidebar_label : Django Forms
44
---
55

66
# Django Forms
77

88
<SubHeading>Learn how to manage forms in Django - For beginners</SubHeading>
99

10-
This page explains how to **manage and validate a form in Django** Framework. We assume the audience has already a Django project up and running. For those that start from nothing, feel free to access the resources mentioned below and come back here once the content is understood:
10+
This page explains how to **manage and validate a form in Django** Framework. We assume the audience has already a Django project up and running.
11+
12+
For those that start from nothing, feel free to access the resources mentioned below and come back here once the content is understood:
1113

1214
- 👉 [How to install Django](django-how-to-install.mdx) - simple, tested steps to install Django
1315
- 👉 [Django for beginners](django-for-beginners.mdx) - a comprehensive tutorial that covers the basics
1416

15-
> Topics covered by this tutorial
17+
![Django Forms - Tutorial provided by AppSeed.](https://user-images.githubusercontent.com/51070104/268675023-54ea4ace-a8ad-442b-9b43-2ba12a6403ba.jpg)
18+
19+
> **Topics covered by this tutorial**
1620
1721
- ✅ Create a new Django app
1822
- ✅ Define a new route
@@ -25,7 +29,7 @@ The video presentation of this tutorial can be found on Github:
2529

2630
<YoutubeEmbed url="https://www.youtube.com/embed/te350w1WwfQ" title="Django For Beginners - How to add a new form" />
2731

28-
## Create a new Application
32+
## Create a new Application
2933

3034
> For this, we will use the `startapp` Django subcommand:
3135
@@ -91,9 +95,7 @@ Once we restart the project, the new route `/forms` should be visible:
9195

9296
![Django Forms - A Hello-World type route](../../../static/assets/django-forms-simple-route.jpg)
9397

94-
\
95-
96-
## Define a new form
98+
## ✅ Define a new form
9799

98100
Inside the newly created app, we need to create a `forms` file and define the new Form Class object.
99101

@@ -109,8 +111,6 @@ class HelloForm(forms.Form):
109111
email = forms.EmailField(required=False)
110112
```
111113

112-
\
113-
114114
> Controller code - `forms/views.py`, the `index()` method
115115
116116
```python
@@ -154,7 +154,6 @@ TEMPLATES = [
154154
]
155155
```
156156

157-
\
158157

159158
> HTML page - defined in `forms/templates` folder:
160159
@@ -174,7 +173,6 @@ TEMPLATES = [
174173

175174
If all fields are provided, on submit, we should see the `Form is valid` message.
176175

177-
\
178176

179177
> Update the form with a new field `ID` (numeric type):
180178
@@ -195,7 +193,9 @@ class HelloForm(forms.Form):
195193

196194
> Thanks for reading! For more topics, feel free to [contact](https://appseed.us/support) Appseed.
197195
198-
## Resources
196+
## Resources
199197

200-
- Read more about [Django](https://www.djangoproject.com/) (official docs)
201-
- Start fast a new project using _development-ready_ [Django Starters](https://appseed.us/admin-dashboards/django)
198+
- 👉 Access [AppSeed](https://appseed.us/) and start your next project
199+
- 👉 [Deploy Projects on Aws, Azure, and DO](https://www.docs.deploypro.dev/) via **DeployPRO**
200+
- 👉 Create landing pages with [Simpllo, an open-source site builder](https://www.simpllo.com/)
201+
- 👉 [Django App Generator](https://app-generator.dev/django/) - A 2nd generation App Builder

docs/content/tutorials/django-how-to-install.mdx

Lines changed: 14 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,18 @@
11
---
2-
sidebar_position: 1
3-
description: The page explains how to install Django using a Virtual Environment
2+
title : Django - How to Install
3+
sidebar_label : Django Install
44
---
55

66
# Django - How to Install
77

88
<SubHeading>The page explains how to install Django using a Virtual Environment</SubHeading>
99

10-
Django is a popular framework written in Python used to code modern and secure web applications much faster. Install Django is the first step of this journey and during this short tutorial, we will learn how to properly install Django using a Virtual Environment.
10+
Django is a popular framework written in Python used to code modern and secure web applications much faster.
11+
Install Django is the first step of this journey and during this short tutorial, we will learn how to properly install Django using a Virtual Environment.
1112

12-
> Content Features:
13+
![Django, How to Install - Tutorial provided by AppSeed.](https://user-images.githubusercontent.com/51070104/268675023-54ea4ace-a8ad-442b-9b43-2ba12a6403ba.jpg)
1314

14-
- Level: **beginners**
15-
- Mentioned Topics:
16-
17-
- Django
18-
- Virtual Environment
19-
- Basic command-line commands
20-
21-
### What is Django
15+
## ✅ What is Django
2216

2317
For newcomers, Django is a popular framework built by experienced developers, actively supported by an impressive open-source community. Django comes with _batteries included_ concept and provides modules to handle the **database**, **authentication**, **built-in security**, plus a powerful command-line interface to interact with our app. To start learning Django feel free to access:
2418

@@ -28,7 +22,7 @@ For newcomers, Django is a popular framework built by experienced developers, ac
2822

2923
![Django Framework - New Project Start Page.](../../../static/assets/django-framework-cover.jpg)
3024

31-
### Virtual Environments
25+
## Virtual Environments
3226

3327
A virtual environment helps us to keep isolated the dependencies used by different Python projects. A simple `use case` might be this one: we have installed locally two Python apps that use different versions of a common library, Django for instance. Without using a virtual environment the only choice is to install the dependencies in the global environment and this might affect the stability and behavior of both apps.
3428

@@ -60,7 +54,7 @@ $ .\env\Scripts\activate
6054
(env) $
6155
```
6256

63-
### Install Django
57+
## Install Django
6458

6559
The recommended way to install Python packages is to use PIP, the official package manager for Python.
6660

@@ -100,7 +94,7 @@ The removal of a Python package can be done with ease via `pip`:
10094

10195
At this point, Django is no longer available in our virtual environment.
10296

103-
### Deactivate Virtual Environment
97+
## Deactivate Virtual Environment
10498

10599
Once the work is finished, to leave the virtual environment we need to type:
106100

@@ -114,10 +108,9 @@ After running `deactivate` command, the console prefix should be removed by the
114108
$ # no environment prefix
115109
```
116110

117-
### Resources
118-
119-
To learn more about Python, **Virtual environments,** or get support, please access:
111+
## ✅ Resources
120112

121-
- [Python](https://www.python.org/) - official website
122-
- [Virtual Environments](https://docs.python.org/3/tutorial/venv.html) - official docs
123-
- Join [AppSeed](https://appseed.us/) and ask for [support](https://appseed.us/support) - for **registered users**
113+
- 👉 Access [AppSeed](https://appseed.us/) and start your next project
114+
- 👉 [Deploy Projects on Aws, Azure, and DO](https://www.docs.deploypro.dev/) via **DeployPRO**
115+
- 👉 Create landing pages with [Simpllo, an open-source site builder](https://www.simpllo.com/)
116+
- 👉 [Django App Generator](https://app-generator.dev/django/) - A 2nd generation App Builder

0 commit comments

Comments
 (0)