From c124606945c59dc6a9b70035fef545a0892b612d Mon Sep 17 00:00:00 2001 From: Sebaguardian <68247013+Sebaguardian@users.noreply.github.com> Date: Sun, 28 Jul 2024 17:20:17 +0200 Subject: [PATCH] MERGE Translate README to Polish (#22) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit :poland: Polskie tłumaczenie README :poland: --------- Signed-off-by: Sebaguardian <68247013+Sebaguardian@users.noreply.github.com> Co-authored-by: Adam Perkowski --- README-pl.md | 132 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 132 insertions(+) create mode 100644 README-pl.md diff --git a/README-pl.md b/README-pl.md new file mode 100644 index 0000000..365bb54 --- /dev/null +++ b/README-pl.md @@ -0,0 +1,132 @@ +# HighlightOS + + + +x86_64 System Operacyjny (kernel) zrobiony od zera w Assembly & Rust + +[![README in English](https://img.shields.io/badge/Lang-%F0%9F%87%AC%F0%9F%87%A7-blue?color=%23ffcc4d&labelColor=%23000000)](https://github.com/adamperkowski/highlightos/blob/main/README.md) +[![README in Polish](https://img.shields.io/badge/Lang-%F0%9F%87%B5%F0%9F%87%B1-blue?color=%23ffcc4d&labelColor=%23000000)](https://github.com/adamperkowski/highlightos/blob/main/README-pl.md) + +[![GitHub Release](https://img.shields.io/github/v/release/adamperkowski/highlightos?label=Latest%20Released%20Version&color=%23ffcc4d&labelColor=%23000000)](https://github.com/adamperkowski/highlightos/releases) +[![GitHub License](https://img.shields.io/github/license/adamperkowski/highlightos?label=License&color=%23ffcc4d&labelColor=%23000000)](https://github.com/adamperkowski/highlightos/blob/main/LICENSE) ![GitHub repo size](https://img.shields.io/github/repo-size/adamperkowski/highlightos?label=Repo%20Size&color=%23ffcc4d&labelColor=%23000000) +[![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/adamperkowski/highlightos/asm.yml?branch=main&label=ASM%20Build&color=%23ffcc4d&labelColor=%23000000)](https://github.com/adamperkowski/highlightos/actions) [![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/adamperkowski/highlightos/rust.yml?branch=main&label=HLShell%20Build&color=%23ffcc4d&labelColor=%23000000)](https://github.com/adamperkowski/highlightos/actions) + +## Spis treści +- [Budowa ze źródła na Linuxie](#budowa-ze-źródła-na-linuxie) +- [Uruchamianie w QEMU na Linuxie](#uruchamianie-w-qemu-na-linuxie) +- [Uruchamianie na prawdziwym sprzęcie](#uruchamianie-na-prawdziwym-sprzęcie) +- [Załączniki](#załączniki) + - [Status rozwoju](#status-rozwoju) + - [Dodatkowe informacje](#dodatkowe-informacje) + - [Przypisy](#przypisy) + + + + + + +## Budowa ze źródła na Linuxie +### HLShell (główny kernel) +**Wymagania:** + - System kontroli wersji[Git] (https://git-scm.com) + - [Rust toolchain](https://www.rust-lang.org/tools/install) + +**Kroki:** + 1. Zainstaluj toolchain nightly: +```bash +rustup toolchain install nightly +``` + 3. Zainstaluj potrzebne komponenty: +```bash +rustup component add rust-src --toolchain nightly-x86_64-unknown-linux-gnu && rustup component add llvm-tools-preview --toolchain nightly-x86_64-unknown-linux-gnu && cargo install bootimage +``` + 4. Stwórz lokalną kopię repozytorium: +```bash +git clone git@github.com:adamperkowski/highlightos.git && cd highlightos +``` + 5. Użyj `cd` do folderu `shell/` : +```bash +cd shell +``` + 7. Zbuduj bootowalny plik binarny : +```bash +cargo +nightly bootimage --release +``` +> Ta komenda stworzy folder `target/target/release` w którym znajdziesz `bootimage-hlshell.bin`, czyli plik binarny. + +### HighlightOS ASM +**Wymagania:** + - System kontroli wersji [Git](https://git-scm.com) + - Kompilator Assembly [NASM](https://nasm.us) + +**Kroki:** + 1. Stwórz lokalną kopię repozytorium: +```bash +git clone git@github.com:adamperkowski/highlightos.git && cd highlightos +``` + 2. Użyj `cd` do folderu `asm/` : +```bash +cd asm +``` + 3. Skompiluj plik binarny: +```bash +nasm -f bin boot.asm -o boot.bin +``` +> Ta komenda stworzy plik `boot.bin` i umieści go w twoim aktualnym folderze. + +## Uruchamianie w QEMU na Linuxie + +**Wymagania:** + - [QEMU](https://www.qemu.org/download/#linux) (cały pakiet) + - Bootwalny plik binarny HighlightOS. Możesz takowy pobrać z [wydań](https://github.com/adamperkowski/highlightos/releases), albo [zbudować własny](#Budowa-z-źródła-na-Linuxie). + +**Kroki:** + 1. Użyj `cd` do folderu z plikiem binarnym. + 2. Użyj następującej komendy: +```bash +qemu-system-x86_64 -drive format=raw,file=.bin +``` +> [!IMPORTANT] +> Upewnij się że zamieniłeś `` na właściwą nazwę pliku który pobrałeś/zbudowałeś. + +## Uruchamianie na prawdziwym sprzęcie +Możesz również sflaszować plik binarny do swojego USB pedrive'a i uruchomić go na prawdziwej maszynie + +Żeby to zrobić wykorzystaj następującą komende: +```bash +dd if=.bin of=/dev/sdX && sync +``` + +> [!IMPORTANT] +> Upewnij się że zamieniłeś `` na właściwą nazwę pliku który pobrałeś/zbudowałeś i upewnij się żeby zamienić `/dev/sdX` na numerem partycji z twojego USB. **Wszelkie dane zostaną starocone!** + +> [!NOTE] +>Możesz wybrać urządzenie bootujące z poziomu BIOS boot menu (dostępne poprzez klikanie F8 lub F12). +> +>**Sprawdź czy twoja płyta główna obsługuję bootowanie z starszych (legacy) nośników, gdyż HighlightOS nie jest jeszcze kompatybilny z UEFI.** + + +## Załączniki + +### Status rozwoju +https://github.com/user-attachments/assets/de796522-3d6b-4672-a335-ff282422fe86 + +### Dodatkowe informacje +Lista wbudowanych komend i funkcji jest dostępna [tutaj](https://github.com/adamperkowski/highlightos/wiki/Commands#built-in-commands). + +Po więcej informacji na temat HighlightOS, zapraszamy na nasze [wiki](https://github.com/adamperkowski/highlightos/wiki/). + +**_Używanie prekompilowanych plików binarnych z sekcji kodu tego repo nie jest zalecane._** + +### Współtwórcy +**WIELKIE podziękowania każdemu współtwórcy:** + + + + + +### Przypisy +*Niektóre części kodu były inspirowane [blog_os](https://github.com/phil-opp/blog_os). Świetny projekt!* + +*Polskie tłumaczenie: [Sebaguardian](https://github.com/Sebaguardian)*
+*Copyleft 2024 Adam Perkowski*