|
1 | | -# Django Blog App with HTMX |
| 1 | +# Django Blog app adevanced project |
2 | 2 |
|
3 | 3 |  |
4 | 4 |
|
5 | | -A modern and dynamic blog application built using **Django** and **HTMX**. This project demonstrates the integration of HTMX for building interactive and seamless user experiences without relying heavily on JavaScript frameworks. |
| 5 | +## Technologies: |
| 6 | + - Django |
| 7 | + - Django REST |
| 8 | + - Django Simple JWT |
| 9 | + - Authentication for JWT (RS256) |
| 10 | + - HTML, CSS, JavaScript, Bootstrap |
6 | 11 |
|
7 | | -## Features |
| 12 | +## Databases: |
| 13 | + + PostgreSQL |
| 14 | + + SQLite3 |
8 | 15 |
|
9 | | -- **HTMX Integration**: Enhance the user experience with partial page updates and AJAX-like behavior without writing JavaScript. |
10 | | -- **Post Creation and Editing**: Add, edit, and delete blog posts dynamically with inline forms. |
11 | | -- **Comments System**: Add, delete, and update comments without reloading the page. |
12 | | -- **User Authentication**: Register, log in, and log out functionality for users. |
13 | | -- **Responsive Design**: The UI is responsive and mobile-friendly. |
14 | | - |
15 | | -## Technologies Used |
16 | | - |
17 | | -- **Django**: Backend framework. |
18 | | -- **HTMX**: Frontend interactivity for handling requests and updates. |
19 | | -- **Bootstrap**: For responsive and modern UI design. |
20 | | -- **SQLite**: Default database for development. |
21 | | - |
22 | | -## Getting Started |
23 | | - |
24 | | -### Prerequisites |
25 | | - |
26 | | -Ensure you have the following installed: |
27 | | - |
28 | | -- Python 3.x |
29 | | -- Django 4.x |
30 | | -- HTMX |
31 | | - |
32 | | -### Installation |
33 | | - |
34 | | -1. Clone the repository: |
35 | | - |
36 | | - ```bash |
37 | | - git clone https://github.com/yourusername/django-blog-htmx.git |
38 | | - cd django-blog-htmx |
39 | | - ``` |
40 | | - |
41 | | -2. Create a virtual environment and activate it: |
42 | | - |
43 | | - ```bash |
44 | | - python -m venv env |
45 | | - source env/bin/activate # On Windows: `env\Scripts\activate` |
46 | | - ``` |
47 | | - |
48 | | -3. Install the required dependencies: |
49 | | - |
50 | | - ```bash |
51 | | - pip install -r requirements.txt |
52 | | - ``` |
53 | | - |
54 | | -4. Apply the migrations: |
55 | | - |
56 | | - ```bash |
57 | | - python manage.py migrate |
58 | | - ``` |
59 | | - |
60 | | -5. Run the development server: |
61 | | - |
62 | | - ```bash |
63 | | - python manage.py runserver |
64 | | - ``` |
65 | | - |
66 | | -6. Open the app in your browser: |
67 | | - |
68 | | - ``` |
69 | | - http://127.0.0.1:8000/ |
70 | | - ``` |
71 | | - |
72 | | -### Usage |
73 | | - |
74 | | -- Create a new post, edit existing posts, and add comments to any post. All updates are handled smoothly using HTMX for a better user experience. |
75 | | -<<<<<<< HEAD |
76 | | - |
77 | | -## Project Structure |
78 | | -======= |
79 | | ->>>>>>> master |
| 16 | +[Documentations](docs/index.md) |
0 commit comments