Files
django-girls/README.md
T
2022-09-09 17:06:06 +00:00

59 lines
1.7 KiB
Markdown

# Complete Django Girls Tutorial
This repository contains the code that one would eventually have were they to go through the [Django Girls tutorial](https://tutorial.djangogirls.org/en/).
[![CircleCI](https://circleci.com/gh/NdagiStanley/django_girls_complete.svg?style=svg)](https://circleci.com/gh/NdagiStanley/django_girls_complete)
## Differences
Expressing my authorial rights, some things are a bit different from the tutorial:
- A `Log in` and `Log out` links on the page header
- A `Back` link within the *blog-detail* and *blog-edit* pages
- A more extensive `.gitignore` file
- A `.editorconfig` file
- An additional python package in the requirements.txt: `pycodestyle`
- Within `mysite/settings.py`,
- Use of `Africa/Nairobi` as my *TIME_ZONE*
- Use of `en-us` as my *LANGUAGE_CODE*
- Addition of `0.0.0.0` and `.herokuapp.com` to the *ALLOWED_HOSTS* list
## Setup
In a python virtual environment, run:
- `pip install -r requirements.txt`
- `python manage.py migrate blog`
- `python manage.py createsuperuser` (to create user that you'll use to log in)
### Run the application
```bash
python manage.py runserver
```
Now, you are good to go. Your blog is ready.
### Test
```bash
python manage.py test
```
The application will be live at [0.0.0.0:8000](0.0.0.0:8000)
### Log in/ out
- Click on `Log in` (you'll be redirected to the Admin page)
- On the admin page, fill in the credentials of the superuser created in [Setup](#setup)
- Click on the *Log in* button (You'll be redirected back to the page)
- Click on `Log out` to log out.
### Blog entry
- Log in
- Click on the `+` button, enter the _**title**_ and _**text**_
- Finally hit the `Save` button