Skip to content

Commit

Permalink
NEW README
Browse files Browse the repository at this point in the history
  • Loading branch information
NDRAEY committed Oct 25, 2023
1 parent 78f5ca1 commit 7de127a
Show file tree
Hide file tree
Showing 128 changed files with 187 additions and 11,852 deletions.
5 changes: 5 additions & 0 deletions .idea/.gitignore

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

18 changes: 18 additions & 0 deletions .idea/misc.xml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

6 changes: 6 additions & 0 deletions .idea/vcs.xml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

158 changes: 158 additions & 0 deletions README_REALMD.MD
Original file line number Diff line number Diff line change
@@ -0,0 +1,158 @@
[Read English version](README_EN.MD)

# SayoriOS - открытое публичное ядро операционной системы

![C](https://img.shields.io/badge/c-%2300599C.svg?style=for-the-badge&logo=c&logoColor=white)
![Workflow](https://github.com/pimnik98/SayoriOS/actions/workflows/SayoriOS-AutoBot-Auto.yml/badge.svg)

Простая операционная система для компьютеров на архитектуре x86. Написана на языках Ассемблер, C и C++<br>

Для работы с ядром, также могут потребоваться инструменты <a href="https://github.com/pimnik98/SayoriSDK"><b>SayoriSDK</b></a>

# Примечание

Мы загружаем сюда код каждый релиз. То есть сюда попадают стабильные версии исходных кодов и образов.

# Скриншоты

![Загрузочный экран](https://raw.githubusercontent.com/NDRAEY/SayoriOS/screens/screens/v0.3.2/1.png)
![Консоль](https://raw.githubusercontent.com/NDRAEY/SayoriOS/screens/screens/v0.3.2/2.png)
![Графический интерфейс](https://raw.githubusercontent.com/NDRAEY/SayoriOS/screens/screens/v0.3.2/3.png)
![Приложение](https://raw.githubusercontent.com/NDRAEY/SayoriOS/screens/screens/v0.3.2/4.png)

# Примерный план действий

Прогресс:

[Ядро] Выполнено 4 из 7 (57%)

💫 [Драйвера] Выполнено 3 из 6 (50%)

📂 [Файлы] Выполнено 4 из 8 (50%)

🌐 [Сеть] Выполнено 0 из 1 (0%)

🔌 [Прочие] Выполнено 2 из 5 (40%)

![*](http://forum.glark.ru/smiles.lm?id=38) [Нажав сюда](https://raw.githubusercontent.com/pimnik98/SayoriOS/screens/screens/soul.png), вы увидите изображение, где отображены примерные планы на ядро.

# Системные требования:

Ядро не требует много ресурсов, но можно выделить и больше.

* Процессор: 1 ядро х 1 ГГц на архитектуре x86 с поддержкой SSE и SSE2
* ОЗУ: 64 МБ
* Жесткий диск: необязательно
* COM-порты: 2 порта (для отладки)
* Floppy-привод: необязательно
* Видеоадаптер: VGA-совместимый, 4 MB+

# Если вы хотите помочь проекту

Мы рады новым разработчикам и пользователям SayoriOS! Есть несколько способов, которыми вы можете внести свой вклад в проект:

## Если вы разработчик

Если вы разработчик, вы можете помочь, добавляя новые функции, устраняя ошибки или улучшая существующий код. Для этого вам нужно сделать следующее:

- Скачайте репозиторий проекта на свой локальный компьютер.
- Создайте новую ветку для вашей работы.
- Внесите изменения и фиксируйте их с использованием Git.
- Отправьте запрос на объединение (Pull Request) в основную ветку проекта.

Мы будем рады вашим вкладам и готовы рассмотреть ваши Pull Request'ы.

## Если вы тестировщик

Если вы нашли ошибку в проекте или у вас есть предложения по улучшению, пожалуйста, создайте новый Issue в репозитории проекта. Опишите проблему или предложение подробно, чтобы мы могли понять и рассмотреть их.

Еще одним способом помочь проекту является тестирование. Вы можете протестировать новые функции, исправления ошибок и сообщить о найденных проблемах.

*Спасибо за ваш интерес к SayoriOS и вашу готовность помочь в его развитии!*

# Сборка и запуск ОС

Для компиляции вам потребуется ОС Ubuntu или Debian.

Установить необходимый набор инструментов можно следующей командой:

```bash
sudo apt-get install git python3 clang-13 grub-pc-bin xorriso mtools make
```

А также надо установить набор инструментов для тестирования:

```bash
sudo apt-get install libvirt-daemon libvirt-clients bridge-utils virt-manager qemu-kvm qemu virt-manager
```

После установки необходимых утилит мы можем скачать исходники и собрать ОС:

1. Скачиваем репозиторий:
```bash
git clone https://github.com/pimnik98/SayoriOS.git
```
2. Переходим к папке
```bash
cd SayoriOS
```
3. Собираем ОС
```bash
make
```

4. Запуск
```bash
make bir
```
# Список команд для Make

`make` - Классическая сборка

`make run` - Обычный запуск в QEMU с выводом отладки в Qemu.log

`make runlive` - Обычный запуск в QEMU с выводом отладки в консоль

`make uefi` - Запуск эмулятора в UEFI режиме

`make geniso` - Классическая сборка ISO

`make genuefi` - Сборка ядра с UEFI

`make clean` - Удаляет ISO в папке

`make clean-objs` - Удаляет все скомпилированные файлы

`make link` - Сборка файлов ядра в единый файл

`make bir` - Сборка ISO и запуск ядра

# Список людей, которые поддерживают ядро

* [Никита Пиминов](https://github.com/pimnik98) (Создатель SayoriOS)
* [Андреян Павленко](https://github.com/NDRAEY)

# Ссылки

* [Группа SayoriOS в VK](https://vk.com/sayorios)
* [Канал и чат SayoriOS в Telegram](https://t.me/sayorios)

# Отказ от ответственности

SayoriOS это не дистрибутив Linux, это совершенно новый проект, который не имеет за собой компании или организации, которая могла бы дать гарантий.

Ядро SayoriOS имеет открытый исходный код, поэтому вы можете сами удостовериться в отсутствии вредоносного ПО, изучая файлы этого репозитория.

При использовании материалов вы обязуетесь соблюдать авторские права.

***Команда разработчиков SayoriOS*** не несёт ответственности за причиненный ущерб.
Запуск ядра возможен на реальном оборудовании, список поддерживаемых устройств и результаты тестирования вы можете посмотреть в нашей группе ВКонтакте (ссылка выше) или во вкладке Issues.

***Используйте на свой страх и риск.***


*Огромное спасибо тем, кто ставит звездочки нашему проекту <3*
![Stargazers](https://reporoster.com/stars/pimnik98/SayoriOS)

*А еще тем кто ПОДДЕРЖИВАЕТ этот проект!*
<img src="https://contrib.rocks/image?repo=pimnik98/SayoriOS"/>
19 changes: 0 additions & 19 deletions objects/kernel/src/compress/zlib/adler32.d

This file was deleted.

11 changes: 0 additions & 11 deletions objects/kernel/src/compress/zlib/compress.d

This file was deleted.

22 changes: 0 additions & 22 deletions objects/kernel/src/compress/zlib/crc32.d

This file was deleted.

22 changes: 0 additions & 22 deletions objects/kernel/src/compress/zlib/deflate.d

This file was deleted.

28 changes: 0 additions & 28 deletions objects/kernel/src/compress/zlib/inffast.d

This file was deleted.

31 changes: 0 additions & 31 deletions objects/kernel/src/compress/zlib/inflate.d

This file was deleted.

22 changes: 0 additions & 22 deletions objects/kernel/src/compress/zlib/inftrees.d

This file was deleted.

25 changes: 0 additions & 25 deletions objects/kernel/src/compress/zlib/trees.d

This file was deleted.

11 changes: 0 additions & 11 deletions objects/kernel/src/compress/zlib/uncompr.d

This file was deleted.

Loading

0 comments on commit 7de127a

Please sign in to comment.