diff --git a/README.en.md b/README.en.md new file mode 100644 index 0000000..4e87516 --- /dev/null +++ b/README.en.md @@ -0,0 +1,154 @@ +
+ +# Involution Hell Knowledge Base + +## 📋 About + +[](https://zread.ai/InvolutionHell/involutionhell.github.io) + +This is a collaborative documentation platform based on modern web technologies, designed to help students share and access learning materials. + +## 🚀 Quick Start + +### Prerequisites + +- Node.js 18+ +- pnpm (recommended) + +### ❗️If you are using `Windows` + `VSCode(Cursor)`, you may encounter a `Husky` bug. Please use the command line (`git commit`) to commit your code.❗️ + +### Installation + +```bash +# Clone the repository +git clone https://github.com/involutionhell/involutionhell.github.io.git +cd involutionhell.github.io + +If you don't have pnpm installed yet, you can run: + +# Install pnpm globally +npm install -g pnpm + +# Install dependencies +pnpm install + +# Start the development server +pnpm dev +``` + +Open your browser and visit [http://localhost:3000](http://localhost:3000) to see the site. + +## 📁 Project Structure + +``` +📦 involutionhell.github.io +├── 📂 app/ # Next.js App Router +│ ├── 📂 components/ # React components +│ ├── 📂 docs/ # Document content +│ │ └── 📂 ai/ # AI knowledge base +│ ├── 📄 layout.tsx # Root layout +│ └── 📄 page.tsx # Home page +├── 📂 source.config.ts # Fumadocs configuration +├── 📂 tailwind.config.ts # Tailwind CSS configuration +└── 📄 package.json # Dependencies and scripts +``` + +## 🤝 Contributing + +We welcome community contributions! Before you start, please read our [Contribution Guide](CONTRIBUTING.md). + +### How to Contribute + +- 📝 **Content**: Add new articles or improve existing ones +- 🐛 **Bug Fixes**: Report and fix issues +- 🎨 **UI/UX**: Improve design and user experience +- 🌐 **Translation**: Help with multi-language support +- 📖 **Documentation**: Improve project documentation + +### Quick Start for Contributors + +1. Fork this repository +2. Create a feature branch: `git checkout -b feat/your-feature` +3. Make your changes +4. Test your changes: `pnpm check:content` +5. Submit a PR + +## 📚 Documentation Structure + +Our content uses a hierarchical "Folder as a Book" structure: + +``` +📂 docs/ +├── 📂 computer-science/ # Computer Science +│ ├── 📄 index.mdx # Computer Science Overview +│ └── 📂 data-structures/ # Data Structures +│ ├── 📄 index.mdx # Data Structures Overview +│ ├── 📂 array/ # Array +│ │ ├── 📄 index.mdx # Array Overview +│ │ ├── 📄 01-static-array.mdx +│ │ └── 📄 02-dynamic-array.mdx +│ └── 📂 linked-list/ # Linked List +│ ├── 📄 index.mdx # Linked List Overview +│ └── 📄 01-singly-linked-list.mdx +``` + +## 🛠️ Available Scripts + +```bash +# Development +pnpm dev # Start the development server +pnpm build # Build for production +pnpm start # Start the production server +pnpm postinstall +pnpm lint:images # Check if images follow the rules +pnpm migrate:images # Migrate images +``` + +## Image Management Guidelines (Brief) + +An automated script will move the images you reference to the same directory as the MDX file, following these rules: + +- **Storage**: In `./