README in Russian
This commit is contained in:
paravis committed
1 parent
cd02c606e6
commit
eb63c71b94
1 file changed
+54
-54
@@ -1,92 +1,92 @@
|
||||
# Ventoy for PARAVIS Flash
|
||||
# Ventoy для флешки PARAVIS
|
||||
|
||||
Ventoy 1.1.18 sources and Paravis changes used on the PARAVIS multiboot USB
|
||||
flash.
|
||||
Исходники Ventoy 1.1.18 и изменения Paravis, используемые на
|
||||
мультизагрузочной флешке PARAVIS.
|
||||
|
||||
The PARAVIS flash uses a non-standard partition layout, so Ventoy has to be
|
||||
patched to find the data (ISO) partition dynamically instead of assuming
|
||||
partition 1:
|
||||
На флешке PARAVIS нестандартная разметка, поэтому Ventoy приходится
|
||||
патчить: раздел с данными (ISO) определяется динамически, а не считается
|
||||
первым.
|
||||
|
||||
| # | Size | File system | Label | Purpose |
|
||||
|---|------|-------------|-------|---------|
|
||||
| 1 | 16 GB | FAT32 | `PARAVIS` | main boot partition (bootmgr / g4d) |
|
||||
| 2 | 32 MB | FAT | `VTOYEFI` | Ventoy EFI partition |
|
||||
| 3 | rest − 3 MB | exFAT | `DATA` | images and data |
|
||||
| # | Размер | ФС | Метка | Назначение |
|
||||
|---|--------|-----|-------|------------|
|
||||
| 1 | 16 ГБ | FAT32 | `PARAVIS` | основной загрузочный раздел (bootmgr / g4d) |
|
||||
| 2 | 32 МБ | FAT | `VTOYEFI` | раздел Ventoy EFI |
|
||||
| 3 | остальное − 3 МБ | exFAT | `DATA` | образы и данные |
|
||||
|
||||
The data partition is detected by the marker file `/ISO/Ventoy/NOT.DEL`.
|
||||
Раздел с данными определяется по файлу-маркеру `/ISO/Ventoy/NOT.DEL`.
|
||||
|
||||
## Repository layout
|
||||
## Структура репозитория
|
||||
|
||||
```
|
||||
Ventoy-src/ upstream Ventoy 1.1.18 source tree (GPLv3)
|
||||
Ventoy-src/ исходники Ventoy 1.1.18 (GPLv3)
|
||||
paravis/
|
||||
patch_ventoy_layout.py GRUB2 source patches for the custom layout
|
||||
patch_ventoy_grubcfg.py grub.cfg patch (marker-based data partition)
|
||||
patch_ventoy_hook.py initramfs hook patch for non-partition-1 data
|
||||
patch_vtoyjump.py vtoyjump32/64 MBr marker check bypass
|
||||
patch-ventoy-lang.sh default menu language -> ru_RU
|
||||
build-theme-main.py builds the GRUB theme from a PSD layout
|
||||
theme/ GRUB theme assets and ventoy.json
|
||||
ventoy_grub.cfg "return to main menu" entry
|
||||
ventoy_grub-f7.cfg F7 entry back to the main Paravis GRUB menu
|
||||
patch_ventoy_layout.py патчи исходников GRUB2 под нестандартную разметку
|
||||
patch_ventoy_grubcfg.py патч grub.cfg (поиск раздела данных по маркеру)
|
||||
patch_ventoy_hook.py патч initramfs hook для раздела данных не 1
|
||||
patch_vtoyjump.py обход проверки MBR в vtoyjump32/64
|
||||
patch-ventoy-lang.sh язык меню по умолчанию → ru_RU
|
||||
build-theme-main.py сборка темы GRUB из PSD-макета
|
||||
theme/ ресурсы темы GRUB и ventoy.json
|
||||
ventoy_grub.cfg пункт «возврат в главное меню»
|
||||
ventoy_grub-f7.cfg пункт F7 — возврат в главное меню Paravis
|
||||
```
|
||||
|
||||
## Applying the patches
|
||||
## Применение патчей
|
||||
|
||||
The scripts take explicit paths, so they can be run from any checkout.
|
||||
Скрипты принимают пути явно, поэтому работают из любого каталога.
|
||||
|
||||
```sh
|
||||
# 1. GRUB2 sources (run inside the Ventoy build tree)
|
||||
# 1. Исходники GRUB2 (в дереве сборки Ventoy)
|
||||
python3 paravis/patch_ventoy_layout.py GRUB2/SRC/grub-2.04/grub-core/ventoy
|
||||
|
||||
# 2. VTOYEFI grub.cfg
|
||||
# 2. grub.cfg в VTOYEFI
|
||||
python3 paravis/patch_ventoy_grubcfg.py vtoyefi/grub/grub.cfg
|
||||
|
||||
# 3. initramfs hook
|
||||
python3 paravis/patch_ventoy_hook.py ventoy.cpio ventoy.cpio
|
||||
|
||||
# 4. vtoyjump32.exe / vtoyjump64.exe
|
||||
python3 paravis/patch_vtoyjump.py <dir-with-vtoyjump-binaries>
|
||||
python3 paravis/patch_vtoyjump.py <каталог-с-бинарниками-vtoyjump>
|
||||
|
||||
# 5. default menu language
|
||||
# 5. язык меню по умолчанию
|
||||
./paravis/patch-ventoy-lang.sh vtoyefi/grub/grub.cfg
|
||||
```
|
||||
|
||||
`patch_vtoyjump.py` patches compiled binaries; it is safe to re-run and
|
||||
skips files that are already patched.
|
||||
`patch_vtoyjump.py` патчит скомпилированные бинарники; его можно запускать
|
||||
повторно — уже пропатченные файлы пропускаются.
|
||||
|
||||
## Theme
|
||||
## Тема
|
||||
|
||||
`paravis/theme/` contains `theme.txt`, `ventoy.json`, the background and
|
||||
widget PNGs and `paravis.pf2` (Montserrat converted to GRUB format).
|
||||
В `paravis/theme/` лежат `theme.txt`, `ventoy.json`, фон, PNG-элементы
|
||||
интерфейса и `paravis.pf2` (Montserrat в формате GRUB).
|
||||
|
||||
`ventoy.json` refers to `tahoma20.pf2`, `tahoma16.pf2`, `tahoma-bold16.pf2`
|
||||
and `tahoma-bold14.pf2`. Those files are **not** part of this repository
|
||||
because they are derived from Microsoft fonts. Provide them locally when
|
||||
deploying the theme, or generate replacements from a font you are allowed to
|
||||
use:
|
||||
`ventoy.json` ссылается на `tahoma20.pf2`, `tahoma16.pf2`,
|
||||
`tahoma-bold16.pf2` и `tahoma-bold14.pf2`. Этих файлов **нет** в
|
||||
репозитории, потому что они являются производными шрифтов Microsoft.
|
||||
Добавьте их локально при развёртывании темы или соберите замену из
|
||||
шрифта, который разрешено использовать:
|
||||
|
||||
```sh
|
||||
grub-mkfont -s 20 -o tahoma20.pf2 YourFont.ttf
|
||||
```
|
||||
|
||||
`build-theme-main.py` renders the background and a preview from a layered
|
||||
PSD file; it needs `psd-tools`, `Pillow` and the Montserrat font.
|
||||
`build-theme-main.py` собирает фон и предпросмотр из многослойного PSD;
|
||||
нужны `psd-tools`, `Pillow` и шрифт Montserrat.
|
||||
|
||||
## What is not included
|
||||
## Что не входит
|
||||
|
||||
This is a source-only repository. It does not contain:
|
||||
Релиз содержит только исходники. В репозитории нет:
|
||||
|
||||
- private keys, certificates or signed EFI binaries (`keys/`, `*.signed`);
|
||||
- Microsoft-derived font files (`tahoma*.pf2`, `segoeui18.pf2`);
|
||||
- built Ventoy releases and bootable images (`*.iso`, `*.img`, `*.wim`,
|
||||
`*.esd`, `Data.pf`);
|
||||
- `bootice.exe`, Total Commander and other third-party binaries;
|
||||
- build output, logs or local machine paths.
|
||||
- приватных ключей, сертификатов и подписанных EFI (`keys/`, `*.signed`);
|
||||
- производных шрифтов Microsoft (`tahoma*.pf2`, `segoeui18.pf2`);
|
||||
- собранных релизов Ventoy и загрузочных образов (`*.iso`, `*.img`,
|
||||
`*.wim`, `*.esd`, `Data.pf`);
|
||||
- `bootice.exe`, Total Commander и других сторонних бинарников;
|
||||
- результатов сборки, логов и локальных путей.
|
||||
|
||||
## License
|
||||
## Лицензия
|
||||
|
||||
Ventoy itself is licensed under GPLv3; see
|
||||
[`Ventoy-src/COPYING`](Ventoy-src/COPYING). The Paravis patches and theme are
|
||||
released under the same terms as the project they modify. See
|
||||
[`THIRD-PARTY.md`](THIRD-PARTY.md) for details.
|
||||
Сам Ventoy распространяется по GPLv3, см.
|
||||
[`Ventoy-src/COPYING`](Ventoy-src/COPYING). Патчи и тема Paravis
|
||||
распространяются на тех же условиях, что и проект, который они изменяют.
|
||||
Подробности — в [`THIRD-PARTY.md`](THIRD-PARTY.md).
|
||||
Reference in new issue
Block a user