add git.uk.md & news/merge.uk.md
Vladislav Shapovalov
parent
d75f0d9ce4
commit
90d4d7a9b5
|
|
@ -0,0 +1,191 @@
|
|||
---
|
||||
title: Огляд коду
|
||||
x-toc-enable: true
|
||||
...
|
||||
|
||||
репозиторії libreboot
|
||||
===================
|
||||
|
||||
Інформацію про те, хто працює над libreboot і хто керує проектом, можна
|
||||
знайти на [who.uk.md](who.uk.md)
|
||||
|
||||
Проект `libreboot` має 3 основні сховища Git:
|
||||
|
||||
* Система побудови: <https://notabug.org/libreboot/lbmk>
|
||||
* Веб-сайт (+документація): <https://notabug.org/libreboot/lbwww>
|
||||
* Зображення (для веб-сайта): <https://notabug.org/libreboot/lbwww-img>
|
||||
|
||||
Є також ці програми, розміщені в проекті Libreboot, і libreboot
|
||||
або рекомендує їх, або використовує їх:
|
||||
|
||||
* Bucts (утиліта): <https://notabug.org/libreboot/bucts>
|
||||
* ich9utils (утиліта): <https://notabug.org/libreboot/ich9utils>
|
||||
|
||||
Ви можете завантажити будь-яке з цих сховищ, внести будь-які зміни, і
|
||||
потім надіслати свої зміни, дотримуючись інструкцій нижче.
|
||||
|
||||
Рекомендовано створювати libreboot (усі його частини) у дистрибутиві
|
||||
GNU+Linux. Наприклад, система збірки (lbmk) не перевірена на системах BSD.
|
||||
Встановіть `git` у вашій системі GNU+Linux, і завантажте одне із сховищ.
|
||||
|
||||
Розробка libreboot виконується за допомогою системи контролю версій Git.
|
||||
Зверніться до [офіційної документації Git](https://git-scm.com/doc), якщо ви не
|
||||
знаєте, як користуватися Git.
|
||||
|
||||
Репозиторій `bucts` розміщено в проекті libreboot, оскільки оригінальний
|
||||
репозиторій на `stuge.se` більше не доступний, коли ми перевіряли останній раз.
|
||||
Програма `bucts` була написана Пітером Стьюджем. Вам знадобляться `bucts`, якщо ви прошиваєте
|
||||
внутрішньо libreboot ROM на ThinkPad X60 або T60, на якому зараз працює
|
||||
невільний Lenovo BIOS. Інструкції щодо цього доступні тут:\
|
||||
[посібники зі встановлення libreboot](docs/install/)
|
||||
|
||||
Репозиторій `ich9utils` активно використовується системою збирання `lbmk`. Однак
|
||||
ви також можете завантажити `ich9utils` самостійно та використовувати його. Він генерує ICH9M
|
||||
дескриптор+GbE образи для GM45 ThinkPad, які використовують південний міст ICH9M. Він
|
||||
також може працювати з іншими системами, що використовують ту саму платформу/чіпсет.
|
||||
Документація для `ich9utils` доступна тут:\
|
||||
[документація ich9utils](docs/install/ich9utils.md)
|
||||
|
||||
lbmk (libreboot-make)
|
||||
---------------------
|
||||
|
||||
Це основна система збирання в libreboot. Можна сказати, що `lbmk` *це*
|
||||
libreboot! Завантажте репозиторій Git:
|
||||
|
||||
git clone https://notabug.org/libreboot/lbmk
|
||||
|
||||
Команда `git`, показана вище, завантажить систему збірки libreboot `lbmk`.
|
||||
Потім ви можете перейти до цього так:
|
||||
|
||||
cd lbmk
|
||||
|
||||
Внесіть будь-які зміни, які забажаєте, або просто побудуйте. Щоб отримати вказівки щодо
|
||||
збирання `lbmk`, зверніться до [інструкцій зі збирання](docs/build/).
|
||||
|
||||
Інформація про саму систему збірки та про те, як вона працює, доступна в
|
||||
[посібнику обслуговування lbmk](docs/maintain/).
|
||||
|
||||
lbwww та lbwww-img
|
||||
-------------------
|
||||
|
||||
*Весь* веб-сайт і документація libreboot розміщені в репозиторії Git.
|
||||
Завантажте так:
|
||||
|
||||
git clone https://notabug.org/libreboot/lbwww
|
||||
|
||||
Зображення розміщені на <https://av.libreboot.org/> і доступні в окремому
|
||||
сховищі:
|
||||
|
||||
git clone https://notabug.org/libreboot/lbwww-img
|
||||
|
||||
Вносьте будь-які зміни, які забажаєте. Дивіться нотатки нижче про те, як надсилати виправлення.
|
||||
|
||||
Весь веб-сайт написаний у Markdown, зокрема його версія Pandoc.
|
||||
Статичні сторінки HTML створюються за допомогою [Untitled](https://untitled.vimuser.org/).
|
||||
Лія Роу, засновниця libreboot, також є засновницею проекту генератор статичних сайтів
|
||||
Untitled.
|
||||
|
||||
Якщо хочете, ви можете налаштувати локальний HTTP-сервер і створити власну локальну
|
||||
версію веб-сайту. Зауважте, що зображення все одно будуть посилатися на ті, що
|
||||
розміщені на <https://av.libreboot.org/>, тому будь-які зображення, які ви додаєте до `lbwww-img`
|
||||
не відображатимуться на вашому локальному сайті `lbwww`, якщо ви зробите, щоб посилання на зображення (для
|
||||
зображень, які ви додаєте) посилались на `av.libreboot.org`. Однак необхідно, щоб такі
|
||||
зображення розміщувалися на av.libreboot.org.
|
||||
|
||||
Тому, якщо ви бажаєте додати зображення на веб-сайт, надішліть їх також до
|
||||
репозиторія `lbwww-img`, із посиланням на них
|
||||
<https://av.libreboot.org/шлях/до/вашого/нового/зображення/в/lbwww-img> для кожного з них.
|
||||
Коли його буде поєднано на веб-сайті libreboot, ваші зображення з'являться в реальному часі.
|
||||
|
||||
Для цілей розробки ви можете спочатку створити локальні посилання на зображення, а
|
||||
потім налаштувати URL-адреси, коли надсилатимете документацію/патчі веб-сайту.
|
||||
|
||||
На веб-сайті Untitled є інструкції щодо налаштування локальної версії
|
||||
веб-сайту. Завантажте untitled, і в своєму каталозі `untitled` створіть каталог
|
||||
під назвою `www/`, потім увійдіть у каталог www і клонуйте сховище `lbwww`
|
||||
там. Налаштуйте локальний HTTP-сервер відповідним чином.
|
||||
|
||||
Знову ж таки, інструкції для цього доступні на веб-сайті Untitled.
|
||||
|
||||
Ім'я не вимагається
|
||||
-----------------
|
||||
|
||||
Внески, які ви робите, реєструються публічно в репозиторії Git, доступ
|
||||
до якого мають всі. Це включає ім'я та електронну адресу
|
||||
учасника.
|
||||
|
||||
У Git для імені автора та електронної адреси вам не потрібно використовувати
|
||||
ідентифікаційні дані. Ви можете використовувати `libreboot Contributor`, а свою електронну адресу можна
|
||||
вказати як contributor@libreboot.org. Вам дозволено це робити, якщо
|
||||
ви бажаєте зберегти конфіденційність. Ми віримо в конфіденційність. Якщо ви вирішите залишитися
|
||||
анонімними, ми врахуємо це.
|
||||
|
||||
Звичайно, ви можете використовувати будь-яке ім'я та/або адресу електронної пошти.
|
||||
|
||||
З юридичної точки зору всі авторські права є автоматичними відповідно до Бернської конвенції
|
||||
міжнародного авторського права. Немає значення, яке ім'я, чи дійсно ви навіть
|
||||
заявляєте про авторське право (але ми вимагаємо наявності певного
|
||||
ліцензування авторського права - докладніше про це на цій же сторінці).
|
||||
|
||||
Якщо ви використовуєте інше ім'я та адресу електронної пошти у своїх комітах/патчах, то
|
||||
маєте бути досить анонімним. використовуйте
|
||||
[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.
|
||||
|
||||
Ліцензії (для учасників)
|
||||
--------
|
||||
|
||||
Обов'язково вільно ліцензуйте свою роботу, за вільною ліцензією. Libreboot більше не
|
||||
встановлює довільні обмеження на те, які ліцензії приймаються, і багато
|
||||
інших ліцензій вже існує. Ми перевіримо ваш внесок і розкажемо вам, якщо з ним
|
||||
виникли проблеми (наприклад, немає ліцензії).
|
||||
|
||||
*Завжди* декларуйте ліцензію на свою роботу! Недекларування ліцензії означає, що
|
||||
за замовчуванням застосовуються обмежувальні закони про авторське право, які зроблять вашу роботу
|
||||
захищеною власністю, підпадаючи під усі ті самі обмеження.
|
||||
|
||||
Ліцензія MIT є хорошою для початку, і вона є бажаною ліцензією
|
||||
для всіх нових робіт у Libreboot, але ми не вибагливі. Libreboot історично
|
||||
використовував ліцензування GNU, таке як GPL; багато з цього залишилося, і, ймовірно, залишиться.
|
||||
Це ваша робота; очевидно, якщо ви використовуєте існуючу роботу,
|
||||
може мати сенс використовувати ту саму ліцензію для вашого внеску, для сумісності
|
||||
ліцензії.
|
||||
|
||||
Ви можете знайти типові приклади ліцензій
|
||||
[тут](https://opensource.org/licenses).
|
||||
|
||||
Якщо ви *виходите* на основі існуючого твору, важливо, щоб ваша ліцензія (на ваш внесок)
|
||||
була сумісна з ліцензуванням твору, з якого
|
||||
ваш був отриманий. Ліцензія MIT хороша, оскільки вона широко сумісна
|
||||
з багатьма іншими ліцензіями та надає багато свобод (наприклад, свободу
|
||||
субліцензування), яких немає в інших ліцензіях:
|
||||
|
||||
<https://opensource.org/licenses/MIT>
|
||||
|
||||
Надсилайте виправлення
|
||||
------------
|
||||
|
||||
Створіть обліковий запис на <https://notabug.org/> і перейдіть (увійшовши в систему) до
|
||||
репозиторію, над яким ви хочете працювати. Натисніть *Fork*, і у вашому обліковому записі,
|
||||
ви матимете власне сховище libreboot. Клонуйте свій репозиторій, внесіть у нього
|
||||
будь-які зміни, а потім надішліть їх у свій репозиторій у своєму обліковому
|
||||
записі на NotABug. Ви також можете зробити це на новій гілці, якщо хочете.
|
||||
|
||||
У своєму обліковому записі Notabug, ви можете перейти до офіційного репозиторія libreboot
|
||||
і надіслати запит на отримання. Принцип роботи подібний до інших популярних веб-платформ
|
||||
Git, якими люди користуються сьогодні.
|
||||
|
||||
Ви можете відправити свої патчі туди. Крім того, ви можете увійти на
|
||||
IRC-канал libreboot і повідомити канал, які виправлення ви хочете бути переглянутими, якщо у вас
|
||||
є власне сховище Git з виправленнями.
|
||||
|
||||
Після того, як ви подасте Pull Request, розробники libreboot отримають сповіщення
|
||||
електронною поштою. Якщо ви не отримаєте достатньо швидкої відповіді від проекту, ви
|
||||
також можете повідомити проект через канал `#libreboot` на Libera Chat.
|
||||
|
||||
Інший спосіб подати виправлення - це напряму надіслати Лії Роу електронною поштою:
|
||||
[leah@libreboot.org](mailto:leah@libreboot.org) - це адреса електронної пошти проекту Лії.
|
||||
|
||||
Однак, для прозорості процесу перевірки коду, ми рекомендуємо на даний момент
|
||||
використовувати Notabug.
|
||||
|
|
@ -0,0 +1,86 @@
|
|||
% Osboot тепер є частиною Libreboot
|
||||
% Лія Роу
|
||||
% 15 листопада 2022 року
|
||||
|
||||
Довго живе Libreboot!
|
||||
====================
|
||||
|
||||
Минулий проект `osboot`, розпочатий тим же самим засновником, що й Libreboot, Лією
|
||||
Роу, сьогодні було вимкнено; веб-сайт osboot тепер автоматично перенаправляє, через
|
||||
HTTP 301, на веб-сайт libreboot. Все, що мав osboot, тепер було додано
|
||||
до Libreboot, і розробка тепер буде проходити виключно в Libreboot з цього
|
||||
момента.
|
||||
|
||||
Результатом цього рішення є те, що Libreboot тепер підтримує (і може підтримувати) новіше
|
||||
апаратне забезпечення, таке як ThinkPad X230 або T440p.
|
||||
|
||||
Про це згадувалося в попередньому оголошенні про випуск Libreboot:
|
||||
|
||||
<https://libreboot.org/news/libreboot20220710.html#planned-osbootlibreboot-merger>
|
||||
|
||||
Точний метод, запропонований у тому попередньому повідомленні, не був прийнятий.
|
||||
Натомість, Libreboot, по суті, зараз *є* osboot, під іменем Libreboot.
|
||||
|
||||
*Політика зменшення бінарних блобів* osboot замінила попередню
|
||||
політику, яку використовував Libreboot. Це прагматична політика, спрямована на надання
|
||||
якомога більшої свободи кожній платформі, але більше не дотримається лише
|
||||
тих *"чистих"* платформ; тепер можна підтримувати всі платформи з coreboot, якщо
|
||||
хтось бажає підтримувати плату в `lbmk`. Нова політика тут:
|
||||
|
||||
<https://libreboot.org/news/policy.html> (той самий URL, що і старий, але
|
||||
текст було оновлено, відповідно до політики osboot)
|
||||
|
||||
Щоб зрозуміти всю природу цього злиття, вам слід прочитати документ про політику,
|
||||
посилання на який наведено вище. І osboot, і Libreboot були багато в чому ідентичними, і
|
||||
в основному той самий проект. Щоб значно полегшити управління проектами,
|
||||
їх просто об'єднали в один.
|
||||
|
||||
Як було проведено злиття
|
||||
---------------------------
|
||||
|
||||
З 2020 року Libreboot (і osboot) пройшли кілька перезавантажень,
|
||||
відгалуджуючи один одного для підтримки синхронізації. Це почало ставати занадто
|
||||
великим тягарем, що стало основною причиною злиття.
|
||||
|
||||
14 листопада, я (Лія Роу) буквально зробила diff всього Libreboot, з моменту
|
||||
останнього перезавантаження (репозиторія Libreboot) і перевірила кожну з osboot,
|
||||
додавши те, чого не вистачає в цьому *в osboot*. Тоді проект osboot
|
||||
синхронізується з Libreboot, але відповідно до osboot і з додатковими
|
||||
платами (плюс сценарії і так далі) в osboot, порівняно з Libreboot до злиття.
|
||||
|
||||
Те саме *потім* було застосовано *у зворотному порядку*: відмінності в osboot були перенесені
|
||||
назад до Libreboot, обережно та методично. Все це відбулося
|
||||
протягом 1 дня, оскільки загальна структура обох проектів була в основному
|
||||
однаковою, а системи збірки в обох проектах надзвичайно модульні, що робить
|
||||
таку роботу справді дуже легкою.
|
||||
|
||||
Подібний процес було виконано з веб-сайтами Libreboot і osboot,
|
||||
але osboot уже містив ту саму документацію, що й Libreboot,
|
||||
а також додаткові. Тому відмінності було перенесено на Libreboot.
|
||||
|
||||
Перенесення документації (від osboot до Libreboot) виконав
|
||||
Калеб Ла Грейндж (IRC нік `shmalebx9`), і я переглянула її самостійно перед тим, як
|
||||
опублікувати.
|
||||
|
||||
На момент написання цього допису, одна утиліта з osboot (для зміни MAC-адрес
|
||||
у регіонах Gbe на машинах Intel, які мають IFD) ще не була перенесена,
|
||||
але я розглядаю можливість об'єднання всіх зовнішніх утиліт, які ми підтримуємо (bucts,
|
||||
ich9gen та nvmutil) в lbmk, роблячи lbmk свого роду *монорепозиторієм*, схожим на BSD. Ми
|
||||
побачимо.
|
||||
|
||||
Ось і все справді. Osboot і Libreboot тепер працюють як єдиний, об'єднаний
|
||||
проект, як і мало бути з самого початку. Досить нудна новина,
|
||||
насправді.
|
||||
|
||||
Незабаром з'явиться новий випуск Libreboot!!!
|
||||
====================================
|
||||
|
||||
CrOS пристрої знову додано до Libreboot
|
||||
----------------------------------
|
||||
|
||||
Документація має бути оновлена, для відображення цього і багатьох інших речей, але
|
||||
засновані на ARM chromebook тепер знову підтримуються в Libreboot, використовуючи
|
||||
корисне навантаження u-boot всередині coreboot.
|
||||
|
||||
Цю роботу люб'язно надав Альпер Небі Ясак (`alpernebbi` на libera IRC) і це також
|
||||
є частиною злиття.
|
||||
Loading…
Reference in New Issue