mirror of
https://github.com/Snigdha-OS/snigdhaos-devdocs.git
synced 2025-09-06 22:45:12 +02:00
📝 docs: add brief decription
This commit is contained in:
eshanized
198
README.md
198
README.md
@@ -1,77 +1,173 @@
|
||||
# 🌐 Website
|
||||
# Snigdha OS Developer Documentation
|
||||
|
||||
This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
|
||||
[](LICENSE)
|
||||
[](https://github.com/Snigdha-OS/snigdhaos-devdocs/actions)
|
||||
[](https://snigdha-os.github.io/snigdhaos-devdocs/)
|
||||
|
||||
Welcome to the **Snigdha OS Developer Documentation** repository! This repository houses the official developer documentation for **Snigdha OS**, a highly customizable, Arch-based Linux distribution designed for developers, penetration testers, and general users.
|
||||
|
||||
|
||||
|
||||
### 📦 Installation
|
||||
## 📚 About
|
||||
|
||||
To get started, install the necessary dependencies using `pnpm` and clone the repository:
|
||||
Snigdha OS Developer Documentation serves as a comprehensive guide for developers working on or with Snigdha OS. It includes detailed instructions, examples, and best practices to help users make the most of the OS and contribute to its ecosystem.
|
||||
|
||||
```
|
||||
git clone https://github.com/Snigdha-OS/DevContrib.git
|
||||
cd DevContrib
|
||||
pnpm install
|
||||
```
|
||||
|
||||
|
||||
### 🚀 Local Development
|
||||
|
||||
To start a local development server, run the following command:
|
||||
|
||||
```
|
||||
pnpm start
|
||||
```
|
||||
|
||||
This command starts a local server and opens a browser window. Most changes are reflected live without the need to restart the server. 👨💻
|
||||
### Features:
|
||||
- Detailed setup and configuration guides
|
||||
- API references
|
||||
- Contributing guidelines
|
||||
- Localization support for multiple Indian languages
|
||||
- Regularly updated content
|
||||
|
||||
|
||||
|
||||
### 🛠️ Build
|
||||
## 🚀 Quick Start
|
||||
|
||||
To generate static content and prepare for deployment, use the following command:
|
||||
To view the documentation:
|
||||
|
||||
```
|
||||
pnpm build
|
||||
```
|
||||
|
||||
This will generate static content into the `build` directory, which can be served using any static hosting service. 🌍
|
||||
1. Visit the [Snigdha OS Developer Docs](https://snigdha-os.github.io/snigdhaos-devdocs/).
|
||||
2. Use the language switcher in the navbar to explore content in various supported languages.
|
||||
3. Follow the detailed instructions to set up and customize Snigdha OS.
|
||||
|
||||
|
||||
|
||||
### 🚢 Deployment
|
||||
## 🛠️ Installation and Development
|
||||
|
||||
#### Using SSH:
|
||||
To run the documentation locally:
|
||||
|
||||
If you are using SSH to deploy, run:
|
||||
|
||||
```
|
||||
USE_SSH=true pnpm deploy
|
||||
```
|
||||
|
||||
#### Without SSH:
|
||||
|
||||
If you're not using SSH, you can deploy by specifying your GitHub username:
|
||||
|
||||
```
|
||||
GIT_USER=<Your GitHub username> pnpm deploy
|
||||
```
|
||||
|
||||
If you are using **GitHub Pages** for hosting, this command is a convenient way to build the website and push it to the `gh-pages` branch. 📦💻
|
||||
1. Clone this repository:
|
||||
```bash
|
||||
git clone https://github.com/Snigdha-OS/snigdhaos-devdocs.git
|
||||
```
|
||||
2. Navigate to the project directory:
|
||||
```bash
|
||||
cd snigdhaos-devdocs
|
||||
```
|
||||
3. Install dependencies:
|
||||
```bash
|
||||
npm install
|
||||
```
|
||||
4. Start the development server:
|
||||
```bash
|
||||
npm start
|
||||
```
|
||||
5. Open your browser and navigate to `http://localhost:3000`.
|
||||
|
||||
|
||||
|
||||
### 👨💻 Developer
|
||||
## 🌐 Supported Languages
|
||||
|
||||
This project is developed and maintained by **d3v1l0n**. 🧑💻
|
||||
Snigdha OS Developer Documentation is available in multiple Indian languages, including:
|
||||
|
||||
- English (`en`)
|
||||
- Hindi (`hi`)
|
||||
- Bengali (`bn`)
|
||||
- Telugu (`te`)
|
||||
- Marathi (`mr`)
|
||||
- Tamil (`ta`)
|
||||
- Urdu (`ur`)
|
||||
- Gujarati (`gu`)
|
||||
- Kannada (`kn`)
|
||||
- Malayalam (`ml`)
|
||||
- Odia (`or`)
|
||||
- Punjabi (`pa`)
|
||||
- Assamese (`as`)
|
||||
- Nepali (`ne`)
|
||||
- Sinhala (`si`)
|
||||
- Kashmiri (`ks`)
|
||||
- Sanskrit (`sa`)
|
||||
- Tibetan (`bo`)
|
||||
|
||||
|
||||
|
||||
🔧 **Technologies Used:**
|
||||
- Docusaurus
|
||||
- pnpm
|
||||
- GitHub Pages
|
||||
## 🌏 How to Translate
|
||||
|
||||
### Adding or Updating Translations
|
||||
|
||||
1. Navigate to the `i18n` directory in the project.
|
||||
Each language has its own folder named after the language code (e.g., `hi` for Hindi, `bn` for Bengali).
|
||||
|
||||
2. Translate or edit the JSON files inside the corresponding folder.
|
||||
For example:
|
||||
- `i18n/hi/docusaurus-plugin-content-docs/current/<doc>.json` contains translations for Hindi.
|
||||
- Each JSON file corresponds to a specific documentation page.
|
||||
|
||||
3. Add your translations for the required fields. For example:
|
||||
```json
|
||||
{
|
||||
"title": "शीर्षक",
|
||||
"description": "यह एक हिंदी दस्तावेज़ है।"
|
||||
}
|
||||
```
|
||||
|
||||
4. Test your translations by running the project locally:
|
||||
```bash
|
||||
npm start
|
||||
```
|
||||
|
||||
5. Commit and push your changes:
|
||||
```bash
|
||||
git add .
|
||||
git commit -m "Add/Update translations for <language>"
|
||||
git push origin <branch-name>
|
||||
```
|
||||
|
||||
6. Open a pull request to merge your changes into the main branch.
|
||||
|
||||
|
||||
|
||||
Happy coding! 🎉
|
||||
## 🖼️ Project Structure
|
||||
|
||||
- `/docs`: Main documentation content in markdown files.
|
||||
- `/i18n`: Translations for different languages.
|
||||
- `/src`: Custom CSS and theme-related modifications.
|
||||
- `docusaurus.config.js`: Main configuration file for the Docusaurus framework.
|
||||
|
||||
|
||||
|
||||
## 🤝 Contributing
|
||||
|
||||
We welcome contributions to improve the Snigdha OS Developer Documentation!
|
||||
|
||||
### How to Contribute:
|
||||
1. Fork this repository.
|
||||
2. Create a new branch for your feature, bug fix, or translation:
|
||||
```bash
|
||||
git checkout -b feature-name
|
||||
```
|
||||
3. Make your changes and test them locally.
|
||||
4. Commit your changes:
|
||||
```bash
|
||||
git commit -m "Add feature or fix description"
|
||||
```
|
||||
5. Push your changes:
|
||||
```bash
|
||||
git push origin feature-name
|
||||
```
|
||||
6. Create a pull request on GitHub.
|
||||
|
||||
|
||||
|
||||
## 📄 License
|
||||
|
||||
This project is licensed under the **MIT License**. See the [LICENSE](LICENSE) file for more details.
|
||||
|
||||
|
||||
|
||||
## 📞 Support
|
||||
|
||||
For questions, suggestions, or bug reports, please open an issue on the [GitHub Issues](https://github.com/Snigdha-OS/snigdhaos-devdocs/issues) page.
|
||||
|
||||
|
||||
|
||||
## 🛡️ Acknowledgements
|
||||
|
||||
Snigdha OS Developer Documentation is powered by:
|
||||
- [Docusaurus](https://docusaurus.io/) for creating modern documentation websites.
|
||||
- [Prism React Renderer](https://prism-react-renderer.netlify.app/) for syntax highlighting.
|
||||
|
||||
Special thanks to the **Snigdha OS Community** and contributors for making this documentation project possible.
|
||||
|
||||
|
||||
|
||||
Enjoy your experience with **Snigdha OS**! 🌟
|
||||
Reference in New Issue
Block a user