Merge branch 'master' of v-t60/lbwww into master

hslick-master
Leah Rowe 2023-03-05 23:10:11 +00:00 committed by Gogs
commit ab6e45fa86
3 changed files with 313 additions and 0 deletions

36
site/docs/index.uk.md Normal file
View File

@ -0,0 +1,36 @@
---
title: Документація
...
Завжди перевіряйте [libreboot.org](https://libreboot.org/index.uk.md) для останніх оновлень
libreboot. Новини, включаючи оголошення про випуски, може бути знайдено
в [основній секції новин](../news/).
[Відповіді на поширені запитання про libreboot](../faq.md).
Встановлення libreboot
====================
- [На яких системах я можу встановлювати libreboot?](hardware/)
- [Як встановити libreboot](install/)
Документація, яка має відношення до операційних систем
============================
- [Керівництва GNU+Linux](gnulinux/)
- [Як встановити BSD на x86 хостову систему](bsd/)
Інформація для розробників
==========================
- [Як зібрати джерельний код libreboot](build/)
- [Документація розробника системи побудови](maintain/)
- [Корисне навантаження GRUB](grub/)
- [Корисне навантаження U-Boot](uboot/)
Інша інформація
=================
- [Різне](misc/)
- [Список кодових назв](misc/codenames.md)

191
site/git.uk.md Normal file
View File

@ -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.

86
site/news/merge.uk.md Normal file
View File

@ -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) і це також
є частиною злиття.