Skip to content

Commit cdbd459

Browse files
AnmiTaliDevAnmiTaliDev
committed
Ну хз, большая переработка
1 parent 05f89ba commit cdbd459

47 files changed

Lines changed: 8557 additions & 1672 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎README.md‎

Lines changed: 122 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,122 @@
1+
# NurOS Documentation
2+
3+
[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
4+
[![Language](https://img.shields.io/badge/Languages-en%20%7C%20ru%20%7C%20kk-brightgreen.svg)](#translations)
5+
6+
Official documentation for NurOS Linux distribution.
7+
8+
## 🌐 Translations
9+
10+
- **English** (current file)
11+
- [Русский (Russian)](README_ru.md)
12+
- [Қазақша (Kazakh)](README_kk.md)
13+
14+
## 📖 About
15+
16+
This repository contains comprehensive documentation for NurOS, an independent Linux distribution. The documentation covers all major components of the system:
17+
18+
- **APG Package System** - Advanced Package format and ecosystem
19+
- **Tulpar** - Package manager and libapg library
20+
- **Tulpar Server** - Package repository server
21+
- **AetherDE** - Desktop environment
22+
- **System Utilities** - Essential tools like switch
23+
- **Installation Guides** - System installation and porting
24+
25+
## 🚀 Quick Start
26+
27+
### Prerequisites
28+
29+
- Node.js >= 18.0
30+
- npm or yarn
31+
32+
### Installation
33+
34+
```bash
35+
# Clone the repository
36+
git clone https://github.com/NurOS-Linux/docs.git
37+
cd docs
38+
39+
# Install dependencies
40+
npm install
41+
42+
# Start development server
43+
npm start
44+
```
45+
46+
The documentation site will open at `http://localhost:3000`.
47+
48+
### Building
49+
50+
```bash
51+
# Build static site
52+
npm run build
53+
54+
# Serve built site
55+
npm run serve
56+
```
57+
58+
## 📁 Project Structure
59+
60+
```
61+
docs/
62+
├── docs/ # Documentation files
63+
│ ├── apg/ # APG package system
64+
│ ├── aether/ # AetherDE desktop environment
65+
│ ├── utils/ # System utilities
66+
│ └── installing/# Installation guides
67+
├── blog/ # Blog posts
68+
├── src/ # Custom components
69+
└── static/ # Static assets
70+
```
71+
72+
## 🛠️ Technology Stack
73+
74+
- **Framework**: [Docusaurus](https://docusaurus.io/) 3.x
75+
- **Language**: JavaScript, Markdown
76+
- **Deployment**: GitHub Pages / Vercel
77+
78+
## 📝 Contributing
79+
80+
We welcome contributions! To contribute:
81+
82+
1. Fork the repository
83+
2. Create a feature branch (`git checkout -b feature/improvement`)
84+
3. Make your changes
85+
4. Commit with descriptive messages (`git commit -m 'Add: feature description'`)
86+
5. Push to your fork (`git push origin feature/improvement`)
87+
6. Open a Pull Request
88+
89+
### Writing Guidelines
90+
91+
- Use clear, concise language
92+
- Follow the existing structure
93+
- Test local build before submitting
94+
- Include code examples where appropriate
95+
96+
## 📄 License
97+
98+
- **Documentation Content**: Licensed under [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/)
99+
- **Code Examples**: Licensed under [MIT License](LICENSE)
100+
- **NurOS Components**: Various licenses (see individual projects)
101+
102+
## 🔗 Links
103+
104+
- **NurOS Website**: https://nuros.org
105+
- **GitHub Organization**: https://github.com/NurOS-Linux
106+
- **Issue Tracker**: https://github.com/NurOS-Linux/docs/issues
107+
- **Discussions**: https://github.com/NurOS-Linux/docs/discussions
108+
109+
## 👥 Community
110+
111+
- **Discord**: [Join our server](https://discord.gg/nuros)
112+
- **Telegram**: [@nuros_linux](https://t.me/nuros_linux)
113+
- **Matrix**: #nuros:matrix.org
114+
115+
## 📮 Contact
116+
117+
- **Email**: contact@nuros.org
118+
- **GitHub Issues**: For documentation bugs and improvements
119+
120+
---
121+
122+
Copyright © 2025 NurOS Project

‎README_kk.md‎

Lines changed: 122 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,122 @@
1+
# NurOS Құжаттамасы
2+
3+
[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
4+
[![Language](https://img.shields.io/badge/Languages-en%20%7C%20ru%20%7C%20kk-brightgreen.svg)](#аудармалар)
5+
6+
NurOS Linux дистрибутивінің ресми құжаттамасы.
7+
8+
## 🌐 Аудармалар
9+
10+
- [English (Ағылшын)](README.md)
11+
- [Русский (Орыс)](README_ru.md)
12+
- **Қазақша** (ағымдағы файл)
13+
14+
## 📖 Жоба туралы
15+
16+
Бұл репозиторий NurOS — тәуелсіз Linux дистрибутиві бойынша толық құжаттаманы қамтиды. Құжаттама жүйенің барлық негізгі компоненттерін қамтиды:
17+
18+
- **APG пакет жүйесі** - Advanced Package форматы мен экожүйесі
19+
- **Tulpar** - Пакет менеджері және libapg кітапханасы
20+
- **Tulpar Server** - Пакеттер репозиторийінің сервері
21+
- **AetherDE** - Жұмыс үстелінің ортасы
22+
- **Жүйелік утилиталар** - Switch сияқты маңызды құралдар
23+
- **Орнату нұсқаулары** - Жүйені орнату және порттау
24+
25+
## 🚀 Жылдам бастау
26+
27+
### Талаптар
28+
29+
- Node.js >= 18.0
30+
- npm немесе yarn
31+
32+
### Орнату
33+
34+
```bash
35+
# Репозиторийді клондау
36+
git clone https://github.com/NurOS-Linux/docs.git
37+
cd docs
38+
39+
# Тәуелділіктерді орнату
40+
npm install
41+
42+
# Әзірлеу серверін іске қосу
43+
npm start
44+
```
45+
46+
Құжаттама сайты `http://localhost:3000` мекенжайында ашылады.
47+
48+
### Құрастыру
49+
50+
```bash
51+
# Статикалық сайтты құрастыру
52+
npm run build
53+
54+
# Құрастырылған сайтты іске қосу
55+
npm run serve
56+
```
57+
58+
## 📁 Жоба құрылымы
59+
60+
```
61+
docs/
62+
├── docs/ # Құжаттама файлдары
63+
│ ├── apg/ # APG пакет жүйесі
64+
│ ├── aether/ # AetherDE жұмыс үстелі ортасы
65+
│ ├── utils/ # Жүйелік утилиталар
66+
│ └── installing/# Орнату нұсқаулары
67+
├── blog/ # Блог жазбалары
68+
├── src/ # Пайдаланушы компоненттері
69+
└── static/ # Статикалық ресурстар
70+
```
71+
72+
## 🛠️ Технологиялар стегі
73+
74+
- **Фреймворк**: [Docusaurus](https://docusaurus.io/) 3.x
75+
- **Тілдер**: JavaScript, Markdown
76+
- **Орналастыру**: GitHub Pages / Vercel
77+
78+
## 📝 Үлес қосу
79+
80+
Біз сіздің үлесіңізді қош қараймыз! Өзгертулер енгізу үшін:
81+
82+
1. Репозиторийдің форкін жасаңыз
83+
2. Жаңа функция үшін тармақ жасаңыз (`git checkout -b feature/improvement`)
84+
3. Өзгертулер енгізіңіз
85+
4. Сипаттамалы хабарламамен commit жасаңыз (`git commit -m 'Қосылды: функция сипаттамасы'`)
86+
5. Өз форкіңізге жіберіңіз (`git push origin feature/improvement`)
87+
6. Pull Request ашыңыз
88+
89+
### Жазу бойынша ұсыныстар
90+
91+
- Анық және қысқа тіл қолданыңыз
92+
- Бар құрылымды ұстаныңыз
93+
- Жіберу алдында жергілікті құрастыруды тексеріңіз
94+
- Қажет жерде код мысалдарын қосыңыз
95+
96+
## 📄 Лицензия
97+
98+
- **Құжаттама мазмұны**: [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/) лицензиясымен
99+
- **Код мысалдары**: [MIT License](LICENSE) лицензиясымен
100+
- **NurOS компоненттері**: Әртүрлі лицензиялар (жеке жобаларды қараңыз)
101+
102+
## 🔗 Сілтемелер
103+
104+
- **NurOS веб-сайты**: https://nuros.org
105+
- **GitHub ұйымы**: https://github.com/NurOS-Linux
106+
- **Тапсырма трекері**: https://github.com/NurOS-Linux/docs/issues
107+
- **Талқылаулар**: https://github.com/NurOS-Linux/docs/discussions
108+
109+
## 👥 Қоғамдастық
110+
111+
- **Discord**: [Серверге қосылу](https://discord.gg/nuros)
112+
- **Telegram**: [@nuros_linux](https://t.me/nuros_linux)
113+
- **Matrix**: #nuros:matrix.org
114+
115+
## 📮 Байланыс
116+
117+
- **Email**: contact@nuros.org
118+
- **GitHub Issues**: Құжаттамадағы қателер мен жақсартулар үшін
119+
120+
---
121+
122+
Copyright © 2025 NurOS жобасы

‎README_ru.md‎

Lines changed: 122 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,122 @@
1+
# Документация NurOS
2+
3+
[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
4+
[![Language](https://img.shields.io/badge/Languages-en%20%7C%20ru%20%7C%20kk-brightgreen.svg)](#переводы)
5+
6+
Официальная документация для дистрибутива Linux NurOS.
7+
8+
## 🌐 Переводы
9+
10+
- [English (Английский)](README.md)
11+
- **Русский** (текущий файл)
12+
- [Қазақша (Казахский)](README_kk.md)
13+
14+
## 📖 О проекте
15+
16+
Этот репозиторий содержит исчерпывающую документацию по NurOS — независимому дистрибутиву Linux. Документация охватывает все основные компоненты системы:
17+
18+
- **Система пакетов APG** - Формат Advanced Package и экосистема
19+
- **Tulpar** - Пакетный менеджер и библиотека libapg
20+
- **Tulpar Server** - Сервер репозитория пакетов
21+
- **AetherDE** - Окружение рабочего стола
22+
- **Системные утилиты** - Важные инструменты, такие как switch
23+
- **Руководства по установке** - Установка системы и портирование
24+
25+
## 🚀 Быстрый старт
26+
27+
### Требования
28+
29+
- Node.js >= 18.0
30+
- npm или yarn
31+
32+
### Установка
33+
34+
```bash
35+
# Клонировать репозиторий
36+
git clone https://github.com/NurOS-Linux/docs.git
37+
cd docs
38+
39+
# Установить зависимости
40+
npm install
41+
42+
# Запустить сервер разработки
43+
npm start
44+
```
45+
46+
Сайт документации откроется по адресу `http://localhost:3000`.
47+
48+
### Сборка
49+
50+
```bash
51+
# Собрать статический сайт
52+
npm run build
53+
54+
# Запустить собранный сайт
55+
npm run serve
56+
```
57+
58+
## 📁 Структура проекта
59+
60+
```
61+
docs/
62+
├── docs/ # Файлы документации
63+
│ ├── apg/ # Система пакетов APG
64+
│ ├── aether/ # Окружение рабочего стола AetherDE
65+
│ ├── utils/ # Системные утилиты
66+
│ └── installing/# Руководства по установке
67+
├── blog/ # Блог-посты
68+
├── src/ # Пользовательские компоненты
69+
└── static/ # Статические ресурсы
70+
```
71+
72+
## 🛠️ Стек технологий
73+
74+
- **Фреймворк**: [Docusaurus](https://docusaurus.io/) 3.x
75+
- **Языки**: JavaScript, Markdown
76+
- **Развертывание**: GitHub Pages / Vercel
77+
78+
## 📝 Участие в разработке
79+
80+
Мы приветствуем ваш вклад! Чтобы внести изменения:
81+
82+
1. Создайте форк репозитория
83+
2. Создайте ветку для новой функции (`git checkout -b feature/improvement`)
84+
3. Внесите изменения
85+
4. Сделайте коммит с описательным сообщением (`git commit -m 'Добавлено: описание функции'`)
86+
5. Отправьте в свой форк (`git push origin feature/improvement`)
87+
6. Откройте Pull Request
88+
89+
### Рекомендации по написанию
90+
91+
- Используйте ясный и лаконичный язык
92+
- Следуйте существующей структуре
93+
- Тестируйте локальную сборку перед отправкой
94+
- Включайте примеры кода там, где это уместно
95+
96+
## 📄 Лицензия
97+
98+
- **Содержимое документации**: Лицензировано под [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/)
99+
- **Примеры кода**: Лицензировано под [MIT License](LICENSE)
100+
- **Компоненты NurOS**: Различные лицензии (см. отдельные проекты)
101+
102+
## 🔗 Ссылки
103+
104+
- **Веб-сайт NurOS**: https://nuros.org
105+
- **GitHub организация**: https://github.com/NurOS-Linux
106+
- **Трекер задач**: https://github.com/NurOS-Linux/docs/issues
107+
- **Обсуждения**: https://github.com/NurOS-Linux/docs/discussions
108+
109+
## 👥 Сообщество
110+
111+
- **Discord**: [Присоединиться к серверу](https://discord.gg/nuros)
112+
- **Telegram**: [@nuros_linux](https://t.me/nuros_linux)
113+
- **Matrix**: #nuros:matrix.org
114+
115+
## 📮 Контакты
116+
117+
- **Email**: contact@nuros.org
118+
- **GitHub Issues**: Для сообщений об ошибках и улучшений документации
119+
120+
---
121+
122+
Copyright © 2025 Проект NurOS

0 commit comments

Comments
 (0)