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