|
1 | 1 | # Code Sharing Application
|
2 | 2 |
|
3 |
| -A Django-based web application designed for developers to share, organize, and manage code snippets efficiently. |
| 3 | +A Django-based web application that enables developers to share, organize, and manage code snippets efficiently. The platform is designed with productivity and collaboration in mind, offering robust features for storing, searching, and interacting with code examples. |
4 | 4 |
|
5 | 5 | ## Features
|
6 | 6 |
|
7 |
| -* **User Authentication**: Secure login and registration system. |
8 |
| -* **Code Snippet Management**: Users can create, edit, and delete their code snippets. |
9 |
| -* **Syntax Highlighting**: Supports multiple programming languages for better readability. |
10 |
| -* **Search Functionality**: Easily search through saved snippets. |
11 |
| -* **Responsive Design**: Accessible on both desktop and mobile devices. |
| 7 | +- **User Authentication:** Secure registration and login system for managing personal code snippets. |
| 8 | +- **Code Snippet Management:** Create, edit, and delete code snippets with metadata such as language, tags, and descriptions. |
| 9 | +- **Syntax Highlighting:** Supports multiple programming languages with syntax highlighting for enhanced readability. |
| 10 | +- **Search and Filter:** Quickly search and filter snippets by title, tags, language, and author. |
| 11 | +- **Bookmarks:** Bookmark favorite snippets for easy access. |
| 12 | +- **Rating System:** Mark snippets as useful or not useful to help surface high-quality content. |
| 13 | +- **Responsive Design:** Fully accessible on desktop and mobile devices. |
| 14 | +- **Author and Language Browsing:** Browse snippets by language or author for topical exploration. |
12 | 15 |
|
13 | 16 | ## Technologies Used
|
14 | 17 |
|
15 |
| -* **Backend**: Django (Python) |
16 |
| -* **Frontend**: HTML, CSS, JavaScript |
17 |
| -* **Database**: SQLite (default) |
| 18 | +- **Backend:** Django (Python) |
| 19 | +- **Frontend:** HTML, CSS (Bootstrap), JavaScript |
| 20 | +- **Database:** SQLite (default, easily configurable to other databases) |
| 21 | +- **Syntax Highlighting:** [Pygments](https://pygments.org/) |
18 | 22 |
|
19 | 23 | ## Installation
|
20 | 24 |
|
21 |
| -1. Clone the repository: |
22 |
| - |
| 25 | +1. **Clone the repository:** |
23 | 26 | ```bash
|
24 | 27 | git clone https://github.com/SulemanMughal/code-sharing.git
|
25 | 28 | cd code-sharing
|
26 | 29 | ```
|
27 | 30 |
|
28 |
| -2. Install dependencies: |
29 |
| - |
| 31 | +2. **Install dependencies:** |
30 | 32 | ```bash
|
31 | 33 | pip install -r requirements.txt
|
32 | 34 | ```
|
33 | 35 |
|
34 |
| -3. Apply migrations: |
35 |
| - |
| 36 | +3. **Apply migrations:** |
36 | 37 | ```bash
|
37 | 38 | python manage.py migrate
|
38 | 39 | ```
|
39 | 40 |
|
40 |
| -4. Create a superuser: |
41 |
| - |
| 41 | +4. **Create a superuser:** |
42 | 42 | ```bash
|
43 | 43 | python manage.py createsuperuser
|
44 | 44 | ```
|
45 | 45 |
|
46 |
| -5. Run the development server: |
47 |
| - |
| 46 | +5. **Run the development server:** |
48 | 47 | ```bash
|
49 | 48 | python manage.py runserver
|
50 | 49 | ```
|
51 | 50 |
|
52 |
| -6. Access the application at `http://127.0.0.1:8000/`. |
| 51 | +6. **Access the application:** |
| 52 | + Open your browser and visit [http://127.0.0.1:8000/](http://127.0.0.1:8000/). |
| 53 | + |
| 54 | +## Usage |
| 55 | + |
| 56 | +- Register or log in to start creating and managing your code snippets. |
| 57 | +- Use the navigation bar to view all snippets, browse by language, author, or manage your bookmarks. |
| 58 | +- Add new snippets with syntax highlighting and descriptive tags. |
| 59 | +- Bookmark and rate snippets to curate and promote useful code for the community. |
53 | 60 |
|
54 | 61 | ## Contributing
|
55 | 62 |
|
56 |
| -Contributions are welcome! Please fork the repository, make your changes, and submit a pull request. |
| 63 | +Contributions are welcome! Please fork the repository, create a feature branch, make your changes, and submit a pull request. |
| 64 | + |
| 65 | +1. Fork the repository |
| 66 | +2. Create your feature branch: `git checkout -b feature/YourFeature` |
| 67 | +3. Commit your changes: `git commit -am 'Add some feature'` |
| 68 | +4. Push to the branch: `git push origin feature/YourFeature` |
| 69 | +5. Open a pull request |
| 70 | + |
| 71 | +## License |
| 72 | + |
| 73 | +This project is licensed under the MIT License. |
| 74 | + |
| 75 | +## Contact |
| 76 | + |
| 77 | +For any questions or feedback, please open an issue or contact [SulemanMughal](https://github.com/SulemanMughal). |
0 commit comments