https://github.com/django-dev-br/007-django5-custom-404-error-page
Adicionando uma página de erro 404 customizada a um App de um projeto Django
https://github.com/django-dev-br/007-django5-custom-404-error-page
404 404-error-page 404-errors 404-not-found 404-page 404-pages 404-template django django-application django-framework django-project
Last synced: 8 months ago
JSON representation
Adicionando uma página de erro 404 customizada a um App de um projeto Django
- Host: GitHub
- URL: https://github.com/django-dev-br/007-django5-custom-404-error-page
- Owner: Django-Dev-Br
- License: mit
- Archived: true
- Created: 2024-08-25T05:05:03.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-10-08T17:50:38.000Z (about 1 year ago)
- Last Synced: 2025-02-10T00:42:34.411Z (8 months ago)
- Topics: 404, 404-error-page, 404-errors, 404-not-found, 404-page, 404-pages, 404-template, django, django-application, django-framework, django-project
- Language: Python
- Homepage: https://www.django.dev.br
- Size: 42 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 007 Django 4 Custom 404 Error Page
### O que é uma Página de Erro 404 Personalizada?
Uma página de erro 404 personalizada melhora a experiência do usuário ao fornecer uma mensagem clara e útil quando uma página não é encontrada. No Django, você pode criar uma página de erro 404 personalizada simplesmente adicionando um arquivo `404.html` no diretório de templates e ajustando as configurações para servir esta página.
## COMO RODAR ESSE PROJETO EM SEU COMPUTADOR:
### Requisitos
- **Python 3.12 com PIP e venv**
- **o Django 5 requer Python 3.10 ou superior.**
- **No [repositório 001](https://github.com/Django-Dev-Br/001-django4-basic-project) há explicações sobre PIP e venv**
[Baixar Python 3.12](https://www.python.org/downloads/release/python-3122/)
Confira o vídeo para saber como trabalhar com múltiplas versões do Python e com venv (ambiente virtual):
[](https://youtu.be/eetDeQrv0Rs)
### 7 passos simples para executar
1. **Clone o repositório**:
```bash
git clone https://github.com/Django-Dev-Br/007-Django5-Custom-404-Error-Page.git
```
2. **Crie um ambiente virtual**:
**Windows**
```bash
python -m venv myvenv
```
**Linux**
```bash
python3 -m venv myvenv
```
3. **Ative o ambiente virtual criado**:
**Windows**
```bash
myvenv\Scripts\activate
```
**Linux**
```bash
source myvenv/bin/activate
```
4. **Acesse a pasta do repositório**:
```bash
cd 007-Django5-Custom-404-Error-Page
```
5. **Instale o Django**:
Fazer a instalação após a ativação da virtual env fará com que a instalação seja feita nessa pasta ao invés do computador. Isso significa que o pacote Django não estará disponivel para todos os usuários do computador, mas apenas para o contexto no qual essa venv esteja ativada. Veremos sua ativação logo abaixo.
**Instalação manualmente via gerenciador de dependências PIP**
```bash
pip install django
```
- use, preferencialmente, a versão 5.1. Para tanto, execute o comando:
```bash
pip install "django>=5.1,<=5.2"
```
----- **OU** -----
**Instalação via arquivo requirements**
```bash
pip install -r requirements.txt
```
O arquivo requirements.txt é um arquivo de texto que contém uma lista de pacotes a ser instalado em uma venv. É uma boa prática de programação do ecossistema Python.
6. **Configurar uma Página de Erro 404 Personalizada**:
- Crie uma pasta chamada templates em seu App Django
- Crie um arquivo chamado `404.html` dentro da pasta supracitada.
- Adicione o seguinte conteúdo ao arquivo `404.html`:
```html
Página Não Encontrada
Erro 404
Desculpe, a página que você está procurando não foi encontrada.
```
- Certifique-se de que seu `settings.py` inclua a configuração para usar a página de erro 404 personalizada:
```python
# settings.py
DEBUG = False # mostra a página de erro ao invés da página de DEBUG
ALLOWED_HOSTS = ['*'] # Obs: Essa configuração é apenas para o ambiente local de desenvolvimento.
```
7. **Execute o servidor de desenvolvimento**:
```bash
python manage.py runserver
```
### Testando a Página de Erro 404
- Acesse uma URL inexistente no seu navegador, por exemplo: [http://127.0.0.1:8000/nao-existe](http://127.0.0.1:8000/nao-existe)
- Você verá a página de erro 404 personalizada que você configurou.
### Estrutura de Diretórios do Projeto
```
007-django5-custom-404-error-page/
├── myproject/
│ ├── __init__.py # Marca o diretório como um pacote Python
│ ├── asgi.py # Configurações para o servidor ASGI (usado para aplicações assíncronas)
│ ├── settings.py # Configurações do projeto (incluindo ALLOWED_HOSTS e DEBUG)
│ ├── urls.py # Mapeamento de requisições HTTP e redirecionamento para os templates HTML
│ └── wsgi.py # Configurações para o servidor WSGI (usado para servir a aplicação)
├── myapp/
│ ├── __init__.py # Marca o diretório como um pacote Python
│ ├── apps.py # Configurações do app
│ ├── views.py # Funções de view para o app
│ └── templates/
│ └── 404.html # Página de erro 404 personalizada
└── manage.py # CLI do Django, um script de linha de comando para tarefas administrativas do Django
└── requirements.txt # Lista de pacotes Python necessários para o projeto
```
### Sobre Nosso Treinamento Prático-Profissional com projeto real para iniciantes e avançados em web DevOps Full-stack com Python, Django, Bootstrap e Linux.
[Django Developers Brasil - Aprenda programando enquanto programa aprendendo!](https://django.dev.br/)
Nosso treinamento oferece uma experiência prática de aprendizado de programação, adequada tanto para iniciantes quanto para desenvolvedores avançados. Você participará de um projeto real de desenvolvimento de software em um ambiente corporativo autêntico, onde pessoas com diferentes níveis de conhecimento irão colaborar, aprendendo umas com as outras.
**Junte-se a nós!** E desenvolva as habilidades necessárias para o mercado de trabalho, aprimorando tanto seus conhecimentos técnicos quanto suas soft skills em um ambiente colaborativo e realista.