2023-07-10 15:43:08 +00:00
|
|
|
|
---
|
|
|
|
|
|
title: Огляд коду
|
|
|
|
|
|
x-toc-enable: true
|
|
|
|
|
|
...
|
|
|
|
|
|
|
2024-05-12 00:27:09 +00:00
|
|
|
|
If you wish to submit patches, you can. Submit them, using the instructions
|
|
|
|
|
|
provided in the following sections:
|
extreme cleanup / grandiose gesture
make canoeboot a truly GNU FSDG compliant coreboot distro,
by removing all overly positive reference to Libreboot;
what remains is technical in nature, so as to provide
historical context since Canoeboot is a fork of Libreboot.
I've stated before that I wish to take a more neutral tone
toward the FSF, in contrast to the *coldboot war* of 2023
when GNU Boot started.
Canoeboot was heavily linking to Libreboot, even going so far
as to call itself "inferior" and tell the reader to use
Libreboot.
From now on, Canoeboot will be maintained as though I actually
believed in FSF propoganda. I don't, but its users do. Treat
them with respect. My reason for providing Canoeboot is
precisely that I wish for such people to have a high quality
coreboot distro, much unlike the inferior *GNU Boot* project;
inferior because to this day, it's still based on very old
Libreboot, with not much changed (of any real substance)
relative to the Libreboot 20220710 release on which it forked.
In general, I've also found a lot of stragglers from when
Canoeboot started, where paragraphs referred to Libreboot that
should have actually referred to Canoeboot, or paragraphs
with Libreboot-specific information that does not make sense
in the Canoeboot project e.g. references to vendor scripts.
The resulting canoeboot.org will now look no different to any
typical reader than a typical FSF-aligned project.
There is a next stage to this, which will become apparent to
everyone if I have my way.
Signed-off-by: Leah Rowe <info@minifree.org>
2024-05-10 02:12:44 +00:00
|
|
|
|
|
2023-10-26 00:10:41 +00:00
|
|
|
|
репозиторії Canoeboot
|
|
|
|
|
|
===================
|
2023-07-10 15:43:08 +00:00
|
|
|
|
|
2023-10-26 00:10:41 +00:00
|
|
|
|
Інформацію про те, хто працює над canoeboot і хто керує проектом, можна
|
|
|
|
|
|
знайти на [who.uk.md](who.uk.md)
|
2023-07-10 15:43:08 +00:00
|
|
|
|
|
2023-10-26 00:10:41 +00:00
|
|
|
|
Проект `canoeboot` має 3 основні сховища Git:
|
2023-07-10 15:43:08 +00:00
|
|
|
|
|
2023-10-26 00:10:41 +00:00
|
|
|
|
* Система побудови: <https://codeberg.org/canoeboot/cbmk>
|
|
|
|
|
|
* Веб-сайт (+документація): <https://codeberg.org/canoeboot/cbwww>
|
|
|
|
|
|
* Зображення (для веб-сайта): <https://codeberg.org/canoeboot/cbwww-img>
|
2023-07-10 15:43:08 +00:00
|
|
|
|
|
2023-10-26 00:10:41 +00:00
|
|
|
|
Розробка canoeboot виконується за допомогою системи контролю версій Git.
|
2023-07-10 15:43:08 +00:00
|
|
|
|
Зверніться до [офіційної документації Git](https://git-scm.com/doc), якщо ви не
|
|
|
|
|
|
знаєте, як користуватися Git.
|
|
|
|
|
|
|
2023-10-26 00:10:41 +00:00
|
|
|
|
cbmk (canoeboot-make)
|
2023-07-10 15:43:08 +00:00
|
|
|
|
---------------------
|
|
|
|
|
|
|
2023-10-26 00:10:41 +00:00
|
|
|
|
Це основна система збирання в canoeboot. Можна сказати, що `cbmk` *це*
|
|
|
|
|
|
canoeboot! Завантажте репозиторій Git:
|
2023-07-10 15:43:08 +00:00
|
|
|
|
|
2023-10-26 00:10:41 +00:00
|
|
|
|
git clone https://codeberg.org/canoeboot/cbmk
|
2023-07-10 15:43:08 +00:00
|
|
|
|
|
2023-10-26 00:10:41 +00:00
|
|
|
|
Команда `git`, показана вище, завантажить систему збірки canoeboot `cbmk`.
|
2023-07-10 15:43:08 +00:00
|
|
|
|
Потім ви можете перейти до цього так:
|
|
|
|
|
|
|
2023-10-26 00:10:41 +00:00
|
|
|
|
cd cbmk
|
2023-07-10 15:43:08 +00:00
|
|
|
|
|
|
|
|
|
|
Внесіть будь-які зміни, які забажаєте, або просто побудуйте. Щоб отримати вказівки щодо
|
2023-10-26 00:10:41 +00:00
|
|
|
|
збирання `cbmk`, зверніться до [інструкцій зі збирання](docs/build/index.uk.md).
|
2023-07-10 15:43:08 +00:00
|
|
|
|
|
|
|
|
|
|
Інформація про саму систему збірки та про те, як вона працює, доступна в
|
2023-10-26 00:10:41 +00:00
|
|
|
|
[посібнику обслуговування cbmk](docs/maintain/).
|
2023-07-10 15:43:08 +00:00
|
|
|
|
|
2023-10-26 00:10:41 +00:00
|
|
|
|
cbwww та cbwww-img
|
2023-07-10 15:43:08 +00:00
|
|
|
|
-------------------
|
|
|
|
|
|
|
2023-10-26 00:10:41 +00:00
|
|
|
|
*Весь* веб-сайт і документація canoeboot розміщені в репозиторії Git.
|
2023-07-10 15:43:08 +00:00
|
|
|
|
Завантажте так:
|
|
|
|
|
|
|
2023-10-26 00:10:41 +00:00
|
|
|
|
git clone https://codeberg.org/canoeboot/cbwww
|
2023-07-10 15:43:08 +00:00
|
|
|
|
|
2023-10-26 00:10:41 +00:00
|
|
|
|
Зображення розміщені на <https://av.canoeboot.org/> і доступні в окремому
|
2023-07-10 15:43:08 +00:00
|
|
|
|
сховищі:
|
|
|
|
|
|
|
2023-10-26 00:10:41 +00:00
|
|
|
|
git clone https://codeberg.org/canoeboot/cbwww-img
|
2023-07-10 15:43:08 +00:00
|
|
|
|
|
|
|
|
|
|
Вносьте будь-які зміни, які забажаєте. Дивіться нотатки нижче про те, як надсилати виправлення.
|
|
|
|
|
|
|
|
|
|
|
|
Весь веб-сайт написаний у Markdown, зокрема його версія Pandoc.
|
|
|
|
|
|
Статичні сторінки HTML створюються за допомогою [Untitled](https://untitled.vimuser.org/).
|
2023-10-26 00:10:41 +00:00
|
|
|
|
Лія Роу, засновниця canoeboot, також є засновницею проекту генератор статичних сайтів
|
2023-07-10 15:43:08 +00:00
|
|
|
|
Untitled.
|
|
|
|
|
|
|
|
|
|
|
|
Якщо хочете, ви можете налаштувати локальний HTTP-сервер і створити власну локальну
|
|
|
|
|
|
версію веб-сайту. Зауважте, що зображення все одно будуть посилатися на ті, що
|
2023-10-26 00:10:41 +00:00
|
|
|
|
розміщені на <https://av.canoeboot.org/>, тому будь-які зображення, які ви додаєте до `cbwww-img`
|
|
|
|
|
|
не відображатимуться на вашому локальному сайті `cbwww`, якщо ви зробите, щоб посилання на зображення (для
|
|
|
|
|
|
зображень, які ви додаєте) посилались на `av.canoeboot.org`. Однак необхідно, щоб такі
|
|
|
|
|
|
зображення розміщувалися на av.canoeboot.org.
|
2023-07-10 15:43:08 +00:00
|
|
|
|
|
|
|
|
|
|
Тому, якщо ви бажаєте додати зображення на веб-сайт, надішліть їх також до
|
2023-10-26 00:10:41 +00:00
|
|
|
|
репозиторію `cbwww-img`, із посиланням на них
|
|
|
|
|
|
<https://av.canoeboot.org/шлях/до/вашого/нового/зображення/в/cbwww-img> для кожного з них.
|
|
|
|
|
|
Коли його буде поєднано на веб-сайті canoeboot, ваші зображення з'являться в реальному часі.
|
|
|
|
|
|
|
|
|
|
|
|
Якщо додаєте світлину, стисніть її для веб розповсюдження. Світлинам варто бути приблизно
|
|
|
|
|
|
800px завширшки, і зазвичай менше 100Кбайт розміром:
|
|
|
|
|
|
|
|
|
|
|
|
По-перше, зменшіть масштаб вашого зображення до приблизно 800px завширшки, використовуючи вашу улюблену
|
|
|
|
|
|
програму маніпуляції зображенням. Наприклад, з `imagemagick` ви можете зробити
|
|
|
|
|
|
наступне (переконайтесь, що зображення не є вже меншим або еквівалентним, ніж віддано перевагу).
|
|
|
|
|
|
|
|
|
|
|
|
convert original.jpg -resize 600000@ -quality 70% web.jpg
|
|
|
|
|
|
|
|
|
|
|
|
Вам варто завжди виконувати `jpegoptim` на jpg зображеннях перед їх поданням.
|
|
|
|
|
|
Воно вирізає безкорисні метадані та оптимізує *без втрат* їх більше, розумно
|
|
|
|
|
|
переорганізовуючи таблиці Гаффмана, що використані в них.
|
|
|
|
|
|
|
|
|
|
|
|
jpegoptim -s --all-progressive web.jpg
|
|
|
|
|
|
|
|
|
|
|
|
Якщо зображення є (штриховим) малюнком, векторній графіці віддається перевага в порівнянні з бітовою картою.
|
|
|
|
|
|
Таким чином, якщо можливо, зберігайте їх як SVG. Їх легко модифікувати,
|
|
|
|
|
|
і точно зробить роботу перекладачів легше так само.
|
|
|
|
|
|
|
|
|
|
|
|
Зображенням PNG варто бути оптимізованими з `zopfli` (він так само без втрат).
|
|
|
|
|
|
Наприклад, це зменшило логотип завантаження Canoeboot з приблизно 11k до 3k:
|
|
|
|
|
|
|
|
|
|
|
|
zopflipng -ym image.png image.png
|
2023-07-10 15:43:08 +00:00
|
|
|
|
|
|
|
|
|
|
Для цілей розробки ви можете спочатку створити локальні посилання на зображення, а
|
|
|
|
|
|
потім налаштувати URL-адреси, коли надсилатимете документацію/патчі веб-сайту.
|
|
|
|
|
|
|
|
|
|
|
|
На веб-сайті Untitled є інструкції щодо налаштування локальної версії
|
|
|
|
|
|
веб-сайту. Завантажте untitled, і в своєму каталозі `untitled` створіть каталог
|
2023-10-26 00:10:41 +00:00
|
|
|
|
під назвою `www/`, потім увійдіть у каталог www і клонуйте сховище `cbwww`
|
2023-07-10 15:43:08 +00:00
|
|
|
|
там. Налаштуйте локальний HTTP-сервер відповідним чином.
|
|
|
|
|
|
|
|
|
|
|
|
Знову ж таки, інструкції для цього доступні на веб-сайті Untitled.
|
|
|
|
|
|
|
|
|
|
|
|
Ім'я не вимагається
|
|
|
|
|
|
-----------------
|
|
|
|
|
|
|
|
|
|
|
|
Внески, які ви робите, реєструються публічно в репозиторії Git, доступ
|
|
|
|
|
|
до якого мають всі. Це включає ім'я та електронну адресу
|
|
|
|
|
|
учасника.
|
|
|
|
|
|
|
|
|
|
|
|
У Git для імені автора та електронної адреси вам не потрібно використовувати
|
2023-10-26 00:10:41 +00:00
|
|
|
|
ідентифікаційні дані. Ви можете використовувати `canoeboot Contributor`, а свою електронну адресу можна
|
|
|
|
|
|
вказати як contributor@canoeboot.org. Вам дозволено це робити, якщо
|
2023-07-10 15:43:08 +00:00
|
|
|
|
ви бажаєте зберегти конфіденційність. Ми віримо в конфіденційність. Якщо ви вирішите залишитися
|
|
|
|
|
|
анонімними, ми врахуємо це.
|
|
|
|
|
|
|
|
|
|
|
|
Звичайно, ви можете використовувати будь-яке ім'я та/або адресу електронної пошти.
|
|
|
|
|
|
|
|
|
|
|
|
З юридичної точки зору всі авторські права є автоматичними відповідно до Бернської конвенції
|
|
|
|
|
|
міжнародного авторського права. Немає значення, яке ім'я, чи дійсно ви навіть
|
|
|
|
|
|
заявляєте про авторське право (але ми вимагаємо наявності певного
|
|
|
|
|
|
ліцензування авторського права - докладніше про це на цій же сторінці).
|
|
|
|
|
|
|
|
|
|
|
|
Якщо ви використовуєте інше ім'я та адресу електронної пошти у своїх комітах/патчах, то
|
|
|
|
|
|
маєте бути досить анонімним. використовуйте
|
|
|
|
|
|
[git log](https://git-scm.com/book/en/v2/Git-Basics-Viewing-the-Commit-History)
|
|
|
|
|
|
та [git show](https://git-scm.com/docs/git-show), щоб підтвердити це перед тим, як ви
|
|
|
|
|
|
надсилаєте зміни до загальнодоступного сховища Git.
|
|
|
|
|
|
|
2023-10-26 00:10:41 +00:00
|
|
|
|
Надсилайте виправлення
|
|
|
|
|
|
------------
|
|
|
|
|
|
|
|
|
|
|
|
Створіть обліковий запис на <https://codeberg.org/> і перейдіть (увійшовши в систему) до
|
|
|
|
|
|
репозиторію, над яким ви хочете працювати. Натисніть *Fork*, і у вашому обліковому записі,
|
|
|
|
|
|
ви матимете власне сховище canoeboot. Клонуйте свій репозиторій, внесіть у нього
|
|
|
|
|
|
будь-які зміни, а потім надішліть їх у свій репозиторій у своєму обліковому
|
|
|
|
|
|
записі на NotABug. Ви також можете зробити це на новій гілці, якщо хочете.
|
|
|
|
|
|
|
|
|
|
|
|
У своєму обліковому записі Codeberg, ви можете перейти до офіційного репозиторія canoeboot
|
|
|
|
|
|
і надіслати запит на отримання. Принцип роботи подібний до інших популярних веб-платформ
|
|
|
|
|
|
Git, якими люди користуються сьогодні.
|
|
|
|
|
|
|
|
|
|
|
|
Ви можете відправити свої патчі туди. Крім того, ви можете увійти на
|
|
|
|
|
|
IRC-канал canoeboot і повідомити канал, які виправлення ви хочете бути переглянутими, якщо у вас
|
|
|
|
|
|
є власне сховище Git з виправленнями.
|
|
|
|
|
|
|
|
|
|
|
|
Після того, як ви подасте Pull Request, розробники canoeboot отримають сповіщення
|
|
|
|
|
|
електронною поштою. Якщо ви не отримаєте достатньо швидкої відповіді від проекту, ви
|
|
|
|
|
|
також можете повідомити проект через канал `#canoeboot` на Libera Chat.
|
|
|
|
|
|
|
|
|
|
|
|
Інший спосіб подати виправлення - це напряму надіслати Лії Роу електронною поштою:
|
|
|
|
|
|
[leah@canoeboot.org](mailto:leah@canoeboot.org) - це адреса електронної пошти проекту Лії.
|
|
|
|
|
|
|
|
|
|
|
|
Однак, для прозорості процесу перевірки коду, ми рекомендуємо на даний момент
|
|
|
|
|
|
використовувати Codeberg.
|
|
|
|
|
|
|
|
|
|
|
|
Дзеркала Git
|
|
|
|
|
|
============
|
|
|
|
|
|
|
|
|
|
|
|
Дзеркала cbmk.git
|
|
|
|
|
|
----------------
|
|
|
|
|
|
|
|
|
|
|
|
Репозиторій `cbmk` містить автоматизовану систему побудови Canoeboot, що
|
|
|
|
|
|
створює випуски Canoeboot (включаючи зібрані образи ROM).
|
|
|
|
|
|
|
|
|
|
|
|
Ви можете виконати `git clone` на будь-якому з цих посилань (посилання є також доступними для натискання,
|
|
|
|
|
|
для перегляду змін в вашому веб-браузері):
|
|
|
|
|
|
|
|
|
|
|
|
* <https://git.sr.ht/~canoeboot/cbmk>
|
|
|
|
|
|
* <https://git.disroot.org/canoeboot/cbmk>
|
|
|
|
|
|
* <https://gitea.treehouse.systems/canoeboot/cbmk>
|
|
|
|
|
|
* <https://0xacab.org/canoeboot/cbmk/>
|
|
|
|
|
|
* <https://framagit.org/canoeboot/canoeboot>
|
|
|
|
|
|
* <https://gitlab.com/canoeboot/cbmk>
|
|
|
|
|
|
* <https://notabug.org/canoeboot/cbmk>
|
|
|
|
|
|
|
|
|
|
|
|
дзеркало cbwww.git
|
|
|
|
|
|
----------------
|
|
|
|
|
|
|
|
|
|
|
|
Репозиторій `cbwww` містить файли Markdown (варіант pandoc), для використання
|
|
|
|
|
|
з [генератором статичних сайтів Untitled](https://untitled.vimuser.org/); це те,
|
|
|
|
|
|
що Canoeboot використовує для надання веб-сторінок HTML, *включаючи* сторінку, яку ви
|
|
|
|
|
|
читаєте прямо зараз!
|
|
|
|
|
|
|
|
|
|
|
|
Ви можете виконати `git clone` на цих посиланнях, та/або натиснути для перегляду змін в вашому
|
|
|
|
|
|
веб-браузері. Дивіться:
|
|
|
|
|
|
|
|
|
|
|
|
* <https://git.sr.ht/~canoeboot/cbwww>
|
|
|
|
|
|
* <https://git.disroot.org/canoeboot/cbwww>
|
|
|
|
|
|
* <https://gitea.treehouse.systems/canoeboot/cbwww>
|
|
|
|
|
|
* <https://0xacab.org/canoeboot/cbwww>
|
|
|
|
|
|
* <https://framagit.org/canoeboot/cbwww/>
|
|
|
|
|
|
* <https://gitlab.com/canoeboot/cbwww>
|
|
|
|
|
|
* <https://notabug.org/canoeboot/cbwww>
|
|
|
|
|
|
|
|
|
|
|
|
дзеркало cbwww-img.git
|
|
|
|
|
|
----------------
|
|
|
|
|
|
|
|
|
|
|
|
Ви можете виконати `git clone` на цих посиланнях, та/або натиснути для перегляду змін в вашому
|
|
|
|
|
|
веб-браузері. Дивіться:
|
|
|
|
|
|
|
|
|
|
|
|
* <https://git.sr.ht/~canoeboot/cbwww-img>
|
|
|
|
|
|
* <https://git.disroot.org/canoeboot/cbwww-img>
|
|
|
|
|
|
* <https://gitea.treehouse.systems/canoeboot/cbwww-img>
|
|
|
|
|
|
* <https://0xacab.org/canoeboot/cbwww-img>
|
|
|
|
|
|
* <https://framagit.org/canoeboot/cbwww-img/>
|
|
|
|
|
|
* <https://gitlab.com/canoeboot/cbwww-img>
|
|
|
|
|
|
* <https://notabug.org/canoeboot/cbwww-img>
|