|
1 | | -This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app). |
2 | 1 |
|
3 | | -## Getting Started |
| 2 | +# **AcademiaDrive - University Notes Sharing Platform** |
4 | 3 |
|
5 | | -First, run the development server: |
| 4 | +Welcome to **AcademiaDrive**, a platform designed to solve the problem of accessing and sharing study materials within your university or college. If your university doesn't provide easy access to study materials, or if you just want to make your own notes available to others, **AcademiaDrive** is the solution. |
| 5 | + |
| 6 | +The platform takes your existing Google Drive-based file-sharing system and upgrades it to a **GitHub Pages**-hosted website, making it more user-friendly and easily accessible for everyone in your college or university. |
| 7 | + |
| 8 | +### **How It Works:** |
| 9 | + |
| 10 | +**AcademiaDrive** allows you to create, upload, and share your notes in a simple, clean way. All you need to do is create a folder structure inside the **public** folder, upload your notes, and the website automatically reflects the changes. |
| 11 | + |
| 12 | +--- |
| 13 | + |
| 14 | +## **How to Use and Contribute:** |
| 15 | + |
| 16 | +### 1. **Fork the Repository:** |
| 17 | + |
| 18 | +* Visit the [AcademiaDrive GitHub Repository](https://github.com/yourusername/academiadrive). |
| 19 | +* Click the **Fork** button on the top-right to create a copy of this repository under your GitHub account. |
| 20 | + |
| 21 | +### 2. **Clone the Repository:** |
| 22 | + |
| 23 | +After forking, clone the repository to your local machine: |
| 24 | + |
| 25 | +```bash |
| 26 | +git clone https://github.com/yourusername/academiadrive.git |
| 27 | +cd academiadrive |
| 28 | +``` |
| 29 | + |
| 30 | +### 3. **Upload Your Notes:** |
| 31 | + |
| 32 | +* Inside the **public** folder, create folders to organize your notes however you like. It can be by course, subject, or even by specific topics. |
| 33 | +* You can add any kind of study material, such as PDF files, notes, slides, videos, and more. |
| 34 | +* Example structure: |
| 35 | + |
| 36 | + ``` |
| 37 | + public/academiadrive/ |
| 38 | + ├── Math101/ |
| 39 | + │ └── Math_Notes.pdf |
| 40 | + ├── CS201/ |
| 41 | + │ └── CS_Slides.pdf |
| 42 | + ├── Physics/ |
| 43 | + │ └── Physics_Notes.pdf |
| 44 | + ├── Videos/ |
| 45 | + │ └── Lecture1.mp4 |
| 46 | + ``` |
| 47 | + |
| 48 | +### 4. **Commit Your Changes:** |
| 49 | + |
| 50 | +Once you've added your notes, commit and push your changes: |
6 | 51 |
|
7 | 52 | ```bash |
8 | | -npm run dev |
9 | | -# or |
10 | | -yarn dev |
11 | | -# or |
12 | | -pnpm dev |
13 | | -# or |
14 | | -bun dev |
| 53 | +git add . |
| 54 | +git commit -m "Added Math101 and CS201 notes" |
| 55 | +git push origin main |
15 | 56 | ``` |
16 | 57 |
|
17 | | -Open [http://localhost:3000](http://localhost:3000) with your browser to see the result. |
| 58 | +### 5. **Create a Pull Request (PR):** |
| 59 | + |
| 60 | +* After pushing your changes, go to the **Pull Requests** tab and create a **New Pull Request** to merge your changes into the main repository. This will make your notes available to everyone in your university or college. |
| 61 | + |
| 62 | +### 6. **Accessing Notes:** |
| 63 | + |
| 64 | +* After your changes are merged, the newly added notes will be accessible through the website hosted on GitHub Pages. |
| 65 | +* Students can browse the folders by course, subject, or topic and download the materials they need. |
| 66 | + |
| 67 | +--- |
| 68 | + |
| 69 | + |
| 70 | +## **Folder Structure Explanation:** |
| 71 | + |
| 72 | +You have full flexibility to organize your notes however you like! Here are a few examples of how to structure your folders within `public/academiadrive/`: |
| 73 | + |
| 74 | +### 1. **By Course:** |
| 75 | + |
| 76 | +Organize your notes by course name or code: |
| 77 | + |
| 78 | +```plaintext |
| 79 | +public/academiadrive/ |
| 80 | +├── CS101/ |
| 81 | +├── MATH201/ |
| 82 | +├── BIO102/ |
| 83 | +``` |
| 84 | + |
| 85 | +### 2. **By Subject:** |
| 86 | + |
| 87 | +Organize your notes by subject area, such as Math, Computer Science, or Physics: |
| 88 | + |
| 89 | +```plaintext |
| 90 | +public/academiadrive/ |
| 91 | +├── Math/ |
| 92 | +├── ComputerScience/ |
| 93 | +├── Physics/ |
| 94 | +``` |
| 95 | + |
| 96 | +### 3. **By Topic:** |
| 97 | + |
| 98 | +Organize your notes by specific topics or modules within the course: |
| 99 | + |
| 100 | +```plaintext |
| 101 | +public/academiadrive/ |
| 102 | +├── LinearAlgebra/ |
| 103 | +├── DataStructures/ |
| 104 | +├── MachineLearning/ |
| 105 | +``` |
| 106 | + |
| 107 | +--- |
| 108 | + |
| 109 | + |
| 110 | + |
| 111 | +## **Technologies Used:** |
| 112 | + |
| 113 | +* **GitHub**: To host the repository and manage contributions. |
| 114 | +* **GitHub Pages**: To host the website and provide easy access to notes. |
| 115 | +* **HTML/CSS**: Basic styling and structure for the web interface. |
| 116 | +* **JavaScript (Optional)**: If you choose to add interactive features, you can use JavaScript. |
| 117 | + |
| 118 | +--- |
| 119 | + |
| 120 | +## **How to Access Notes:** |
| 121 | + |
| 122 | +1. Go to the **AcademiaDrive** website hosted on GitHub Pages. |
| 123 | +2. Browse through the folders organized by course, subject, or topic. |
| 124 | +3. Click to view or download the study materials (PDFs, slides, videos, etc.) that you need. |
| 125 | + |
| 126 | +--- |
| 127 | + |
| 128 | +## **Contributing Guidelines:** |
| 129 | + |
| 130 | +1. **Be Respectful**: This is a community-driven platform. Please contribute in a way that helps others and maintains a collaborative environment. |
| 131 | +2. **Stay Organized**: Keep your folder structure clean and easy to navigate so others can quickly find the materials they need. |
| 132 | +3. **Naming Conventions**: Please follow a simple naming convention for your notes so that they are easily identifiable. |
| 133 | + |
| 134 | +--- |
| 135 | + |
| 136 | +## **Need Help?** |
| 137 | + |
| 138 | +If you run into any issues or have questions, feel free to open an issue on the GitHub repository or reach out to the project maintainers. |
| 139 | + |
| 140 | +--- |
18 | 141 |
|
19 | | -You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file. |
| 142 | +### **Join the Community:** |
20 | 143 |
|
21 | | -This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel. |
| 144 | +By contributing your notes to **AcademiaDrive**, you're helping make academic resources more accessible to everyone in your university or college. Let’s work together to ensure that every student has access to the materials they need to succeed. |
22 | 145 |
|
23 | | -## Learn More |
| 146 | +--- |
24 | 147 |
|
25 | | -To learn more about Next.js, take a look at the following resources: |
| 148 | +### **License:** |
26 | 149 |
|
27 | | -- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API. |
28 | | -- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial. |
| 150 | +This project is licensed under the [MIT License](LICENSE). |
29 | 151 |
|
30 | | -You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome! |
| 152 | +--- |
31 | 153 |
|
32 | | -## Deploy on Vercel |
| 154 | +### **Conclusion:** |
33 | 155 |
|
34 | | -The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js. |
| 156 | +The goal of **AcademiaDrive** is to make it easy for students within your university or college to access and share study materials. Instead of relying on external services like Google Drive, **AcademiaDrive** takes it a step further by providing a **dedicated website** that anyone in your university can access and contribute to. |
35 | 157 |
|
36 | | -Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details. |
| 158 | +This solution is scalable and can be easily adapted to other universities or colleges facing similar challenges. |
0 commit comments