|
| 1 | +<p align="right"> |
| 2 | + <a href="./README.md">简体中文</a> | <a href="./README.en.md">English</a> |
| 3 | +</p> |
| 4 | + |
| 5 | +# Involution Hell Knowledge Base |
| 6 | + |
| 7 | +## 📋 About |
| 8 | + |
| 9 | +[](https://zread.ai/InvolutionHell/involutionhell.github.io) |
| 10 | + |
| 11 | +This is a collaborative documentation platform based on modern web technologies, designed to help students share and access learning materials. |
| 12 | + |
| 13 | +## 🚀 Quick Start |
| 14 | + |
| 15 | +### Prerequisites |
| 16 | + |
| 17 | +- Node.js 18+ |
| 18 | +- pnpm (recommended) |
| 19 | + |
| 20 | +### ❗️If you are using `Windows` + `VSCode(Cursor)`, you may encounter a `Husky` bug. Please use the command line (`git commit`) to commit your code.❗️ |
| 21 | + |
| 22 | +### Installation |
| 23 | + |
| 24 | +```bash |
| 25 | +# Clone the repository |
| 26 | +git clone https://github.com/involutionhell/involutionhell.github.io.git |
| 27 | +cd involutionhell.github.io |
| 28 | + |
| 29 | +If you don't have pnpm installed yet, you can run: |
| 30 | +
|
| 31 | +# Install pnpm globally |
| 32 | +npm install -g pnpm |
| 33 | +
|
| 34 | +# Install dependencies |
| 35 | +pnpm install |
| 36 | +
|
| 37 | +# Start the development server |
| 38 | +pnpm dev |
| 39 | +``` |
| 40 | +
|
| 41 | +Open your browser and visit [http://localhost:3000](http://localhost:3000) to see the site. |
| 42 | +
|
| 43 | +## 📁 Project Structure |
| 44 | +
|
| 45 | +``` |
| 46 | +📦 involutionhell.github.io |
| 47 | +├── 📂 app/ # Next.js App Router |
| 48 | +│ ├── 📂 components/ # React components |
| 49 | +│ ├── 📂 docs/ # Document content |
| 50 | +│ │ └── 📂 ai/ # AI knowledge base |
| 51 | +│ ├── 📄 layout.tsx # Root layout |
| 52 | +│ └── 📄 page.tsx # Home page |
| 53 | +├── 📂 source.config.ts # Fumadocs configuration |
| 54 | +├── 📂 tailwind.config.ts # Tailwind CSS configuration |
| 55 | +└── 📄 package.json # Dependencies and scripts |
| 56 | +``` |
| 57 | +
|
| 58 | +## 🤝 Contributing |
| 59 | +
|
| 60 | +We welcome community contributions! Before you start, please read our [Contribution Guide](CONTRIBUTING.md). |
| 61 | +
|
| 62 | +### How to Contribute |
| 63 | +
|
| 64 | +- 📝 **Content**: Add new articles or improve existing ones |
| 65 | +- 🐛 **Bug Fixes**: Report and fix issues |
| 66 | +- 🎨 **UI/UX**: Improve design and user experience |
| 67 | +- 🌐 **Translation**: Help with multi-language support |
| 68 | +- 📖 **Documentation**: Improve project documentation |
| 69 | +
|
| 70 | +### Quick Start for Contributors |
| 71 | +
|
| 72 | +1. Fork this repository |
| 73 | +2. Create a feature branch: `git checkout -b feat/your-feature` |
| 74 | +3. Make your changes |
| 75 | +4. Test your changes: `pnpm check:content` |
| 76 | +5. Submit a PR |
| 77 | +
|
| 78 | +## 📚 Documentation Structure |
| 79 | +
|
| 80 | +Our content uses a hierarchical "Folder as a Book" structure: |
| 81 | +
|
| 82 | +``` |
| 83 | +📂 docs/ |
| 84 | +├── 📂 computer-science/ # Computer Science |
| 85 | +│ ├── 📄 index.mdx # Computer Science Overview |
| 86 | +│ └── 📂 data-structures/ # Data Structures |
| 87 | +│ ├── 📄 index.mdx # Data Structures Overview |
| 88 | +│ ├── 📂 array/ # Array |
| 89 | +│ │ ├── 📄 index.mdx # Array Overview |
| 90 | +│ │ ├── 📄 01-static-array.mdx |
| 91 | +│ │ └── 📄 02-dynamic-array.mdx |
| 92 | +│ └── 📂 linked-list/ # Linked List |
| 93 | +│ ├── 📄 index.mdx # Linked List Overview |
| 94 | +│ └── 📄 01-singly-linked-list.mdx |
| 95 | +``` |
| 96 | +
|
| 97 | +## 🛠️ Available Scripts |
| 98 | +
|
| 99 | +```bash |
| 100 | +# Development |
| 101 | +pnpm dev # Start the development server |
| 102 | +pnpm build # Build for production |
| 103 | +pnpm start # Start the production server |
| 104 | +pnpm postinstall |
| 105 | +pnpm lint:images # Check if images follow the rules |
| 106 | +pnpm migrate:images # Migrate images |
| 107 | +``` |
| 108 | +
|
| 109 | +## Image Management Guidelines (Brief) |
| 110 | +
|
| 111 | +An automated script will move the images you reference to the same directory as the MDX file, following these rules: |
| 112 | +
|
| 113 | +- **Storage**: In `./<basename>.assets/` in the same directory as the MDX file. |
| 114 | + - Example: `foo.mdx` → `./foo.assets/<img>.png`; `index.mdx` → `./index.assets/<img>.png`. |
| 115 | +- **Reference**: Relative path ``. |
| 116 | +- **Automation**: Automatically migrates and changes references on commit; Image Lint only warns and does not block commits. |
| 117 | +- **Sharing**: Use `/images/site/*` for site-level images, `/images/components/<name>/*` for component demos; images shared by multiple documents can be kept in `/images/...`. |
| 118 | +
|
| 119 | +## Special Thanks |
| 120 | +
|
| 121 | +### Thanks to Shanghai AI Lab for providing computing power support for this project! |
| 122 | +
|
| 123 | + |
| 124 | +
|
| 125 | +- [InternS1 Project Address](https://github.com/InternLM/Intern-S1/tree/main) |
| 126 | +- [InternStudio Computing Power Platform](https://studio.intern-ai.org.cn/console/dashboard) |
| 127 | +- [Puyu API Documentation](https://internlm.intern-ai.org.cn/api/document) |
| 128 | +
|
| 129 | +## Star History |
| 130 | +
|
| 131 | +[](https://star-history.com/#InvolutionHell/involutionhell.github.io&Date) |
| 132 | +
|
| 133 | +## License and Copyright Notice |
| 134 | +
|
| 135 | +### About the Project Code |
| 136 | +
|
| 137 | +The **code** part of this project (referring to the program code used to build and run this website) is licensed under the MIT License. |
| 138 | +
|
| 139 | +This means you are free to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the code, but you must include the original copyright notice and license statement in all copies or substantial portions of the software. |
| 140 | +
|
| 141 | +For details, see the [LICENSE](LICENSE) file. |
| 142 | +
|
| 143 | +### About Shared Content |
| 144 | +
|
| 145 | +The copyright of **articles, comments, and other forms of content** displayed/collected on this platform belongs to the original authors. |
| 146 | +
|
| 147 | +**Please note**: |
| 148 | +1. The copyright of the content does **not** follow the MIT license and is still retained by the original author. |
| 149 | +2. Unless otherwise stated or authorized by the original author, **no one may** use this content for commercial purposes, such as reprinting, modification, and other secondary creations. |
| 150 | +3. As a sharing platform, this project cannot verify the originality and legality of all content one by one. |
| 151 | +
|
| 152 | +#### Copyright Infringement Handling |
| 153 | +
|
| 154 | +We respect and are committed to protecting intellectual property. If you believe that any content on the platform infringes your legal rights, please contact us immediately by **[submitting an Issue](https://github.com/InvolutionHell/involutionhell.github.io/issues/new)**. We promise to take necessary measures such as deletion and blocking promptly after receiving the notification and verifying the situation. |
0 commit comments